unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

strip(1)                         User Commands                        strip(1)



NAME
       strip  - strip symbol table, debugging and line number information from
       an object file

SYNOPSIS
       /usr/ccs/bin/strip [-lVx] file...

DESCRIPTION
       The strip command removes the symbol table SHT_SYMTAB and  its  associ-
       ated  string  table, debugging information, and line number information
       from ELF object files. That is, besides the symbol table and associated
       string table, the following sections are removed:

       .line
       .debug*
       .stab*

       Once  this  stripping process has been done, limited symbolic debugging
       access is available for that file. Therefore, this command is  normally
       run only on production modules that have been debugged and tested.

       If  strip  is  executed  on  a common archive file (see ar.h(3HEAD)) in
       addition to processing the members, strip will remove the archive  sym-
       bol  table.  The archive symbol table must be restored by executing the
       ar(1) command with the -s option before the archive can  be  linked  by
       the ld(1) command. strip will produce appropriate warning messages when
       this situation arises.

       strip is used to reduce the file storage overhead taken by  the  object
       file.

OPTIONS
       The  amount  of  information  stripped from the  ELF object file can be
       controlled by using any of the following options:

       -l       Strip line number information only.Does not strip  the  symbol
                table or debugging information.



       -V       Prints, on standard error, the version number of  strip.



       -x       Does  not  strip  the  symbol table. Debugging and line number
                information may be stripped.



OPERANDS
       The following operand is supported:

       file     A path name referring to an executable file.



ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following environment  variables
       that  affect  the  execution  of strip: LANG, LC_ALL, LC_CTYPE, LC_MES-
       SAGES, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0        Successful completion.



       >>0       An error occurred.



FILES
       /tmp/strp*      Temporary files



ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE  AvailabilitySUNWbtool
       Interface StabilityStandard


SEE ALSO
       ar(1), as(1),  ld(1),  elf(3ELF),  tmpnam(3C),  a.out(4),  ar.h(3HEAD),
       attributes(5), environ(5), standards(5)

NOTES
       The  symbol table section will not be removed if it is contained within
       a segment or if the file is a relocatable object.

       The line number and debugging sections will not be removed if they  are
       contained within a segment or if their associated relocation section is
       contained within a segment.



SunOS 5.10                        15 Jan 2003                         strip(1)