This is an archive of the discontinued LLVM Phabricator instance.

Differential D50022

[docs] Sort ld.lld.1 options
ClosedPublic

Authored by MaskRay on Jul 30 2018, 3:38 PM.

Details

Reviewers
ruiu
Commits
rGf35ff042f436: [docs] Sort ld.lld.1 options
rL338326: [docs] Sort ld.lld.1 options
rLLD338326: [docs] Sort ld.lld.1 options

Diff Detail

Repository
rLLD LLVM Linker

Event Timeline

MaskRay created this revision.Jul 30 2018, 3:38 PM
Herald added a subscriber: llvm-commits. · View Herald TranscriptJul 30 2018, 3:38 PM
Harbormaster completed remote builds in B20875: Diff 158110.Jul 30 2018, 3:38 PM
MaskRay updated this revision to Diff 158111.Jul 30 2018, 3:41 PM

Reoder -m before -Map (-M)

Harbormaster completed remote builds in B20876: Diff 158111.Jul 30 2018, 3:41 PM
ruiu added a comment.Jul 30 2018, 3:48 PM

Is this line-move-only change?

MaskRay added a comment.Jul 30 2018, 4:02 PM

Yes. The number of lines has not changed.

ruiu accepted this revision.Jul 30 2018, 4:04 PM

I know the total number of lines didn't change, but I wanted to double-check that you didn't modify any of these lines. Given all lines remain unchanged, LGTM.

This revision is now accepted and ready to land.Jul 30 2018, 4:04 PM
Closed by commit rLLD338326: [docs] Sort ld.lld.1 options (authored by MaskRay). · Explain WhyJul 30 2018, 4:08 PM
Closed by commit rL338326: [docs] Sort ld.lld.1 options (authored by MaskRay). · Explain Why
This revision was automatically updated to reflect the committed changes.
This revision was automatically updated to reflect the committed changes.

Revision Contents

PathSize
docs/
86 lines

Diff 158124

docs/ld.lld.1

Show First 20 Lines • Show All 140 Lines • ▼ Show 20 Lines
Name of entry point symbol. Name of entry point symbol.
.It Fl -error-limit Ns = Ns Ar value .It Fl -error-limit Ns = Ns Ar value
Maximum number of errors to emit before stopping. Maximum number of errors to emit before stopping.
A value of zero indicates that there is no limit. A value of zero indicates that there is no limit.
.It Fl -error-unresolved-symbols .It Fl -error-unresolved-symbols
Report unresolved symbols as errors. Report unresolved symbols as errors.
.It Fl -exclude-libs Ns = Ns Ar value .It Fl -exclude-libs Ns = Ns Ar value
Exclude static libraries from automatic export. Exclude static libraries from automatic export.
.It Fl -export-dynamic , Fl E
Put symbols in the dynamic symbol table.
.It Fl -export-dynamic-symbol Ns = Ns Ar symbol .It Fl -export-dynamic-symbol Ns = Ns Ar symbol
Include Include
.Ar symbol .Ar symbol
in the dynamic symbol table. in the dynamic symbol table.
.It Fl -export-dynamic , Fl E
Put symbols in the dynamic symbol table.
.It Fl -fatal-warnings .It Fl -fatal-warnings
Treat warnings as errors. Treat warnings as errors.
.It Fl -filter Ns = Ns Ar value , Fl F Ar value .It Fl -filter Ns = Ns Ar value , Fl F Ar value
Set the Set the
.Dv DT_FILTER .Dv DT_FILTER
field to the specified value. field to the specified value.
.It Fl -fini Ns = Ns Ar symbol .It Fl -fini Ns = Ns Ar symbol
Specify a finalizer function. Specify a finalizer function.
Show All 36 Lines
Set the base address to Set the base address to
.Ar value . .Ar value .
.It Fl -init Ns = Ns Ar symbol .It Fl -init Ns = Ns Ar symbol
Specify an initializer function. Specify an initializer function.
.It Fl -keep-unique Ns = Ns Ar symbol .It Fl -keep-unique Ns = Ns Ar symbol
Do not fold Do not fold
.Ar symbol .Ar symbol
during ICF. during ICF.
.It Fl l Ar libName, Fl -library Ns = Ns Ar libName
Root name of library to use.
.It Fl L Ar dir , Fl -library-path Ns = Ns Ar dir
Add a directory to the library search path.
.It Fl -lto-aa-pipeline Ns = Ns Ar value .It Fl -lto-aa-pipeline Ns = Ns Ar value
AA pipeline to run during LTO. AA pipeline to run during LTO.
Used in conjunction with Used in conjunction with
.Fl -lto-newpm-passes . .Fl -lto-newpm-passes .
.It Fl -lto-newpm-passes Ns = Ns Ar value .It Fl -lto-newpm-passes Ns = Ns Ar value
Passes to run during LTO. Passes to run during LTO.
.It Fl -lto-O Ns Ar opt-level .It Fl -lto-O Ns Ar opt-level
Optimization level for LTO. Optimization level for LTO.
.It Fl -lto-partitions Ns = Ns Ar value .It Fl -lto-partitions Ns = Ns Ar value
Number of LTO codegen partitions. Number of LTO codegen partitions.
.It Fl L Ar dir , Fl -library-path Ns = Ns Ar dir .It Fl m Ar value
Add a directory to the library search path. Set target emulation.
.It Fl l Ar libName, Fl -library Ns = Ns Ar libName
Root name of library to use.
.It Fl -Map Ns = Ns Ar file , Fl M Ar file .It Fl -Map Ns = Ns Ar file , Fl M Ar file
Print a link map to Print a link map to
.Ar file . .Ar file .
.It Fl m Ar value
Set target emulation.
.It Fl -no-as-needed .It Fl -no-as-needed
Always set Always set
.Dv DT_NEEDED .Dv DT_NEEDED
for shared libraries. for shared libraries.
.It Fl -no-color-diagnostics .It Fl -no-color-diagnostics
Do not use colors in diagnostics. Do not use colors in diagnostics.
.It Fl -no-define-common .It Fl -no-define-common
Do not assign space to common symbols. Do not assign space to common symbols.
Show All 12 Lines
.It Fl -no-threads .It Fl -no-threads
Do not run the linker multi-threaded. Do not run the linker multi-threaded.
.It Fl -no-undefined-version .It Fl -no-undefined-version
Report version scripts that refer undefined symbols. Report version scripts that refer undefined symbols.
.It Fl -no-undefined .It Fl -no-undefined
Report unresolved symbols even if the linker is creating a shared library. Report unresolved symbols even if the linker is creating a shared library.
.It Fl -no-whole-archive .It Fl -no-whole-archive
Restores the default behavior of loading archive members. Restores the default behavior of loading archive members.
.It Fl -noinhibit-exec
Retain the executable output file whenever it is still usable.
.It Fl -no-pie .It Fl -no-pie
Do not create a position independent executable. Do not create a position independent executable.
.It Fl -noinhibit-exec
Retain the executable output file whenever it is still usable.
.It Fl -nostdlib .It Fl -nostdlib
Only search directories specified on the command line. Only search directories specified on the command line.
.It Fl -oformat Ns = Ns Ar format .It Fl o Ar path
Specify the format for the output object file. Write the output executable, library, or object to
The only supported .Ar path .
.Ar format If not specified,
is .Dv a.out
.Cm binary , is used as a default.
which produces output with no ELF header.
.It Fl -omagic , Fl N
Set the text and data sections to be readable and writable.
.It Fl -opt-remarks-filename Ar file
Write optimization remarks in YAML format to
.Ar file .
.It Fl -opt-remarks-with-hotness
Include hotness information in the optimization remarks file.
.It Fl O Ns Ar value .It Fl O Ns Ar value
Optimize output file size. Optimize output file size.
.Ar value .Ar value
may be: may be:
.Pp .Pp
.Bl -tag -width 2n -compact .Bl -tag -width 2n -compact
.It Cm 0 .It Cm 0
Disable string merging. Disable string merging.
.It Cm 1 .It Cm 1
Enable string merging. Enable string merging.
.It Cm 2 .It Cm 2
Enable string tail merging. Enable string tail merging.
.El .El
.Pp .Pp
.Fl O Ns Cm 1 .Fl O Ns Cm 1
is the default. is the default.
.It Fl o Ar path .It Fl -oformat Ns = Ns Ar format
Write the output executable, library, or object to Specify the format for the output object file.
.Ar path . The only supported
If not specified, .Ar format
.Dv a.out is
is used as a default. .Cm binary ,
which produces output with no ELF header.
.It Fl -omagic , Fl N
Set the text and data sections to be readable and writable.
.It Fl -opt-remarks-filename Ar file
Write optimization remarks in YAML format to
.Ar file .
.It Fl -opt-remarks-with-hotness
Include hotness information in the optimization remarks file.
.It Fl -pie .It Fl -pie
Create a position independent executable. Create a position independent executable.
.It Fl -print-gc-sections .It Fl -print-gc-sections
List removed unused sections. List removed unused sections.
.It Fl -print-map .It Fl -print-map
Print a link map to the standard output. Print a link map to the standard output.
.It Fl -push-state .It Fl -push-state
Save the current state of Save the current state of
▲ Show 20 Lines • Show All 75 Lines • ▼ Show 20 Lines
.Li .bss .Li .bss
as the sectionname. as the sectionname.
.It Fl -Tdata Ns = Ns Ar value .It Fl -Tdata Ns = Ns Ar value
Same as Same as
.Fl -section-start .Fl -section-start
with with
.Li .data .Li .data
as the sectionname. as the sectionname.
.It Fl -Ttext Ns = Ns Ar value
Same as
.Fl -section-start
with
.Li .text
as the sectionname.
.It Fl -thinlto-cache-dir Ns = Ns Ar value .It Fl -thinlto-cache-dir Ns = Ns Ar value
Path to ThinLTO cached object file directory. Path to ThinLTO cached object file directory.
.It Fl -thinlto-cache-policy Ns = Ns Ar value .It Fl -thinlto-cache-policy Ns = Ns Ar value
Pruning policy for the ThinLTO cache. Pruning policy for the ThinLTO cache.
.It Fl -thinlto-jobs Ns = Ns Ar value .It Fl -thinlto-jobs Ns = Ns Ar value
Number of ThinLTO jobs. Number of ThinLTO jobs.
.It Fl -threads .It Fl -threads
Run the linker multi-threaded. Run the linker multi-threaded.
This option is enabled by default. This option is enabled by default.
.It Fl -trace
Print the names of the input files.
.It Fl -trace-symbol Ns = Ns Ar symbol , Fl y Ar symbol .It Fl -trace-symbol Ns = Ns Ar symbol , Fl y Ar symbol
Trace references to Trace references to
.Ar symbol . .Ar symbol .
.It Fl -trace
Print the names of the input files.
.It Fl -Ttext Ns = Ns Ar value
Same as
.Fl -section-start
with
.Li .text
as the sectionname.
.It Fl -undefined Ns = Ns Ar symbol , Fl u Ar symbol .It Fl -undefined Ns = Ns Ar symbol , Fl u Ar symbol
Force Force
.Ar symbol .Ar symbol
to be an undefined symbol during linking. to be an undefined symbol during linking.
.It Fl -unresolved-symbols Ns = Ns Ar value .It Fl -unresolved-symbols Ns = Ns Ar value
Determine how to handle unresolved symbols. Determine how to handle unresolved symbols.
.It Fl v
Display the version number and proceed with linking if object files are
specified.
.It Fl V , Fl -version
Display the version number and exit.
.It Fl -verbose .It Fl -verbose
Verbose mode. Verbose mode.
.It Fl -version-script Ns = Ns Ar file .It Fl -version-script Ns = Ns Ar file
Read version script from Read version script from
.Ar file . .Ar file .
.It Fl V , Fl -version
Display the version number and exit.
.It Fl v
Display the version number and proceed with linking if object files are
specified.
.It Fl -warn-backrefs .It Fl -warn-backrefs
Warn about reverse or cyclic dependencies to or between static archives. Warn about reverse or cyclic dependencies to or between static archives.
This can be used to ensure linker invocation remains compatible with This can be used to ensure linker invocation remains compatible with
traditional Unix-like linkers. traditional Unix-like linkers.
.It Fl -warn-common .It Fl -warn-common
Warn about duplicate common symbols. Warn about duplicate common symbols.
.It Fl -warn-unresolved-symbols .It Fl -warn-unresolved-symbols
Report unresolved symbols as warnings. Report unresolved symbols as warnings.
▲ Show 20 Lines • Show All 129 Lines • Show Last 20 Lines