Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
LLVM-STRIP(1)			     LLVM			 LLVM-STRIP(1)

NAME
       llvm-strip - object stripping tool

SYNOPSIS
       llvm-strip [options] inputs...

DESCRIPTION
       llvm-strip  is  a tool to strip sections	and symbols from object	files.
       If no other stripping or	remove options are specified, --strip-all will
       be enabled.

       By  default, the	input files are	modified in-place. If "-" is specified
       for the input file, the input is	read from the program's	standard input
       stream.

       If the input is an archive, any requested operations will be applied to
       each archive member individually.

       The tool	is still in active development,	but in most scenarios it works
       as a drop-in replacement	for GNU's strip.

GENERIC	AND CROSS-PLATFORM OPTIONS
       The  following options are either agnostic of the file format, or apply
       to multiple file	formats.

       --disable-deterministic-archives, -U
	      Use real values for UIDs,	GIDs and timestamps when updating  ar-
	      chive member headers.

       --discard-all, -x
	      Remove  most  local symbols from the output. Different file for-
	      mats may limit this to a subset of the local symbols. For	 exam-
	      ple,  file  and  section symbols in ELF objects will not be dis-
	      carded.

       --enable-deterministic-archives,	-D
	      Enable deterministic mode	when stripping archives,  i.e.	use  0
	      for archive member header	UIDs, GIDs and timestamp fields. On by
	      default.

       --help, -h
	      Print a summary of command line options.

       --no-strip-all
	      Disable --strip-all.

       -o <file>
	      Write output to <file>. Multiple input files cannot be  used  in
	      combination with -o.

       --regex
	      If  specified,  symbol  and  section  names  specified  by other
	      switches are treated as extended POSIX regular  expression  pat-
	      terns.

       --remove-section	<section>, -R
	      Remove  the  specified section from the output. Can be specified
	      multiple times to	remove multiple	sections simultaneously.

       --strip-all-gnu
	      Remove all symbols, debug	sections and relocations from the out-
	      put.  This  option  is  equivalent  to  GNU  strip's --strip-all
	      switch.

       --strip-all, -S
	      For ELF objects, remove from the output all symbols and  non-al-
	      loc  sections  not  within  segments,  except  for .gnu.warning,
	      .ARM.attribute sections and the section name table.

	      For COFF objects,	remove all symbols, debug sections, and	 relo-
	      cations from the output.

       --strip-debug, -g
	      Remove all debug sections	from the output.

       --strip-symbol <symbol>,	-N
	      Remove all symbols named <symbol>	from the output. Can be	speci-
	      fied multiple times to remove multiple symbols.

       --strip-unneeded
	      Remove from the output all local or undefined symbols  that  are
	      not required by relocations. Also	remove all debug sections.

       --version, -V
	      Display the version of the llvm-strip executable.

       --wildcard, -w
	      Allow  wildcard  syntax  for symbol-related flags. On by default
	      for section-related flags. Incompatible with --regex.

	      Wildcard syntax allows the following special symbols:

		    +---------------+---------------------+------------+
		    |Character	    | Meaning		  | Equivalent |
		    +---------------+---------------------+------------+
		    |*		    | Any number of char- | .*	       |
		    |		    | acters		  |	       |
		    +---------------+---------------------+------------+
		    |?		    | Any  single charac- | .	       |
		    |		    | ter		  |	       |
		    +---------------+---------------------+------------+
		    |\		    | Escape   the   next | \	       |
		    |		    | character		  |	       |
		    +---------------+---------------------+------------+
		    |[a-z]	    | Character	class	  | [a-z]      |
		    +---------------+---------------------+------------+
		    |[!a-z], [^a-z] | Negated	character | [^a-z]     |
		    |		    | class		  |	       |
		    +---------------+---------------------+------------+

	      Additionally, starting a wildcard	with '!' will prevent a	match,
	      even if another flag matches. For	example	-w -N '*' -N '!x' will
	      strip all	symbols	except for x.

	      The order	of wildcards does not matter. For example, -w  -N  '*'
	      -N '!x' is the same as -w	-N '!x'	-N '*'.

       @<FILE>
	      Read  command-line  options  and	commands  from	response  file
	      _FILE_.

COFF-SPECIFIC OPTIONS
       The following options are implemented only for COFF  objects.  If  used
       with  other  objects,  llvm-strip will either emit an error or silently
       ignore them.

       --only-keep-debug
	      Remove the contents of non-debug sections	from the  output,  but
	      keep the section headers.

ELF-SPECIFIC OPTIONS
       The  following  options	are  implemented only for ELF objects. If used
       with other objects, llvm-strip will either emit an  error  or  silently
       ignore them.

       --allow-broken-links
	      Allow  llvm-strip	 to remove sections even if it would leave in-
	      valid section references.	Any invalid sh_link fields will	be set
	      to zero.

       --discard-locals, -X
	      Remove local symbols starting with ".L" from the output.

       --keep-file-symbols
	      Keep  symbols  of	type STT_FILE, even if they would otherwise be
	      stripped.

       --keep-section <section>
	      When removing sections from the output, do not  remove  sections
	      named  <section>.	Can be specified multiple times	to keep	multi-
	      ple sections.

       --keep-symbol <symbol>, -K
	      When removing symbols from the output,  do  not  remove  symbols
	      named <symbol>. Can be specified multiple	times to keep multiple
	      symbols.

       --preserve-dates, -p
	      Preserve access and modification timestamps in the output.

       --strip-sections
	      Remove from the output all section headers and all section  data
	      not  within  segments.  Note that	many tools will	not be able to
	      use an object without section headers.

       -T     Remove Swift symbols.

EXIT STATUS
       llvm-strip exits	with a non-zero	exit code if there is an error.	  Oth-
       erwise, it exits	with code 0.

BUGS
       To report bugs, please visit <https://bugs.llvm.org/>.

SEE ALSO
       llvm-objcopy(1)

AUTHOR
       Maintained by the LLVM Team (https://llvm.org/).

COPYRIGHT
       2003-2021, LLVM Project

12				  2021-02-28			 LLVM-STRIP(1)

NAME | SYNOPSIS | DESCRIPTION | GENERIC AND CROSS-PLATFORM OPTIONS | COFF-SPECIFIC OPTIONS | ELF-SPECIFIC OPTIONS | EXIT STATUS | BUGS | SEE ALSO | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=llvm-strip-devel&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help