Lines Matching +full:non +full:- +full:specified

4 .nr rst2man-indent-level 0
7 \\$1 \\n[an-margin]
8 level \\n[rst2man-indent-level]
9 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
10 -
11 \\n[rst2man-indent0]
12 \\n[rst2man-indent1]
13 \\n[rst2man-indent2]
18 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
19 . nr rst2man-indent-level +1
24 .\" indent \\n[an-margin]
25 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
26 .nr rst2man-indent-level -1
27 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
30 .TH "LLVM-OBJCOPY" "1" "2023-05-24" "16" "LLVM"
32 llvm-objcopy \- object copying and editing tool
35 \fBllvm\-objcopy\fP [\fIoptions\fP] \fIinput\fP [\fIoutput\fP]
38 \fBllvm\-objcopy\fP is a tool to copy and manipulate objects. In basic
40 specified, the output may be modified along the way, e.g. by removing sections.
42 If no output file is specified, the input file is modified in\-place. If \(dq\-\(dq is
43 specified for the input file, the input is read from the program\(aqs standard
44 input stream. If \(dq\-\(dq is specified for the output file, the output is written to
51 drop\-in replacement for GNU\(aqs \fBobjcopy\fP\&.
52 .SH GENERIC AND CROSS-PLATFORM OPTIONS
58 .B \-\-add\-gnu\-debuglink <debug\-file>
59 Add a .gnu_debuglink section for \fB<debug\-file>\fP to the output.
63 .B \-\-add\-section <section=file>
67 specified multiple times to add multiple sections.
74 .B \-\-binary\-architecture <arch>, \-B
79 .B \-\-disable\-deterministic\-archives, \-U
85 .B \-\-discard\-all, \-x
92 .B \-\-dump\-section <section>=<file>
94 specified multiple times to dump multiple sections to different files.
96 \fBllvm\-objcopy\fP and as such the normal copying and editing
105 .B \-\-enable\-deterministic\-archives, \-D
111 .B \-\-help, \-h
116 .B \-\-only\-keep\-debug
126 .B \-\-only\-section <section>, \-j
128 Can be specified multiple times to keep multiple sections.
135 .B \-\-redefine\-sym <old>=<new>
136 Rename symbols called \fB<old>\fP to \fB<new>\fP in the output. Can be specified
141 .B \-\-redefine\-syms <filename>
145 anything following a \(aq#\(aq. Can be specified multiple times to read names from
150 .B \-\-regex
151 If specified, symbol and section names specified by other switches are treated
156 .B \-\-remove\-section <section>, \-R
157 Remove the specified section from the output. Can be specified multiple times
165 .B \-\-set\-section\-alignment <section>=<align>
166 Set the alignment of section \fB<section>\fP to \fB<align>\fP\&. Can be specified
171 .B \-\-set\-section\-flags <section>=<flag>[,<flag>,...]
173 specified \fB<flag>\fP values. Can be specified multiple times to update multiple
188 \fIreadonly\fP = if this flag is not specified, add the \fISHF_WRITE\fP flag.
206 flags, unless the \fIload\fP flag is specified.
210 \fIreadonly\fP = if this flag is not specified, add the \fIIMAGE_SCN_MEM_WRITE\fP
229 .B \-\-strip\-all\-gnu
231 is equivalent to GNU \fBobjcopy\fP\(aqs \fB\-\-strip\-all\fP switch.
235 .B \-\-strip\-all, \-S
236 For ELF objects, remove from the output all symbols and non\-alloc sections not
240 For COFF and Mach\-O objects, remove all symbols, debug sections, and
245 .B \-\-strip\-debug, \-g
250 .B \-\-strip\-symbol <symbol>, \-N
251 Remove all symbols named \fB<symbol>\fP from the output. Can be specified
256 .B \-\-strip\-symbols <filename>
260 specified multiple times to read names from multiple files.
264 .B \-\-strip\-unneeded\-symbol <symbol>
270 .B \-\-strip\-unneeded\-symbols <filename>
274 trailing whitespace ignored, as is anything following a \(aq#\(aq. Can be specified
279 .B \-\-strip\-unneeded
285 .B \-\-update\-section <name>=<file>
292 .B \-\-version, \-V
293 Display the version of the \fBllvm\-objcopy\fP executable.
297 .B \-\-wildcard, \-w
298 Allow wildcard syntax for symbol\-related flags. On by default for
299 section\-related flags. Incompatible with \-\-regex.
339 \fB[a\-z]\fP
343 \fB[a\-z]\fP
347 \fB[!a\-z]\fP, \fB[^a\-z]\fP
351 \fB[^a\-z]\fP
357 another flag matches. For example \fB\-w \-N \(aq*\(aq \-N \(aq!x\(aq\fP will strip all symbols
360 The order of wildcards does not matter. For example, \fB\-w \-N \(aq*\(aq \-N \(aq!x\(aq\fP is
361 the same as \fB\-w \-N \(aq!x\(aq \-N \(aq*\(aq\fP\&.
366 Read command\-line options and commands from response file \fI<FILE>\fP\&.
368 .SH ELF-SPECIFIC OPTIONS
371 objects, \fBllvm\-objcopy\fP will either emit an error or silently ignore
375 .B \-\-add\-symbol <name>=[<section>:]<value>[,<flags>]
377 named \fB<section>\fP, with value \fB<value>\fP\&. If \fB<section>\fP is not specified,
402 \fIindirect\-function\fP = the symbol will be an \fISTT_GNU_IFUNC\fP symbol.
406 \fIconstructor\fP, \fIwarning\fP, \fIindirect\fP, \fIsynthetic\fP, \fIunique\-object\fP, \fIbefore\…
408 Can be specified multiple times to add multiple symbols.
412 .B \-\-allow\-broken\-links
413 Allow \fBllvm\-objcopy\fP to remove sections even if it would leave invalid
418 .B \-\-change\-start <incr>, \-\-adjust\-start
419 Add \fB<incr>\fP to the program\(aqs start address. Can be specified multiple
424 .B \-\-compress\-debug\-sections [<format>]
425 Compress DWARF debug sections in the output, using the specified format.
430 .B \-\-decompress\-debug\-sections
435 .B \-\-discard\-locals, \-X
440 .B \-\-extract\-dwo
445 .B \-\-extract\-main\-partition
450 .B \-\-extract\-partition <name>
455 .B \-\-globalize\-symbol <symbol>
457 Can be specified multiple times to mark multiple symbols.
461 .B \-\-globalize\-symbols <filename>
465 a \(aq#\(aq. Can be specified multiple times to read names from multiple files.
469 .B \-\-input\-target <format>, \-I
470 Read the input as the specified format. See \fI\%SUPPORTED FORMATS\fP for a list of
471 valid \fB<format>\fP values. If unspecified, \fBllvm\-objcopy\fP will attempt
476 .B \-\-keep\-file\-symbols
481 .B \-\-keep\-global\-symbol <symbol>, \-G
483 \fB<symbol>\fP\&. Can be specified multiple times to ignore multiple symbols.
487 .B \-\-keep\-global\-symbols <filename>
491 specified multiple times to read names from multiple files.
495 .B \-\-keep\-section <section>
497 \fB<section>\fP\&. Can be specified multiple times to keep multiple sections.
501 .B \-\-keep\-symbol <symbol>, \-K
503 \fB<symbol>\fP\&. Can be specified multiple times to keep multiple symbols.
507 .B \-\-keep\-symbols <filename>
511 specified multiple times to read names from multiple files.
515 .B \-\-localize\-hidden
520 .B \-\-localize\-symbol <symbol>, \-L
521 Mark any defined non\-common symbol named \fB<symbol>\fP as a local symbol in the
522 output. Can be specified multiple times to mark multiple symbols as local.
526 .B \-\-localize\-symbols <filename>
527 Read a list of names from the file \fB<filename>\fP and mark defined non\-common
530 anything following a \(aq#\(aq. Can be specified multiple times to read names from
535 .B \-\-new\-symbol\-visibility <visibility>
537 input or \fI\%\-\-add\-symbol\fP\&. Valid options are:
553 .B \-\-output\-target <format>, \-O
554 Write the output as the specified format. See \fI\%SUPPORTED FORMATS\fP for a list
556 be the same as the value specified for \fI\%\-\-input\-target\fP or the input
561 .B \-\-prefix\-alloc\-sections <prefix>
567 .B \-\-prefix\-symbols <prefix>
572 .B \-\-preserve\-dates, \-p
577 .B \-\-rename\-section <old>=<new>[,<flag>,...]
579 specified \fB<flag>\fP values. See \fI\%\-\-set\-section\-flags\fP for a list of
580 supported flags. Can be specified multiple times to rename multiple sections.
584 .B \-\-set\-section\-type <section>=<type>
586 specified multiple times to update multiple sections.
590 .B \-\-set\-start\-addr <addr>
592 specified \fI\%\-\-change\-start\fP or \fI\%\-\-adjust\-start\fP options.
596 .B \-\-split\-dwo <dwo\-file>
597 Equivalent to running \fBllvm\-objcopy\fP with \fI\%\-\-extract\-dwo\fP and
598 \fB<dwo\-file>\fP as the output file and no other options, and then with
599 \fI\%\-\-strip\-dwo\fP on the input file.
603 .B \-\-strip\-dwo
608 .B \-\-strip\-non\-alloc
609 Remove from the output all non\-allocatable sections that are not within
614 .B \-\-strip\-sections
621 .B \-\-target <format>, \-F
622 Equivalent to \fI\%\-\-input\-target\fP and \fI\%\-\-output\-target\fP for the
623 specified format. See \fI\%SUPPORTED FORMATS\fP for a list of valid \fB<format>\fP
628 .B \-\-weaken\-symbol <symbol>, \-W
630 be specified multiple times to mark multiple symbols as weak.
634 .B \-\-weaken\-symbols <filename>
638 a \(aq#\(aq. Can be specified multiple times to read names from multiple files.
642 .B \-\-weaken
645 .SH MACH-O-SPECIFIC OPTIONS
648 .B \-\-keep\-undefined
651 .SH COFF-SPECIFIC OPTIONS
654 .B \-\-subsystem <name>[:<version>]
659 The following values are currently supported by \fBllvm\-objcopy\fP for the
660 \fI\%\-\-input\-target\fP, \fI\%\-\-output\-target\fP, and \fI\%\-\-target\fP
668 \fIelf32\-i386\fP
670 \fIelf32\-x86\-64\fP
672 \fIelf64\-x86\-64\fP
674 \fIelf32\-iamcu\fP
676 \fIelf32\-littlearm\fP
678 \fIelf64\-aarch64\fP
680 \fIelf64\-littleaarch64\fP
682 \fIelf32\-littleriscv\fP
684 \fIelf64\-littleriscv\fP
686 \fIelf32\-powerpc\fP
688 \fIelf32\-powerpcle\fP
690 \fIelf64\-powerpc\fP
692 \fIelf64\-powerpcle\fP
694 \fIelf32\-bigmips\fP
696 \fIelf32\-ntradbigmips\fP
698 \fIelf32\-ntradlittlemips\fP
700 \fIelf32\-tradbigmips\fP
702 \fIelf32\-tradlittlemips\fP
704 \fIelf64\-tradbigmips\fP
706 \fIelf64\-tradlittlemips\fP
708 \fIelf32\-sparc\fP
710 \fIelf32\-sparcel\fP
713 Additionally, all targets except \fIbinary\fP and \fIihex\fP can have \fI\-freebsd\fP as a
717 If \fIbinary\fP is used as the value for \fI\%\-\-input\-target\fP, the input file
721 where \fB<file_name>\fP is the path of the input file as specified on the command
722 line with non\-alphanumeric characters converted to \fB_\fP\&.
724 If \fIbinary\fP is used as the value for \fI\%\-\-output\-target\fP, the output file
730 \fBllvm\-objcopy\fP exits with a non\-zero exit code if there is an error.
734 To report bugs, please visit <\fI\%https://github.com/llvm/llvm\-project/labels/tools:llvm\-objcopy…
736 There is a known issue with \fI\%\-\-input\-target\fP and \fI\%\-\-target\fP
738 will be ignored and \fBllvm\-objcopy\fP will attempt to guess the input
742 \fBllvm\-strip(1)\fP
746 2003-2023, LLVM Project