strip(1)                                                           strip(1)




 NAME    [Toc]    [Back]
      strip - strip symbol and line number information from an object file

 SYNOPSIS    [Toc]    [Back]
      strip [-l] [-x] [-r] [-V] [-U] filename ...

 DESCRIPTION    [Toc]    [Back]
      strip removes the symbol table and line number information from object
      files, including archives.  Thereafter, no symbolic debugging access
      is available for that file; thus, this command is normally run only on
      production modules that have been debugged and tested.  The effect is
      nearly identical to using the -s option of ld.

    Options    [Toc]    [Back]
      The amount of information stripped from the symbol table can be
      controlled by using any of the following options:

           -l      Strip line number information only; do not strip any
                   symbol table information.

           -x      Do not strip static or external symbol information.

                   Note that the -l and -x options are synonymous because
                   the symbol table contains only static and external
                   symbols.  Either option strips only symbolic debugging
                   information and unloadable data.

           -r      Reset the relocation indexes into the symbol table (SOM
                   only). Obsolete for ELF files.  This option allows strip
                   to be run on relocatable files, in which case the effect
                   is also to strip only symbolic debugging information and
                   unloadable data.

           -V      Print the version of the strip command on the standard
                   error output.

           -U      Print the usage menu.

      If there are any relocation entries in the object file and any symbol
      table information is to be stripped, strip complains and terminates
      without stripping filename unless the -r option is used.

      If strip is executed on an archive file (see ar(4)), the archive
      symbol table is removed.  The archive symbol table must be restored by
      executing ar with its s operator (see ar(1)) before the archive can be
      used by the ld command (se ld(1)).  strip instructs the user with
      appropriate warning messages when this situation arises.

      The purpose of this command is to reduce file storage overhead
      consumed by the object file.




 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 strip(1)                                                           strip(1)




 EXTERNAL INFLUENCES    [Toc]    [Back]
    Environment Variables
      The following internationalization variables affect the execution of
      strip:

      LANG Determines the locale category for native language, local customs
           and coded character set in the absence of LC_ALL and other LC_*
           environment variables.  If LANG is not specified or is set to the
           empty string, a default of C (see lang(5)) is used instead of
           LANG.

      LC_ALL    [Toc]    [Back]
           Determines the values for all locale categories and has
           precedence over LANG and other LC_* environment variables.

      LC_MESSAGES    [Toc]    [Back]
           Determines the locale that should be used to affect the format
           and contents of diagnostic messages written to standard error.

      LC_NUMERIC    [Toc]    [Back]
           Determines the locale category for numeric formatting.

      LC_CTYPE    [Toc]    [Back]
           Determines the locale category for character handling functions.

      ST_STRIPCAT    [Toc]    [Back]
      NLSPATH
           Determines the location of message catalogues for the processing
           of LC_MESSAGES.

      If any internationalization variable contains an invalid setting,
      strip behaves as if all internationalization variables are set to C.
      See environ(5).

      In addition, the following environment variable affects strip:

      TMPDIR    [Toc]    [Back]
           Specifies a directory for temporary files (see tmpnam(3S)).

    International Code Set Support    [Toc]    [Back]
      Single- and multi-byte character code sets are supported.

 DIAGNOSTICS    [Toc]    [Back]
      strip: name: cannot open      name cannot be read.

      strip: name:  bad magic       name is not an appropriate object file.

      strip: name:  relocation entries present; cannot strip
                                    name contains relocation entries and the
                                    -r option was not specified.  Symbol
                                    table information cannot be stripped.



 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003






 strip(1)                                                           strip(1)




 EXAMPLES    [Toc]    [Back]
      Strip symbol table and debug information from the shared library
      libfoo.so in the current directory to reduce its size.  Symbol
      information required to use the library is preserved:

           strip ./libfoo.so

 FILES    [Toc]    [Back]
      /var/tmp/SGSstrp*             temporary files

 SEE ALSO    [Toc]    [Back]
    System Tools:
      ar(1)             create archived libraries
      as(1)             translate assembly code to machine code
      cc(1)             invoke the HP-UX C compiler
      ld(1)             invoke the link editor

    Miscellaneous:
      a.out(4)          assembler, compiler, and linker output
      ar(4)             archive format

 STANDARDS CONFORMANCE    [Toc]    [Back]
      strip: SVID2, SVID3, XPG2, XPG3, XPG4, POSIX.2


 Hewlett-Packard Company            - 3 -   HP-UX 11i Version 2: August 2003