Print this page
10366 ld(1) should support GNU-style linker sets
10581 ld(1) should know kernel modules are a thing


  13        [-i] [-I name] [-l x] [-L path] [-m] [-M mapfile]
  14        [-N string] [-o outfile] [-p auditlib] [-P auditlib]
  15        [-Q y | n] [-R path] [-s] [-S supportlib] [-t]
  16        [-u symname] [-V] [-Y P,dirlist] [-z absexec]
  17        [-z allextract | defaultextract | weakextract ] [-z altexec64]
  18        [-z aslr[=state]] [-z assert-deflib] [ -z assert-deflib=libname]
  19        [-z combreloc | nocombreloc ] [-z defs | nodefs]
  20        [-z direct | nodirect] [-z endfiltee]
  21        [-z fatal-warnings | nofatal-warnings ] [-z finiarray=function]
  22        [-z globalaudit] [-z groupperm | nogroupperm]
  23        [-z guidance[=id1,id2...] [-z help ]
  24        [-z ignore | record] [-z initarray=function] [-z initfirst]
  25        [-z interpose] [-z lazyload | nolazyload]
  26        [-z ld32=arg1,arg2,...] [-z ld64=arg1,arg2,...]
  27        [-z loadfltr] [-z muldefs] [-z nocompstrtab] [-z nodefaultlib]
  28        [-z nodelete] [-z nodlopen] [-z nodump] [-z noldynsym]
  29        [-z nopartial] [-z noversion] [-z now] [-z origin]
  30        [-z preinitarray=function] [-z redlocsym] [-z relaxreloc]
  31        [-z rescan-now] [-z recan] [-z rescan-start ... -z rescan-end]]
  32        [-z target=sparc|x86] [-z text | textwarn | textoff]

  33        [-z verbose] [-z wrap=symbol] filename...
  34 
  35 
  36 DESCRIPTION
  37        The link-editor, ld, combines relocatable object files by resolving
  38        symbol references to symbol definitions, together with performing
  39        relocations.  ld operates in two modes, static or dynamic, as governed
  40        by the -d option. In all cases, the output of ld is left in the file
  41        a.out by default. See NOTES.
  42 
  43 
  44        In dynamic mode, -dy, the default, relocatable object files that are
  45        provided as arguments are combined to produce an executable object
  46        file. This file is linked at execution with any shared object files
  47        that are provided as arguments. If the -G option is specified,
  48        relocatable object files are combined to produce a shared object.
  49        Without the -G option, a dynamic executable is created.
  50 
  51 
  52        In static mode, -dn, relocatable object files that are provided as


1091            reasons, this mode is not the default when building an executable
1092            or shared object. However, its use is recommended to ensure that
1093            the text segment of the dynamic object being built is shareable
1094            between multiple running processes. A shared text segment incurs
1095            the least relocation overhead when loaded into memory. See
1096            Position-Independent Code in Linker and Libraries Guide.
1097 
1098 
1099        -z textoff
1100 
1101            In dynamic mode only, allows relocations against all allocatable
1102            sections, including non-writable ones. This mode is the default
1103            when building a shared object.
1104 
1105 
1106        -z textwarn
1107 
1108            In dynamic mode only, lists a warning if any relocations against
1109            non-writable, allocatable sections remain. This mode is the default
1110            when building an executable.

























1111 
1112 
1113        -z verbose
1114 
1115            This option provides additional warning diagnostics during a link-
1116            edit.  Presently, this option conveys suspicious use of
1117            displacement relocations. This option also conveys the restricted
1118            use of static TLS relocations when building shared objects. In
1119            future, this option might be enhanced to provide additional
1120            diagnostics that are deemed too noisy to be generated by default.
1121 
1122 
1123        -zwrap=symbol
1124        -wrap= symbol
1125        --wrap= symbol
1126 
1127            Rename undefined references to symbol in order to allow wrapper
1128            code to be linked into the output object without having to modify
1129            source code. When -z wrap is specified, all undefined references to
1130            symbol are modified to reference __wrap_symbol, and all references




  13        [-i] [-I name] [-l x] [-L path] [-m] [-M mapfile]
  14        [-N string] [-o outfile] [-p auditlib] [-P auditlib]
  15        [-Q y | n] [-R path] [-s] [-S supportlib] [-t]
  16        [-u symname] [-V] [-Y P,dirlist] [-z absexec]
  17        [-z allextract | defaultextract | weakextract ] [-z altexec64]
  18        [-z aslr[=state]] [-z assert-deflib] [ -z assert-deflib=libname]
  19        [-z combreloc | nocombreloc ] [-z defs | nodefs]
  20        [-z direct | nodirect] [-z endfiltee]
  21        [-z fatal-warnings | nofatal-warnings ] [-z finiarray=function]
  22        [-z globalaudit] [-z groupperm | nogroupperm]
  23        [-z guidance[=id1,id2...] [-z help ]
  24        [-z ignore | record] [-z initarray=function] [-z initfirst]
  25        [-z interpose] [-z lazyload | nolazyload]
  26        [-z ld32=arg1,arg2,...] [-z ld64=arg1,arg2,...]
  27        [-z loadfltr] [-z muldefs] [-z nocompstrtab] [-z nodefaultlib]
  28        [-z nodelete] [-z nodlopen] [-z nodump] [-z noldynsym]
  29        [-z nopartial] [-z noversion] [-z now] [-z origin]
  30        [-z preinitarray=function] [-z redlocsym] [-z relaxreloc]
  31        [-z rescan-now] [-z recan] [-z rescan-start ... -z rescan-end]]
  32        [-z target=sparc|x86] [-z text | textwarn | textoff]
  33        [-z type=exec|kmod|reloc|shared]
  34        [-z verbose] [-z wrap=symbol] filename...
  35 
  36 
  37 DESCRIPTION
  38        The link-editor, ld, combines relocatable object files by resolving
  39        symbol references to symbol definitions, together with performing
  40        relocations.  ld operates in two modes, static or dynamic, as governed
  41        by the -d option. In all cases, the output of ld is left in the file
  42        a.out by default. See NOTES.
  43 
  44 
  45        In dynamic mode, -dy, the default, relocatable object files that are
  46        provided as arguments are combined to produce an executable object
  47        file. This file is linked at execution with any shared object files
  48        that are provided as arguments. If the -G option is specified,
  49        relocatable object files are combined to produce a shared object.
  50        Without the -G option, a dynamic executable is created.
  51 
  52 
  53        In static mode, -dn, relocatable object files that are provided as


1092            reasons, this mode is not the default when building an executable
1093            or shared object. However, its use is recommended to ensure that
1094            the text segment of the dynamic object being built is shareable
1095            between multiple running processes. A shared text segment incurs
1096            the least relocation overhead when loaded into memory. See
1097            Position-Independent Code in Linker and Libraries Guide.
1098 
1099 
1100        -z textoff
1101 
1102            In dynamic mode only, allows relocations against all allocatable
1103            sections, including non-writable ones. This mode is the default
1104            when building a shared object.
1105 
1106 
1107        -z textwarn
1108 
1109            In dynamic mode only, lists a warning if any relocations against
1110            non-writable, allocatable sections remain. This mode is the default
1111            when building an executable.
1112 
1113 
1114        -z type=exec|kmod|reloc|shared
1115 
1116            Specifies the type of object to create.
1117 
1118 
1119            exec
1120 
1121                Dynamic executable
1122 
1123 
1124            reloc
1125 
1126                Relocatable object
1127 
1128 
1129            shared
1130 
1131                Dynamic shared object
1132 
1133 
1134            kmod
1135 
1136                illumos kernel module
1137 
1138 
1139        -z verbose
1140 
1141            This option provides additional warning diagnostics during a link-
1142            edit.  Presently, this option conveys suspicious use of
1143            displacement relocations. This option also conveys the restricted
1144            use of static TLS relocations when building shared objects. In
1145            future, this option might be enhanced to provide additional
1146            diagnostics that are deemed too noisy to be generated by default.
1147 
1148 
1149        -zwrap=symbol
1150        -wrap= symbol
1151        --wrap= symbol
1152 
1153            Rename undefined references to symbol in order to allow wrapper
1154            code to be linked into the output object without having to modify
1155            source code. When -z wrap is specified, all undefined references to
1156            symbol are modified to reference __wrap_symbol, and all references