Lines Matching +full:non +full:- +full:overlap +full:- +full:time

3 .\" SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
25 is a drop-in replacement for the GNU BFD and gold linkers.
30 currently supports i386, x86-64, ARM, AArch64, LoongArch, PowerPC32,
31 PowerPC64, MIPS32, MIPS64, RISC-V, AMDGPU, Hexagon and SPARC V9 targets.
33 acts as a Microsoft link.exe-compatible linker if invoked as
34 .Nm lld-link
43 Many options have both a single-letter and long form.
54 .Bl -tag -width indent
55 .It Fl -allow-multiple-definition
58 .It Fl -allow-shlib-undefined
61 .It Fl -apply-dynamic-relocs
62 Apply link-time values for dynamic relocations.
63 .It Fl -as-needed
67 .It Fl -auxiliary Ns = Ns Ar value
71 .It Fl -Bdynamic , Fl -dy
73 .It Fl -Bstatic , Fl -static , Fl -dn
75 .It Fl Bno-symbolic
85 .It Fl Bsymbolic-non-weak
88 .It Fl Bsymbolic-functions
91 .It Fl Bsymbolic-non-weak-functions
94 .It Fl --be8
96 .It Fl -build-id Ns = Ns Ar value
105 .Cm 0x Ns Ar hex-string ,
111 Build-IDs of type
120 .It Fl -build-id
122 .Fl -build-id Ns = Ns Cm sha1 .
123 .It Fl -call-graph-profile-sort Ns = Ns Ar algorithm
127 .Bl -tag -width 2n -compact
136 .It Fl -color-diagnostics Ns = Ns Ar value
146 .It Fl -color-diagnostics
148 .Fl -color-diagnostics Ns = Ns Cm auto .
149 .It Fl -compress-debug-sections Ns = Ns Ar value
155 .Bl -tag -width 2n -compact
165 .It Fl -compress-sections Ns = Ns Ar section-glob={none,zlib,zstd}[:level]
170 (if specified) or a default speed-focused level.
172 .Cm --compress-debug-sections.
173 .It Fl -cref
177 .It Fl -debug-names
181 .It Fl -default-script Ns = Ns Ar file , Fl dT Ar file
183 .Fl -script ,
185 .It Fl -defsym Ns = Ns Ar symbol Ns = Ns Ar expression
190 .Ql --defsym=foo=bar
192 .Ql --defsym=foo=bar+0x100 .
193 .It Fl -demangle
195 .It Fl -disable-new-dtags
197 .It Fl -discard-all , Fl x
199 .It Fl -discard-locals , Fl X
201 .It Fl -discard-none
203 .It Fl -dynamic-linker Ns = Ns Ar value
207 .It Fl -dynamic-list Ns = Ns Ar file
209 .Cm --export-dynamic-symbol-list .
211 .Cm -Bsymbolic
213 .It Fl -EB
214 Select the big-endian format in the OUTPUT_FORMAT command.
215 .It Fl -EL
216 Select the little-endian format in the OUTPUT_FORMAT command.
217 .It Fl -eh-frame-hdr
223 .It Fl -emit-relocs , Fl q
225 .It Fl -enable-new-dtags
227 .It Fl -enable-non-contiguous-regions
229 .It Fl -end-lib
232 .It Fl -entry Ns = Ns Ar entry
234 .It Fl -error-limit Ns = Ns Ar value
237 .It Fl -error-unresolved-symbols
239 .It Fl -error-handing-script Ns = Ns Ar script_path
248 .Cm missing-lib
250 .Cm undefined-symbol
252 .It Fl -execute-only
255 .It Fl -exclude-libs Ns = Ns Ar value
257 .It Fl -export-dynamic , Fl E
259 .It Fl -export-dynamic-symbol Ns = Ns Ar glob
260 (executable) Put matched non-local defined symbols to the dynamic symbol table.
261 (shared object) References to matched non-local STV_DEFAULT symbols shouldn't be bound to definitio…
262 .Cm -Bsymbolic
264 .Cm -Bsymbolic-functions
266 .Cm --dynamic-list
267 .It Fl -export-dynamic-symbol-list Ns = Ns Ar file
271 .Cm --export-dynamic-symbol
273 .It Fl -fatal-warnings
275 .It Fl -filter Ns = Ns Ar value , Fl F Ar value
279 .It Fl -fini Ns = Ns Ar symbol
281 .It Fl -force-group-allocation
282 Only meaningful for -r. Section groups are discarded. If two section group members are placed to th…
283 .It Fl -format Ns = Ns Ar input-format , Fl b Ar input-format
285 .Ar input-format
294 .It Fl -gc-sections
296 .It Fl -gdb-index
300 .It Fl -hash-style Ns = Ns Ar value
310 .It Fl -help
312 .It Fl -icf Ns = Ns Cm all
314 .It Fl -icf Ns = Ns Cm safe
316 .It Fl -icf Ns = Ns Cm none
318 .It Fl -ignore-data-address-equality
322 requirement: create copies of read-only data or merge two or more read-only data
324 .It Fl -ignore-function-address-equality
326 This option allows non-PIC calls to a function with non-default visibility in
330 .It Fl -image-base Ns = Ns Ar value
333 .It Fl -init Ns = Ns Ar symbol
335 .It Fl -keep-unique Ns = Ns Ar symbol
339 .It Fl l Ar libName, Fl -library Ns = Ns Ar libName
341 .It Fl L Ar dir , Fl -library-path Ns = Ns Ar dir
343 .It Fl -lto-aa-pipeline Ns = Ns Ar value
346 .Fl -lto-newpm-passes .
347 .It Fl -lto-newpm-passes Ns = Ns Ar value
349 .It Fl -lto-O Ns Ar opt-level
351 .It Fl -lto-partitions Ns = Ns Ar value
355 .It Fl -Map Ns = Ns Ar file , Fl M Ar file
358 .It Fl -nmagic , Fl n
360 .It Fl -no-allow-shlib-undefined
363 .It Fl -no-as-needed
367 .It Fl -no-color-diagnostics
369 .It Fl -no-demangle
371 .It Fl -no-dynamic-linker
375 .It Fl -no-fortran-common
377 .It Fl -no-gc-sections
379 .It Fl -no-gnu-unique
381 .It Fl -no-merge-exidx-entries
383 .It Fl -no-nmagic
385 .It Fl -no-omagic
387 .It Fl -no-relax
388 Disable target-specific relaxations. For x86-64 this disables R_X86_64_GOTPCRELX and R_X86_64_REX_G…
389 .It Fl -no-rosegment
390 Do not put read-only non-executable sections in their own segment.
391 .It Fl -undefined-version
393 .It Fl -no-undefined
395 .It Fl -no-warn-mismatch
397 .It Fl -no-warn-symbol-ordering
399 .It Fl -no-warnings , Fl w
401 .Cm --fatal-warnings.
402 .It Fl -no-whole-archive
404 .It Fl -no-pie , Fl -no-pic-executable
406 .It Fl -noinhibit-exec
408 .It Fl -nostdlib
421 .Bl -tag -width 2n -compact
432 .It Fl -oformat Ns = Ns Ar format
439 .It Fl -omagic , Fl N
442 .It Fl -opt-remarks-filename Ar file
445 .It Fl -opt-remarks-passes Ar pass-regex
447 .Ar pass-regex .
448 .It Fl -opt-remarks-with-hotness
450 .It Fl -orphan-handling Ns = Ns Ar mode
456 .Bl -tag -width 2n -compact
471 .It Fl -pack-dyn-relocs Ns = Ns Ar format
476 .Bl -tag -width 2n -compact
493 .Fl -use-android-relr-tags
496 .It Fl -pic-veneer
498 .It Fl -pie , Fl -pic-executable
500 .It Fl -power10-stubs Ns = Ns Cm mode
505 .Bl -tag -width 2n -compact
514 .It Fl -print-gc-sections
516 .It Fl -print-icf-sections
518 .It Fl -print-map
520 .It Fl -print-archive-stats Ns = Ns Ar file
523 .It Fl -push-state
525 .Fl -as-needed ,
526 .Fl -static ,
528 .Fl -whole-archive.
529 .It Fl -pop-state
531 .Fl -push-state.
532 .It Fl --relax-gp
533 Enable global pointer relaxation for RISC-V.
534 .It Fl -relocatable , Fl r
536 .It Fl -remap-inputs Ns = Ns Ar from-glob=to-file
538 .Cm from-glob
540 .Cm to-file.
544 .It Fl -remap-inputs-file Ns = Ns Ar file
548 .Cm from-glob=to-file
551 .It Fl -reproduce Ns = Ns Ar path
556 version.txt containing the output of ld.lld --version.
558 unpacked can be used to re-run the linker with the same options and input files.
559 .It Fl -retain-symbols-file Ns = Ns Ar file
561 .It Fl -rpath Ns = Ns Ar value , Fl R Ar value
565 .It Fl -rsp-quoting Ns = Ns Ar value
571 .It Fl -script Ns = Ns Ar file , Fl T Ar file
576 .It Fl -section-start Ns = Ns Ar section Ns = Ns Ar address
578 .It Fl -shared , Fl -Bsharable
580 .It Fl -shuffle-sections Ns = Ns Ar seed
582 If -1, reverse the section order. If 0, use a random seed.
583 .It Fl -soname Ns = Ns Ar value , Fl h Ar value
588 .It Fl -sort-common
590 .It Fl -sort-section Ns = Ns Ar value
592 .It Fl -start-lib
595 .It Fl -strip-all , Fl s
598 .Fl -strip-debug .
599 .It Fl -strip-debug , Fl S
601 .It Fl -symbol-ordering-file Ns = Ns Ar file
604 .It Fl -sysroot Ns = Ns Ar value
606 .It Fl -target1-abs
611 .It Fl -target1-rel
616 .It Fl -target2 Ns = Ns Ar type
627 .Cm got-rel .
628 .It Fl -Tbss Ns = Ns Ar value
630 .Fl -section-start
634 .It Fl -Tdata Ns = Ns Ar value
636 .Fl -section-start
640 .It Fl -Ttext Ns = Ns Ar value
642 .Fl -section-start
646 .It Fl -thinlto-cache-dir Ns = Ns Ar value
648 .It Fl -thinlto-cache-policy Ns = Ns Ar value
650 .It Fl -thinlto-jobs Ns = Ns Ar value
652 .It Fl -threads Ns = Ns Ar N
657 disables multi-threading.
658 .It Fl -fat-lto-objects
660 .It Fl -no-fat-lto-objects
662 .It Fl -time-trace
663 Record time trace.
664 .It Fl -time-trace-file Ns = Ns Ar file
665 Write time trace output to
667 .It Fl -time-trace-granularity Ns = Ns Ar value
668 Minimum time granularity (in microseconds) traced by time profiler.
669 .It Fl -trace
671 .It Fl -trace-symbol Ns = Ns Ar symbol , Fl y Ar symbol
674 .It Fl -undefined Ns = Ns Ar symbol , Fl u Ar symbol
680 .It Fl -undefined-glob Ns = Ns Ar pattern
682 .Fl -undefined ,
693 .Fl -undefined .
694 .It Fl -unique
696 .It Fl -unresolved-symbols Ns = Ns Ar value
698 .It Fl -use-android-relr-tags
703 .It Fl -version
705 .It Fl -verbose
707 .It Fl -version-script Ns = Ns Ar file
710 .It Fl -warn-backrefs
713 traditional Unix-like linkers.
714 .It Fl -warn-backrefs-exclude Ns = Ns Ar glob
715 Glob describing an archive (or an object file within --start-lib)
717 .Fl -warn-backrefs
718 .It Fl -warn-common
720 .It Fl -warn-ifunc-textrel
728 Use -warn-ifunc-textrel to let lld give a warning, if the
735 .It Fl -warn-unresolved-symbols
737 .It Fl -whole-archive
739 .It Fl -why-extract Ns = Ns Ar file
741 .It Fl -wrap Ns = Ns Ar symbol
752 .Bl -tag -width indent -compact
754 .It Cm dead-reloc-in-nonalloc Ns = Ns Ar section_glob=value
755 Resolve a relocation in a matched non-SHF_ALLOC section referencing a discarded symbol to
767 .It Cm bti-report Ns = Ns Ar [none|warning|error]
772 .It Cm cet-report Ns = Ns Ar [none|warning|error]
777 .It Cm pauth-report Ns = Ns Ar [none|warning|error]
782 .It Cm force-bti
785 .It Cm force-ibt
796 .It Cm ifunc-noplt
817 .It Cm lrodata-after-bss
824 .Fl -allow-multiple-definition.
854 Do not indicate that portions of the object should be mapped read-only
861 Allow relocations against read-only segments.
870 flag to indicate that the run-time loader should perform all relocation
881 .It Cm pac-plt
884 .It Cm pack-relative-relocs
886 .Cm -pack-dyn-relocs=relr
897 Emit retpoline format PLT entries as a mitigation for CVE-2017-5715.
902 section read-only.
907 .It Cm separate-loadable-segments
908 .It Cm separate-code
909 .It Cm noseparate-code
910 Specify whether two adjacent PT_LOAD segments are allowed to overlap in pages.
911 .Cm noseparate-code
912 (default) allows overlap.
913 .Cm separate-code
914 allows overlap between two executable segments, or two non-executable segments.
915 .Cm separate-loadable-segments
916 disallows overlap.
921 .It Cm stack-size Ns = Ns Ar size
929 .It Cm start-stop-gc
932 .It Cm nostart-stop-gc
936 Do not allow relocations against read-only segments.
947 .Bl -tag -width LC_CTYPE
950 .Fl -reproduce
952 .Fl -reproduce
965 file extension) is different from traditional linkers used on Unix-like
981 .Fl -start-group
983 .Fl -end-group
1004 .Fl -warn-backrefs
1006 with traditional Unix-like linker behavior.