One of our requirements in FreeBSD to enable lld as the system linker was that it has a man page. We created the man page in this review, and offer it for inclusion upstream.
Some options are missing detail, but it should make a good starting point.
Details
Details
Diff Detail
Diff Detail
Event Timeline
| docs/ld.lld.1 | ||
|---|---|---|
| 4 | Can we put this to .Sh HISTORY? | |
Comment Actions
Thank you for doing this!
| docs/ld.lld.1 | ||
|---|---|---|
| 48 | "md5", "sha1", "tree", "uuid", 0x<hexstring> (e.g. 0xdeadbeef) and "none" are accepted. tree is a synonym to sha1. | |
| 52–55 | -color-diagnostics={auto,always,never}
-color-diagnostics is a synonym to -color-diagnostics=auto | |
| 56 | -compress-debug-sections={none,zlib} If zlib is specified, lld compresses debug sections in output. | |
| 60 | -defsym=symbol=expression expression can either be another symbol or a linker script expression. E.g. -defsym=foo=bar | |
| 121 | both is default. | |
| 181 | -no-pie (-nopie was a typo and I recently fixed that.) | |
| 185–191 | --oformat, --omagic, --opt-remarks-filename and --opt-remarks-with-hotness. An option that starts with "o" must be preceded by two dashes. Otherwise it's interpreted as -o foo (output file). | |
| docs/ld.lld.1 | ||
|---|---|---|
| 185–191 | Fl renders the first dash, so Fl -omagic renders as --omagic. | |
| docs/ld.lld.1 | ||
|---|---|---|
| 4 | It seems excessive to create a .Sh HISTORY section containing only the history of the man page itself; this could perhaps be fleshed out in a subsequent commit with more history of lld and adoption in various projects? | |
| docs/ld.lld.1 | ||
|---|---|---|
| 115 | value is a filename, and this option reads a list of dynamic symbols from a given file. | |
| 139 | value is a symbol. | |
| 152 | input-format is one of binary, elf or default. default is synonym for elf. | |
| 194 | value is a filename. | |
| 232 | Currently a format must be "binary" if this option is given, and when the option is given, it outputs an ELF header-less file. | |
| 236 | value is a filename. | |
| 240–241 | O0 disables string merging. O1 enables string merging. O2 enables string tail merging. O1 is the default. | |
| 270 | value is a filename. | |
| 291 | Ditto | |
| 336 | This is the default. | |
| 337 | value is a symbol name. | |
| 347 | value is a symbol name. | |
| 353 | value is a filename. | |
| 373 | stack-size value max-page-size value muls nocombreloc execstack nocopyreloc nodelete nodlopen now origin norelro retpolineplt rodynamic wxneeded | |
| docs/ld.lld.1 | ||
|---|---|---|
| 232 | Should we accept elf also? | |
Comment Actions
- more feedback from review
- incorporated doc updates for -z from https://reviews.freebsd.org/D14220
| docs/ld.lld.1 | ||
|---|---|---|
| 409 | Not sure how this 稙 character ended up here, but it is fixed locally. | |
| docs/ld.lld.1 | ||
|---|---|---|
| 4 | I propose something like this: .Sh HISTORY This man page first appeared in .Fx . .Sh AUTHORS .An Ed Maste Aq Mt ed@FreeBSD.org A hidden comment has little added value. | |
Comment Actions
Thanks, I'll commit this later today. Not sure how I ended up with 01 instead of O1 but have fixed those locally.
I'd to have an "implementation details" section explaining (at least) the way lld does symbol resolution and how it differs from bfd/gold but that can be a later commit; perhaps you have notes from one of your talks already that could be dropped in.
| docs/ld.lld.1 | ||
|---|---|---|
| 4 | I'll come back to this for a future commit. | |
Can we put this to .Sh HISTORY?