MAN page from RedHat EL 6 toolchain-armiwmmx-2012-2012.12.1-oselas.2.2.x86_64.rpm


Section: GNU Development Tools (1)
Updated: 2017-09-21


strip - Discard symbols from object files. 


strip [-F bfdname |--target=bfdname]
      [-I bfdname |--input-target=bfdname]
      [-O bfdname |--output-target=bfdname]
      [-K symbolname |--keep-symbol=symbolname]
      [-N symbolname |--strip-symbol=symbolname]
      [-x|--discard-all] [-X |--discard-locals]
      [-R sectionname |--remove-section=sectionname]
      [-o file] [-p|--preserve-dates]
      [-v |--verbose] [-V|--version]
      [--help] [--info]


GNU strip discards all symbols from object filesobjfile. The list of object files may include archives.At least one object file must be given.

strip modifies the files named in its argument,rather than writing modified copies under different names. 


-F bfdname
Treat the original objfile as a file with the objectcode format bfdname, and rewrite it in the same format.
Show a summary of the options to strip and exit.
Display a list showing all architectures and object formats available.
-I bfdname
Treat the original objfile as a file with the objectcode format bfdname.
-O bfdname
Replace objfile with a file in the output format bfdname.
-R sectionname
Remove any section named sectionname from the output file. Thisoption may be given more than once. Note that using this optioninappropriately may make the output file unusable.
Remove all symbols.
Remove debugging symbols only.
Remove all symbols that are not needed for relocation processing.
-K symbolname
When stripping symbols, keep symbol symbolname even if it wouldnormally be stripped. This option may be given more than once.
-N symbolname
Remove symbol symbolname from the source file. This option may begiven more than once, and may be combined with strip options other than-K.
-o file
Put the stripped output in file, rather than replacing theexisting file. When this argument is used, only one objfileargument may be specified.
Preserve the access and modification dates of the file.
Permit regular expressions in symbolnames used in other commandline options. The question mark (?), asterisk (*), backslash (\) andsquare brackets ([]) operators can be used anywhere in the symbolname. If the first character of the symbol name is the exclamationpoint (!) then the sense of the switch is reversed for that symbol.For example:

          -w -K !foo -K fo*

would cause strip to only keep symbols that start with the letters``fo'', but to discard the symbol ``foo''.

Remove non-global symbols.
Remove compiler-generated local symbols.(These usually start with L or ..)
When stripping a file, perhaps with --strip-debug or--strip-unneeded, retain any symbols specifying source file names,which would otherwise get stripped.
Strip a file, removing contents of any sections that would not bestripped by --strip-debug and leaving the debugging sectionsintact. In ELF files, this preserves all note sections in the output.

The intention is that this option will be used in conjunction with--add-gnu-debuglink to create a two part executable. One astripped binary which will occupy less space in RAM and in adistribution and the second a debugging information file which is onlyneeded if debugging abilities are required. The suggested procedureto create these files is as follows:

1.<Link the executable as normal. Assuming that is is called>
"foo" then...
1.<Run objcopy --only-keep-debug foo foo.dbg to>
create a file containing the debugging info.
1.<Run objcopy --strip-debug foo to create a>
stripped executable.
1.<Run objcopy --add-gnu-debuglink=foo.dbg foo>
to add a link to the debugging info into the stripped executable.

Note---the choice of ".dbg" as an extension for the debug infofile is arbitrary. Also the "--only-keep-debug" step isoptional. You could instead do this:

1.<Link the executable as normal.>
1.<Copy foo to foo.full>
1.<Run strip --strip-debug foo>
1.<Run objcopy --add-gnu-debuglink=foo.full foo>

i.e., the file pointed to by the --add-gnu-debuglink can be thefull executable. It does not have to be a file created by the--only-keep-debug switch.

Note---this switch is only intended for use on fully linked files. Itdoes not make sense to use it on object files where the debugginginformation may be incomplete. Besides the gnu_debuglink featurecurrently only supports the presence of one filename containingdebugging information, not multiple filenames on a one-per-object-filebasis.

Show the version number for strip.
Verbose output: list all object files modified. In the case ofarchives, strip -v lists all members of the archive.
Read command-line options from file. The options read areinserted in place of the original @file option. If filedoes not exist, or cannot be read, then the option will be treatedliterally, and not removed.

Options in file are separated by whitespace. A whitespacecharacter may be included in an option by surrounding the entireoption in either single or double quotes. Any character (including abackslash) may be included by prefixing the character to be includedwith a backslash. The file may itself contain additional@file options; any such options will be processed recursively.



the Info entries for binutils. 


Copyright (c) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999,2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this documentunder the terms of the GNU Free Documentation License, Version 1.3or any later version published by the Free Software Foundation;with no Invariant Sections, with no Front-Cover Texts, and with noBack-Cover Texts. A copy of the license is included in thesection entitled ``GNU Free Documentation License''.




This document was created byman2html,using the manual pages.