debian/ld.gold.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
   2 .TH GOLD "1" "May 2011" "gold (GNU Binutils for Debian 2.21.51.20110421) 1.11" "User Commands"
   3 .SH NAME
   4 gold \- manual page for gold (GNU Binutils for Debian 2.21.51.20110421) 1.11
   5 .SH SYNOPSIS
   6 .B ld.gold
   7 [\fIoptions\fR] \fIfile\fR...
   8 .SH OPTIONS
   9 .TP
  10 \fB\-\-help\fR
  11 Report usage information
  12 .TP
  13 \fB\-v\fR, \fB\-\-version\fR
  14 Report version information
  15 .TP
  16 \fB\-V\fR
  17 Report version and target information
  18 .TP
  19 \fB\-\-add\-needed\fR
  20 Not supported
  21 .TP
  22 \fB\-\-no\-add\-needed\fR
  23 Do not copy DT_NEEDED tags from shared libraries
  24 .HP
  25 \fB\-\-allow\-multiple\-definition\fR Allow multiple definitions of symbols
  26 .TP
  27 \fB\-\-no\-allow\-multiple\-definition\fR
  28 Do not allow multiple definitions
  29 .TP
  30 \fB\-\-allow\-shlib\-undefined\fR
  31 Allow unresolved references in shared libraries
  32 .TP
  33 \fB\-\-no\-allow\-shlib\-undefined\fR
  34 Do not allow unresolved references in shared libraries
  35 .TP
  36 \fB\-\-as\-needed\fR
  37 Only set DT_NEEDED for shared libraries if used
  38 .TP
  39 \fB\-\-no\-as\-needed\fR
  40 Always DT_NEEDED for shared libraries
  41 .TP
  42 \fB\-assert\fR [ignored]
  43 Ignored
  44 .TP
  45 \fB\-b\fR [elf,binary], \fB\-\-format\fR [elf,binary]
  46 Set input format
  47 .HP
  48 \fB\-Bdynamic\fR                   \fB\-l\fR searches for shared libraries
  49 .HP
  50 \fB\-Bstatic\fR                    \fB\-l\fR does not search for shared libraries
  51 .TP
  52 \fB\-dy\fR
  53 alias for \fB\-Bdynamic\fR
  54 .TP
  55 \fB\-dn\fR
  56 alias for \fB\-Bstatic\fR
  57 .TP
  58 \fB\-Bsymbolic\fR
  59 Bind defined symbols locally
  60 .TP
  61 \fB\-Bsymbolic\-functions\fR
  62 Bind defined function symbols locally
  63 .TP
  64 \fB\-\-build\-id\fR [=STYLE]
  65 Generate build ID note
  66 .TP
  67 \fB\-\-check\-sections\fR
  68 Check segment addresses for overlaps (default)
  69 .TP
  70 \fB\-\-no\-check\-sections\fR
  71 Do not check segment addresses for overlaps
  72 .TP
  73 \fB\-\-compress\-debug\-sections\fR [none,zlib]
  74 Compress .debug_* sections in the output file
  75 .TP
  76 \fB\-\-copy\-dt\-needed\-entries\fR
  77 Not supported
  78 .HP
  79 \fB\-\-no\-copy\-dt\-needed\-entries\fR Do not copy DT_NEEDED tags from shared libraries
  80 .TP
  81 \fB\-\-cref\fR
  82 Output cross reference table
  83 .TP
  84 \fB\-\-no\-cref\fR
  85 Do not output cross reference table
  86 .TP
  87 \fB\-d\fR, \fB\-\-define\-common\fR
  88 Define common symbols
  89 .TP
  90 \fB\-\-no\-define\-common\fR
  91 Do not define common symbols
  92 .TP
  93 \fB\-dc\fR
  94 Alias for \fB\-d\fR
  95 .TP
  96 \fB\-dp\fR
  97 Alias for \fB\-d\fR
  98 .TP
  99 \fB\-\-debug\fR [all,files,script,task][,...]
 100 Turn on debugging
 101 .TP
 102 \fB\-\-defsym\fR SYMBOL=EXPRESSION
 103 Define a symbol
 104 .TP
 105 \fB\-\-demangle\fR [=STYLE]
 106 Demangle C++ symbols in log messages
 107 .TP
 108 \fB\-\-no\-demangle\fR
 109 Do not demangle C++ symbols in log messages
 110 .TP
 111 \fB\-\-detect\-odr\-violations\fR
 112 Look for violations of the C++ One Definition Rule
 113 .TP
 114 \fB\-\-no\-detect\-odr\-violations\fR
 115 Do not look for violations of the C++ One Definition Rule
 116 .TP
 117 \fB\-x\fR, \fB\-\-discard\-all\fR
 118 Delete all local symbols
 119 .TP
 120 \fB\-X\fR, \fB\-\-discard\-locals\fR
 121 Delete all temporary local symbols
 122 .TP
 123 \fB\-\-dynamic\-list\-data\fR
 124 Add data symbols to dynamic symbols
 125 .TP
 126 \fB\-\-dynamic\-list\-cpp\-new\fR
 127 Add C++ operator new/delete to dynamic symbols
 128 .HP
 129 \fB\-\-dynamic\-list\-cpp\-typeinfo\fR Add C++ typeinfo to dynamic symbols
 130 .TP
 131 \fB\-\-dynamic\-list\fR FILE
 132 Read a list of dynamic symbols
 133 .HP
 134 \fB\-e\fR ADDRESS, \fB\-\-entry\fR ADDRESS Set program start address
 135 .TP
 136 \fB\-\-exclude\-libs\fR lib,lib ...
 137 Exclude libraries from automatic export
 138 .TP
 139 \fB\-E\fR, \fB\-\-export\-dynamic\fR
 140 Export all dynamic symbols
 141 .TP
 142 \fB\-\-no\-export\-dynamic\fR
 143 Do not export all dynamic symbols (default)
 144 .TP
 145 \fB\-EB\fR
 146 Link big\-endian objects.
 147 .TP
 148 \fB\-\-eh\-frame\-hdr\fR
 149 Create exception frame header
 150 .TP
 151 \fB\-EL\fR
 152 Link little\-endian objects.
 153 .TP
 154 \fB\-\-no\-enum\-size\-warning\fR
 155 (ARM only) Do not warn about objects with incompatible enum sizes
 156 .TP
 157 \fB\-\-fatal\-warnings\fR
 158 Treat warnings as errors
 159 .TP
 160 \fB\-\-no\-fatal\-warnings\fR
 161 Do not treat warnings as errors
 162 .TP
 163 \fB\-fini\fR SYMBOL
 164 Call SYMBOL at unload\-time
 165 .TP
 166 \fB\-\-fix\-cortex\-a8\fR
 167 (ARM only) Fix binaries for Cortex\-A8 erratum.
 168 .TP
 169 \fB\-\-no\-fix\-cortex\-a8\fR
 170 (ARM only) Do not fix binaries for Cortex\-A8 erratum.
 171 .TP
 172 \fB\-\-merge\-exidx\-entries\fR
 173 (ARM only) Merge exidx entries in debuginfo.
 174 .TP
 175 \fB\-\-no\-merge\-exidx\-entries\fR
 176 (ARM only) Do not merge exidx entries in debuginfo.
 177 .TP
 178 \fB\-\-fix\-v4bx\fR
 179 (ARM only) Rewrite BX rn as MOV pc, rn for ARMv4
 180 .TP
 181 \fB\-\-fix\-v4bx\-interworking\fR
 182 (ARM only) Rewrite BX rn branch to ARMv4 interworking veneer
 183 .TP
 184 \fB\-g\fR
 185 Ignored
 186 .TP
 187 \fB\-h\fR FILENAME, \fB\-soname\fR FILENAME
 188 Set shared library name
 189 .TP
 190 \fB\-i\fR
 191 Ignored
 192 .TP
 193 \fB\-\-hash\-bucket\-empty\-fraction\fR FRACTION
 194 Min fraction of empty buckets in dynamic hash
 195 .TP
 196 \fB\-\-hash\-style\fR [sysv,gnu,both]
 197 Dynamic hash style
 198 .TP
 199 \fB\-I\fR PROGRAM, \fB\-\-dynamic\-linker\fR PROGRAM
 200 Set dynamic linker path
 201 .TP
 202 \fB\-\-incremental\fR
 203 Do an incremental link if possible; otherwise, do a full link and prepare output for incremental linking
 204 .TP
 205 \fB\-\-no\-incremental\fR
 206 Do a full link (default)
 207 .TP
 208 \fB\-\-incremental\-full\fR
 209 Do a full link and prepare output for incremental linking
 210 .TP
 211 \fB\-\-incremental\-update\fR
 212 Do an incremental link; exit if not possible
 213 .TP
 214 \fB\-\-incremental\-changed\fR
 215 Assume files changed
 216 .TP
 217 \fB\-\-incremental\-unchanged\fR
 218 Assume files didn't change
 219 .TP
 220 \fB\-\-incremental\-unknown\fR
 221 Use timestamps to check files (default)
 222 .TP
 223 \fB\-init\fR SYMBOL
 224 Call SYMBOL at load\-time
 225 .TP
 226 \fB\-\-just\-symbols\fR FILE
 227 Read only symbol values from FILE
 228 .TP
 229 \fB\-\-map\-whole\-files\fR
 230 Map whole files to memory (default on 64\-bit hosts)
 231 .TP
 232 \fB\-\-no\-map\-whole\-files\fR
 233 Map relevant file parts to memory (default on 32\-bit hosts)
 234 .TP
 235 \fB\-\-keep\-files\-mapped\fR
 236 Keep files mapped across passes (default)
 237 .TP
 238 \fB\-\-no\-keep\-files\-mapped\fR
 239 Release mapped files after each pass
 240 .TP
 241 \fB\-l\fR LIBNAME, \fB\-\-library\fR LIBNAME
 242 Search for library LIBNAME
 243 .TP
 244 \fB\-L\fR DIR, \fB\-\-library\-path\fR DIR
 245 Add directory to search path
 246 .TP
 247 \fB\-nostdlib\fR
 248 Only search directories specified on the command line.
 249 .TP
 250 \fB\-\-rosegment\fR
 251 Put read\-only non\-executable sections in their own segment
 252 .TP
 253 \fB\-m\fR EMULATION
 254 Ignored for compatibility
 255 .TP
 256 \fB\-M\fR, \fB\-\-print\-map\fR
 257 Write map file on standard output
 258 .TP
 259 \fB\-Map\fR MAPFILENAME
 260 Write map file
 261 .TP
 262 \fB\-n\fR, \fB\-\-nmagic\fR
 263 Do not page align data
 264 .TP
 265 \fB\-N\fR, \fB\-\-omagic\fR
 266 Do not page align data, do not make text readonly
 267 .TP
 268 \fB\-\-no\-omagic\fR
 269 Page align data, make text readonly
 270 .TP
 271 \fB\-\-enable\-new\-dtags\fR
 272 Enable use of DT_RUNPATH and DT_FLAGS
 273 .TP
 274 \fB\-\-disable\-new\-dtags\fR
 275 Disable use of DT_RUNPATH and DT_FLAGS
 276 .TP
 277 \fB\-\-noinhibit\-exec\fR
 278 Create an output file even if errors occur
 279 .TP
 280 \fB\-\-no\-undefined\fR
 281 Report undefined symbols (even with \fB\-\-shared\fR)
 282 .TP
 283 \fB\-o\fR FILE, \fB\-\-output\fR FILE
 284 Set output file name
 285 .TP
 286 \fB\-O\fR LEVEL, \fB\-optimize\fR LEVEL
 287 Optimize output file size
 288 .TP
 289 \fB\-\-oformat\fR [binary]
 290 Set output format
 291 .TP
 292 \fB\-p\fR
 293 (ARM only) Ignore for backward compatibility
 294 .TP
 295 \fB\-pie\fR
 296 Create a position independent executable
 297 .TP
 298 \fB\-\-pic\-executable\fR
 299 Create a position independent executable
 300 .TP
 301 \fB\-no\-pipeline\-knowledge\fR
 302 (ARM only) Ignore for backward compatibility
 303 .TP
 304 \fB\-\-plugin\fR PLUGIN
 305 Load a plugin library
 306 .TP
 307 \fB\-\-plugin\-opt\fR OPTION
 308 Pass an option to the plugin
 309 .TP
 310 \fB\-\-preread\-archive\-symbols\fR
 311 Preread archive symbols when multi\-threaded
 312 .TP
 313 \fB\-\-print\-symbol\-counts\fR FILENAME
 314 Print symbols defined and used for each input
 315 .TP
 316 \fB\-Qy\fR
 317 Ignored for SVR4 compatibility
 318 .TP
 319 \fB\-q\fR, \fB\-\-emit\-relocs\fR
 320 Generate relocations in output
 321 .TP
 322 \fB\-r\fR, \fB\-relocatable\fR
 323 Generate relocatable output
 324 .TP
 325 \fB\-\-relax\fR
 326 Relax branches on certain targets
 327 .TP
 328 \fB\-\-retain\-symbols\-file\fR FILE
 329 keep only symbols listed in this file
 330 .TP
 331 \fB\-R\fR DIR
 332 Add DIR to runtime search path
 333 .TP
 334 \fB\-rpath\fR DIR
 335 Add DIR to runtime search path
 336 .TP
 337 \fB\-\-rpath\-link\fR DIR
 338 Add DIR to link time shared library search path
 339 .TP
 340 \fB\-\-section\-ordering\-file\fR FILENAME
 341 Layout sections in the order specified.
 342 .TP
 343 \fB\-\-section\-start\fR SECTION=ADDRESS
 344 Set address of section
 345 .TP
 346 \fB\-\-sort\-common\fR [={ascending,descending}]
 347 Sort common symbols by alignment
 348 .TP
 349 \fB\-\-spare\-dynamic\-tags\fR COUNT
 350 Dynamic tag slots to reserve (default 5)
 351 .TP
 352 \fB\-s\fR, \fB\-\-strip\-all\fR
 353 Strip all symbols
 354 .TP
 355 \fB\-S\fR, \fB\-\-strip\-debug\fR
 356 Strip debugging information
 357 .TP
 358 \fB\-\-strip\-debug\-non\-line\fR
 359 Emit only debug line number information
 360 .TP
 361 \fB\-\-strip\-debug\-gdb\fR
 362 Strip debug symbols that are unused by gdb (at least versions <= 6.7)
 363 .TP
 364 \fB\-\-strip\-lto\-sections\fR
 365 Strip LTO intermediate code sections
 366 .TP
 367 \fB\-\-stub\-group\-size\fR SIZE
 368 (ARM only) The maximum distance from instructions in a group of sections to their stubs.  Negative values mean stubs are always after the group. 1 means using default size.
 369 .TP
 370 \fB\-\-no\-keep\-memory\fR
 371 Use less memory and more disk I/O (included only for compatibility with GNU ld)
 372 .TP
 373 \fB\-G\fR, \fB\-shared\fR
 374 Generate shared library
 375 .TP
 376 \fB\-Bshareable\fR
 377 Generate shared library
 378 .TP
 379 \fB\-\-split\-stack\-adjust\-size\fR SIZE
 380 Stack size when \fB\-fsplit\-stack\fR function calls non\-split
 381 .TP
 382 \fB\-static\fR
 383 Do not link against shared libraries
 384 .TP
 385 \fB\-\-icf\fR [none,all,safe]
 386 Identical Code Folding. '\-\-icf=safe' Folds ctors, dtors and functions whose pointers are definitely not taken.
 387 .TP
 388 \fB\-\-icf\-iterations\fR COUNT
 389 Number of iterations of ICF (default 2)
 390 .TP
 391 \fB\-\-print\-icf\-sections\fR
 392 List folded identical sections on stderr
 393 .TP
 394 \fB\-\-no\-print\-icf\-sections\fR
 395 Do not list folded identical sections
 396 .TP
 397 \fB\-\-keep\-unique\fR SYMBOL
 398 Do not fold this symbol during ICF
 399 .TP
 400 \fB\-\-gc\-sections\fR
 401 Remove unused sections
 402 .TP
 403 \fB\-\-no\-gc\-sections\fR
 404 Don't remove unused sections (default)
 405 .TP
 406 \fB\-\-print\-gc\-sections\fR
 407 List removed unused sections on stderr
 408 .TP
 409 \fB\-\-no\-print\-gc\-sections\fR
 410 Do not list removed unused sections
 411 .TP
 412 \fB\-\-stats\fR
 413 Print resource usage statistics
 414 .TP
 415 \fB\-\-sysroot\fR DIR
 416 Set target system root directory
 417 .TP
 418 \fB\-t\fR, \fB\-\-trace\fR
 419 Print the name of each input file
 420 .TP
 421 \fB\-T\fR FILE, \fB\-\-script\fR FILE
 422 Read linker script
 423 .TP
 424 \fB\-\-threads\fR
 425 Run the linker multi\-threaded
 426 .TP
 427 \fB\-\-no\-threads\fR
 428 Do not run the linker multi\-threaded
 429 .TP
 430 \fB\-\-thread\-count\fR COUNT
 431 Number of threads to use
 432 .TP
 433 \fB\-\-thread\-count\-initial\fR COUNT
 434 Number of threads to use in initial pass
 435 .HP
 436 \fB\-\-thread\-count\-middle\fR COUNT Number of threads to use in middle pass
 437 .TP
 438 \fB\-\-thread\-count\-final\fR COUNT
 439 Number of threads to use in final pass
 440 .TP
 441 \fB\-Tbss\fR ADDRESS
 442 Set the address of the bss segment
 443 .TP
 444 \fB\-Tdata\fR ADDRESS
 445 Set the address of the data segment
 446 .TP
 447 \fB\-Ttext\fR ADDRESS
 448 Set the address of the text segment
 449 .TP
 450 \fB\-u\fR SYMBOL, \fB\-\-undefined\fR SYMBOL
 451 Create undefined reference to SYMBOL
 452 .TP
 453 \fB\-\-verbose\fR
 454 Synonym for \fB\-\-debug\fR=\fIfiles\fR
 455 .TP
 456 \fB\-\-version\-script\fR FILE
 457 Read version script
 458 .TP
 459 \fB\-\-warn\-common\fR
 460 Warn about duplicate common symbols
 461 .TP
 462 \fB\-\-no\-warn\-common\fR
 463 Do not warn about duplicate common symbols (default)
 464 .TP
 465 \fB\-\-warn\-constructors\fR
 466 Ignored
 467 .TP
 468 \fB\-\-no\-warn\-constructors\fR
 469 Ignored
 470 .TP
 471 \fB\-\-warn\-execstack\fR
 472 Warn if the stack is executable
 473 .TP
 474 \fB\-\-no\-warn\-execstack\fR
 475 Do not warn if the stack is executable (default)
 476 .TP
 477 \fB\-\-no\-warn\-mismatch\fR
 478 Don't warn about mismatched input files
 479 .TP
 480 \fB\-\-warn\-multiple\-gp\fR
 481 Ignored
 482 .TP
 483 \fB\-\-warn\-search\-mismatch\fR
 484 Warn when skipping an incompatible library
 485 .TP
 486 \fB\-\-no\-warn\-search\-mismatch\fR
 487 Don't warn when skipping an incompatible library
 488 .TP
 489 \fB\-\-warn\-shared\-textrel\fR
 490 Warn if text segment is not shareable
 491 .TP
 492 \fB\-\-no\-warn\-shared\-textrel\fR
 493 Do not warn if text segment is not shareable (default)
 494 .TP
 495 \fB\-\-warn\-unresolved\-symbols\fR
 496 Report unresolved symbols as warnings
 497 .TP
 498 \fB\-\-error\-unresolved\-symbols\fR
 499 Report unresolved symbols as errors
 500 .TP
 501 \fB\-\-no\-wchar\-size\-warning\fR
 502 (ARM only) Do not warn about objects with incompatible wchar_t sizes
 503 .TP
 504 \fB\-\-whole\-archive\fR
 505 Include all archive contents
 506 .TP
 507 \fB\-\-no\-whole\-archive\fR
 508 Include only needed archive contents
 509 .TP
 510 \fB\-\-wrap\fR SYMBOL
 511 Use wrapper functions for SYMBOL
 512 .TP
 513 \fB\-y\fR SYMBOL, \fB\-\-trace\-symbol\fR SYMBOL
 514 Trace references to symbol
 515 .TP
 516 \fB\-\-undefined\-version\fR
 517 Allow unused version in script (default)
 518 .TP
 519 \fB\-\-no\-undefined\-version\fR
 520 Do not allow unused version in script
 521 .TP
 522 \fB\-Y\fR PATH
 523 Default search path for Solaris compatibility
 524 .TP
 525 \-(, \fB\-\-start\-group\fR
 526 Start a library search group
 527 .TP
 528 \-), \fB\-\-end\-group\fR
 529 End a library search group
 530 .TP
 531 \fB\-\-start\-lib\fR
 532 Start a library
 533 .TP
 534 \fB\-\-end\-lib\fR
 535 End a library
 536 .TP
 537 \fB\-z\fR combreloc
 538 Sort dynamic relocs
 539 .TP
 540 \fB\-z\fR nocombreloc
 541 Do not sort dynamic relocs
 542 .TP
 543 \fB\-z\fR common\-page\-size=SIZE
 544 Set common page size to SIZE
 545 .TP
 546 \fB\-z\fR defs
 547 Report undefined symbols (even with \fB\-\-shared\fR)
 548 .TP
 549 \fB\-z\fR execstack
 550 Mark output as requiring executable stack
 551 .TP
 552 \fB\-z\fR initfirst
 553 Mark DSO to be initialized first at runtime
 554 .TP
 555 \fB\-z\fR interpose
 556 Mark object to interpose all DSOs but executable
 557 .TP
 558 \fB\-z\fR lazy
 559 Mark object for lazy runtime binding (default)
 560 .TP
 561 \fB\-z\fR loadfltr
 562 Mark object requiring immediate process
 563 .TP
 564 \fB\-z\fR max\-page\-size=SIZE
 565 Set maximum page size to SIZE
 566 .TP
 567 \fB\-z\fR muldefs
 568 Allow multiple definitions of symbols
 569 .TP
 570 \fB\-z\fR nocopyreloc
 571 Do not create copy relocs
 572 .TP
 573 \fB\-z\fR nodefaultlib
 574 Mark object not to use default search paths
 575 .TP
 576 \fB\-z\fR nodelete
 577 Mark DSO non\-deletable at runtime
 578 .TP
 579 \fB\-z\fR nodlopen
 580 Mark DSO not available to dlopen
 581 .TP
 582 \fB\-z\fR nodump
 583 Mark DSO not available to dldump
 584 .TP
 585 \fB\-z\fR noexecstack
 586 Mark output as not requiring executable stack
 587 .TP
 588 \fB\-z\fR now
 589 Mark object for immediate function binding
 590 .TP
 591 \fB\-z\fR origin
 592 Mark DSO to indicate that needs immediate $ORIGIN processing at runtime
 593 .TP
 594 \fB\-z\fR relro
 595 Where possible mark variables read\-only after relocation
 596 .TP
 597 \fB\-z\fR norelro
 598 Don't mark variables read\-only after relocation
 599 .TP
 600 \fB\-z\fR text
 601 Do not permit relocations in read\-only segments
 602 .TP
 603 \fB\-z\fR textoff
 604 Permit relocations in read\-only segments (default)
 605 .PP
 606 debian/tmp/usr/bin/ld.gold: supported targets: elf32\-bigarm elf32\-littlearm elf64\-powerpcle elf64\-powerpc elf32\-powerpcle elf32\-powerpc elf64\-sparc elf32\-sparc elf64\-x86\-64 elf64\-x86\-64\-freebsd elf32\-i386 elf32\-i386\-freebsd
 607 .SH "REPORTING BUGS"
 608 Report bugs to <http://www.sourceware.org/bugzilla/>
 609 .SH COPYRIGHT
 610 Copyright 2011 Free Software Foundation, Inc.
 611 This program is free software; you may redistribute it under the terms of
 612 the GNU General Public License version 3 or (at your option) a later version.
 613 This program has absolutely no warranty.
 614 .SH "SEE ALSO"
 615 The full documentation for
 616 .B gold
 617 is maintained as a Texinfo manual.  If the
 618 .B info
 619 and
 620 .B gold
 621 programs are properly installed at your site, the command
 622 .IP
 623 .B info gold
 624 .PP
 625 should give you access to the complete manual.