[PATCH] D42963: Add initial ld.lld.1 man page

[Rui Ueyama via Phabricator via llvm-commits]

ruiu added inline comments.


================
Comment at: docs/ld.lld.1:114
+.Dv PT_INTERP .
+.It Fl -dynamic-list Ar value
+Read a list of dynamic symbols.
----------------
value is a filename, and this option reads a list of dynamic symbols from a given file.


================
Comment at: docs/ld.lld.1:138
+Exclude static libraries from automatic export.
+.It Fl -export-dynamic-symbol Ar value
+Put a symbol in the dynamic symbol table.
----------------
value is a symbol.


================
Comment at: docs/ld.lld.1:151
+.It Fl -format= Ns Ar input-format
+Change the input format of the inputs following this option.
+.It Fl -gc-sections
----------------
input-format is one of binary, elf or default. default is synonym for elf.


================
Comment at: docs/ld.lld.1:193
+Root name of library to use.
+.It Fl -Map Ar value
+Print a link map to the specified file.
----------------
value is a filename.


================
Comment at: docs/ld.lld.1:231
+Only search directories specified on the command line.
+.It Fl -oformat Ar format
+Specify the binary format for the output object file.
----------------
Currently a format must be "binary" if this option is given, and when the option is given, it outputs an ELF header-less file.


================
Comment at: docs/ld.lld.1:235
+Set the text and data sections to be readable and writable.
+.It Fl -opt-remarks-filename Ar value
+YAML output file for optimization remarks.
----------------
value is a filename.


================
Comment at: docs/ld.lld.1:239-240
+Include hotness information in the optimization remarks file.
+.It Fl O Ar value
+Optimize output file size.
+.It Fl o Ar path
----------------
O0 disables string merging. O1 enables string merging. O2 enables string tail merging. O1 is the default.


================
Comment at: docs/ld.lld.1:269
+.Ar posix .
+.It Fl -script Ar value
+Read linker script from the path
----------------
value is a filename.


================
Comment at: docs/ld.lld.1:290
+Strip debugging information.
+.It Fl -symbol-ordering-file Ar value
+Lay out sections in the order specified by the symbol file.
----------------
Ditto


================
Comment at: docs/ld.lld.1:335
+.It Fl -threads
+Run the linker multi-threaded.
+.It Fl -trace-symbol Ar value
----------------
This is the default.


================
Comment at: docs/ld.lld.1:336
+Run the linker multi-threaded.
+.It Fl -trace-symbol Ar value
+Trace references to symbols.
----------------
value is a symbol name.


================
Comment at: docs/ld.lld.1:346
+as the sectionname.
+.It Fl -undefined Ar value
+Force undefined symbol during linking.
----------------
value is a symbol name.


================
Comment at: docs/ld.lld.1:352
+Verbose mode.
+.It Fl -version-script Ar value
+Read a version script.
----------------
value is a filename.


================
Comment at: docs/ld.lld.1:372
+Allow relocations against read-only segments.
+Sets the
+.Dv DT_TEXTREL flag in the
----------------
stack-size value
Set PT_GNU_STACK to a given value

max-page-size value
Override the system default maximum page size to a given value

muls
Synonym for --allow-multiple-definition

nocombreloc
Do not sort relocation section contents

execstack
Make the stack executable

nocopyreloc
Treat copy relocations as errors

nodelete
Set DF_1_NODELETE bit in DT_FLAGS_1 to 1

nodlopen
Set DF_1_NOOPEN bit in DT_FLAGS_1 to 1

now
Set DF_BIND_NOW bit

origin
Set DF_ORIGIN bit

norelro
Do not emit PT_GNU_RELRO segment

retpolineplt
Emit a PLT that mitigates Spectre v2 vulnerability

rodynamic
Make .dynamic section read-only

wxneeded
Create a PT_OPENBSD_WXNEEDED segment


https://reviews.llvm.org/D42963