ld/gld.1

   1 .\" Copyright (c) 1991 Free Software Foundation
   2 .\" See section COPYING for conditions for redistribution
   3 .\" $Id$
   4 .TH gld 1 "5 November 1991" "cygnus support" "GNU Development Tools"
   5 .de BP
   6 .sp
   7 .ti \-.2i
   8 \(**
   9 ..
  10
  11 .SH NAME
  12 gld \- the GNU linker
  13
  14 .SH SYNOPSIS
  15 .hy 0
  16 .na
  17 .TP
  18 .B gld
  19 .RB "[\|" \-o "
  20 .I output\c
  21 \&\|] \c
  22 .I objfiles\c
  23 \&.\|.\|.
  24 .br
  25 .RB "[\|" \-A\c
  26 .I architecture\c
  27 \&\|]
  28 .RB "[\|" "\-b\ "\c
  29 .I input-format\c
  30 \&\|]
  31 .RB "[\|" \-Bstatic "\|]"
  32 .RB "[\|" "\-c\ "\c
  33 .I commandfile\c
  34 \&\|]
  35 .RB "[\|" \-d | \-dc | \-dp\c
  36 \|]
  37 .br
  38 .RB "[\|" "\-defsym\ "\c
  39 .I symbol\c
  40 \& = \c
  41 .I expression\c
  42 \&\|]
  43 .RB "[\|" "\-e\ "\c
  44 .I entry\c
  45 \&\|]
  46 .RB "[\|" \-F "\|]"
  47 .RB "[\|" "\-F\ "\c
  48 .I format\c
  49 \&\|]
  50 .RB "[\|" "\-format\ "\c
  51 .I input-format\c
  52 \&\|]
  53 .RB "[\|" \-g "\|]"
  54 .RB "[\|" \-i "\|]"
  55 .RB "[\|" \-l\c
  56 .I ar\c
  57 \&\|]
  58 .RB "[\|" \-L\c
  59 .I searchdir\c
  60 \&\|]
  61 .RB "[\|" \-M | \-m "\|]"
  62 .RB "[\|" \-n "\|]"
  63 .RB "[\|" \-noinhibit-exec "\|]"
  64 .RB "[\|" "\-R\ "\c
  65 .I filename\c
  66 \&\|]
  67 .RB "[\|" \-r | \-Ur "\|]"
  68 .RB "[\|" \-S "\|]"
  69 .RB "[\|" \-s "\|]"
  70 .RB "[\|" "\-T\ "\c
  71 .I commandfile\c
  72 \&\|]
  73 .RB "[\|" "\-Ttext\ "\c
  74 .I textorg\c
  75 \&\|]
  76 .RB "[\|" "\-Tdata\ "\c
  77 .I dataorg\c
  78 \&\|]
  79 .RB "[\|" "\-Tbss\ "\c
  80 .I bssorg\c
  81 \&\|]
  82 .RB "[\|" \-t "\|]"
  83 .RB "[\|" "\-u\ "\c
  84 .I sym\c
  85 \&]
  86 .RB "[\|" \-v "\|]"
  87 .RB "[\|" \-X "\|]"
  88 .RB "[\|" \-x "\|]"
  89 .RB "[\|" { \c
  90 .I script\c
  91 .BR } "\|]"
  92 .ad b
  93 .hy 1
  94 .SH DESCRIPTION
  95 \c
  96 .B gld\c
  97 \& combines a number of object and archive files, relocates
  98 their data and ties up symbol references. Often the last step in
  99 building a new compiled program to run is a call to \c
 100 .B gld\c
 101 \&.
 102
 103 \c
 104 .B gld\c
 105 \& accepts Linker Command Language files
 106 to provide explicit and total control over the linking process.
 107 This man page does not describe the command language; see the `\|\c
 108 .B ld\c
 109 \|' entry in `\|\c
 110 .B info\c
 111 \|', or the manual
 112 .I
 113 gld: the GNU linker
 114 \&, for full details on the command language and on other aspects of
 115 the GNU linker.
 116
 117 This version of \c
 118 .B gld\c
 119 \& uses the general purpose BFD libraries
 120 to operate on object files. This allows \c
 121 .B gld\c
 122 \& to read, combine, and
 123 write object files in many different formats\(em\&for example, COFF or
 124 \c
 125 .B a.out\c
 126 \&.  Different formats may be linked together to produce any
 127 available kind of object file.  You can use `\|\c
 128 .B objdump \-i\c
 129 \|' to get a list of formats supported on various architectures; see
 130 .BR objdump ( 1 ).
 131
 132 Aside from its flexibility, the GNU linker is more helpful than other
 133 linkers in providing diagnostic information.  Many linkers abandon
 134 execution immediately upon encountering an error; whenever possible,
 135 \c
 136 .B gld\c
 137 \& continues executing, allowing you to identify other errors
 138 (or, in some cases, to get an output file in spite of the error).
 139
 140 The GNU linker \c
 141 .B gld\c
 142 \& is meant to cover a broad range of situations,
 143 and to be as compatible as possible with other linkers.  As a result,
 144 you have many choices to control its behavior through the command line,
 145 and through environment variables.
 146
 147 .SH OPTIONS
 148 The plethora of command-line options may seem intimidating, but in
 149 actual practice few of them are used in any particular context.
 150 For instance, a frequent use of \c
 151 .B gld\c
 152 \& is to link standard Unix
 153 object files on a standard, supported Unix system.  On such a system, to
 154 link a file \c
 155 .B hello.o\c
 156 \&:
 157 .sp
 158 .br
 159 $\ gld\ \-o\ output\ /lib/crt0.o\ hello.o\ \-lc
 160 .br
 161 .sp
 162 This tells \c
 163 .B gld\c
 164 \& to produce a file called \c
 165 .B output\c
 166 \& as the
 167 result of linking the file \c
 168 .B /lib/crt0.o\c
 169 \& with \c
 170 .B hello.o\c
 171 \& and
 172 the library \c
 173 .B libc.a\c
 174 \& which will come from the standard search
 175 directories.
 176
 177 The command-line options to \c
 178 .B gld\c
 179 \& may be specified in any order, and
 180 may be repeated at will.  For the most part, repeating an option with a
 181 different argument will either have no further effect, or override prior
 182 occurrences (those further to the left on the command line) of an
 183 option.
 184
 185 The exceptions\(em\&which may meaningfully be used more than once\(em\&are
 186 \c
 187 .B \-A\c
 188 \&, \c
 189 .B \-b\c
 190 \& (or its synonym \c
 191 .B \-format\c
 192 \&), \c
 193 .B \-defsym\c
 194 \&,
 195 \c
 196 .B \-L\c
 197 \&, \c
 198 .B \-l\c
 199 \&, \c
 200 .B \-R\c
 201 \&, and \c
 202 .B \-u\c
 203 \&.
 204
 205 The list of object files to be linked together, shown as \c
 206 .I objfiles\c
 207 \&,
 208 may follow, precede, or be mixed in with command-line options; save that
 209 an \c
 210 .I objfiles\c
 211 \& argument may not be placed between an option flag and
 212 its argument.
 213
 214 Usually the linker is invoked with at least one object file, but other
 215 forms of binary input files can also be specified with \c
 216 .B \-l\c
 217 \&,
 218 \c
 219 .B \-R\c
 220 \&, and the script command language.  If \c
 221 .I no\c
 222 \& binary input
 223 files at all are specified, the linker does not produce any output, and
 224 issues the message `\|\c
 225 .B No input files\c
 226 \|'.
 227
 228 Option arguments must either follow the option letter without intervening
 229 whitespace, or be given as separate arguments immediately following the
 230 option that requires them.
 231
 232 .TP
 233 .IR "objfiles" .\|.\|.
 234 The object files \c
 235 .I objfiles\c
 236 \& to be linked.
 237
 238 .TP
 239 .BI "-A" "architecture"\c
 240 \&
 241 In the current release of \c
 242 .B gld\c
 243 \&, this option is useful only for the
 244 Intel 960 family of architectures.  In that \c
 245 .B gld\c
 246 \& configuration, the
 247 \c
 248 .I architecture\c
 249 \& argument is one of the two-letter names identifying
 250 members of the 960 family; the option specifies the desired output
 251 target, and warns of any incompatible instructions in the input files.
 252 It also modifies the linker's search strategy for archive libraries, to
 253 support the use of libraries specific to each particular
 254 architecture, by including in the search loop names suffixed with the
 255 string identifying the architecture.
 256
 257 For example, if your \c
 258 .B gld\c
 259 \& command line included `\|\c
 260 .B \-ACA\c
 261 \|' as
 262 well as `\|\c
 263 .B \-ltry\c
 264 \|', the linker would look (in its built-in search
 265 paths, and in any paths you specify with \c
 266 .B \-L\c
 267 \&) for a library with
 268 the names
 269 .sp
 270 .br
 271 try
 272 .br
 273 libtry.a
 274 .br
 275 tryca
 276 .br
 277 libtryca.a
 278 .br
 279 .sp
 280
 281 The first two possibilities would be considered in any event; the last
 282 two are due to the use of `\|\c
 283 .B \-ACA\c
 284 \|'.
 285
 286 Future releases of \c
 287 .B gld\c
 288 \& may support similar functionality for
 289 other architecture families.
 290
 291 You can meaningfully use \c
 292 .B \-A\c
 293 \& more than once on a command line, if
 294 an architecture family allows combination of target architectures; each
 295 use will add another pair of name variants to search for when \c
 296 .B \-l\c
 297 \&
 298 specifies a library.
 299
 300 .TP
 301 .BI "-b " "input-format"\c
 302 \&
 303 Specify the binary format for input object files that follow this option
 304 on the command line.  You don't usually need to specify this, as
 305 \c
 306 .B gld\c
 307 \& is configured to expect as a default input format the most
 308 usual format on each machine.  \c
 309 .I input-format\c
 310 \& is a text string, the
 311 name of a particular format supported by the BFD libraries.
 312 \c
 313 .B \-format \c
 314 .I input-format\c
 315 \&\c
 316 \& has the same effect.
 317
 318 You may want to use this option if you are linking files with an unusual
 319 binary format.  You can also use \c
 320 .B \-b\c
 321 \& to switch formats explicitly (when
 322 linking object files of different formats), by including
 323 \c
 324 .B \-b \c
 325 .I input-format\c
 326 \&\c
 327 \& before each group of object files in a
 328 particular format.
 329
 330 The default format is taken from the environment variable
 331 .B GNUTARGET\c
 332 \&.  You can also define the input
 333 format from a script, using the command \c
 334 .B TARGET\c
 335 \&.
 336
 337 .TP
 338 .B \-Bstatic
 339 This flag is accepted for command-line compatibility with the SunOS linker,
 340 but has no effect on \c
 341 .B gld\c
 342 \&.
 343
 344 .TP
 345 .BI "-c " "commandfile"\c
 346 \&
 347 Directs \c
 348 .B gld\c
 349 \& to read link commands from the file
 350 \c
 351 .I commandfile\c
 352 \&.  These commands will completely override \c
 353 .B gld\c
 354 \&'s
 355 default link format (rather than adding to it); \c
 356 .I commandfile\c
 357 \& must
 358 specify everything necessary to describe the target format.
 359
 360
 361 You may also include a script of link commands directly in the command
 362 line by bracketing it between `\|\c
 363 .B {\c
 364 \|' and `\|\c
 365 .B }\c
 366 \|' characters.
 367
 368 .TP
 369 .B \-d
 370 .TP
 371 .B \-dc
 372 .TP
 373 .B \-dp
 374 These three options are equivalent; multiple forms are supported for
 375 compatibility with other linkers.  Use any of them to make \c
 376 .B ld\c
 377 \&
 378 assign space to common symbols even if a relocatable output file is
 379 specified (\c
 380 .B \-r\c
 381 \&).  The script command
 382 \c
 383 .B FORCE_COMMON_ALLOCATION\c
 384 \& has the same effect.
 385
 386 .TP
 387 .BI "-defsym " "symbol"\c
 388 \& = \c
 389 .I expression\c
 390 \&
 391 Create a global symbol in the output file, containing the absolute
 392 address given by \c
 393 .I expression\c
 394 \&.  You may use this option as many
 395 times as necessary to define multiple symbols in the command line.  A
 396 limited form of arithmetic is supported for the \c
 397 .I expression\c
 398 \& in this
 399 context: you may give a hexadecimal constant or the name of an existing
 400 symbol, or use \c
 401 .B +\c
 402 \& and \c
 403 .B \-\c
 404 \& to add or subtract hexadecimal
 405 constants or symbols.  If you need more elaborate expressions, consider
 406 using the linker command language from a script.
 407
 408 .TP
 409 .BI "-e " "entry"\c
 410 \&
 411 Use \c
 412 .I entry\c
 413 \& as the explicit symbol for beginning execution of your
 414 program, rather than the default entry point.  for a
 415 discussion of defaults and other ways of specifying the
 416 entry point.
 417
 418 .TP
 419 .B \-F
 420 .TP
 421 .BI "-F" "format"\c
 422 \&
 423 Some older linkers used this option throughout a compilation toolchain
 424 for specifying object-file format for both input and output object
 425 files.  \c
 426 .B gld\c
 427 \&'s mechanisms (the \c
 428 .B \-b\c
 429 \& or \c
 430 .B \-format\c
 431 \& options
 432 for input files, the \c
 433 .B TARGET\c
 434 \& command in linker scripts for output
 435 files, the \c
 436 .B GNUTARGET\c
 437 \& environment variable) are more flexible, but
 438 but it accepts (and ignores) the \c
 439 .B \-F\c
 440 \& option flag for compatibility
 441 with scripts written to call the old linker.
 442
 443 .TP
 444 .BI "-format " "input-format"\c
 445 \&
 446 Synonym for \c
 447 .B \-b\c
 448 \& \c
 449 .I input-format\c
 450 \&.
 451
 452 .TP
 453 .B \-g
 454 Accepted, but ignored; provided for compatibility with other tools.
 455
 456 .TP
 457 .B \-i
 458 Perform an incremental link (same as option \c
 459 .B \-r\c
 460 \&).
 461
 462 .TP
 463 .BI "-l" "ar"\c
 464 \&
 465 Add an archive file \c
 466 .I ar\c
 467 \& to the list of files to link.  This
 468 option may be used any number of times.  \c
 469 .B ld\c
 470 \& will search its
 471 path-list for occurrences of \c
 472 .B lib\c
 473 .I ar\c
 474 \&.a\c
 475 \& for every \c
 476 .I ar\c
 477 \&
 478 specified.
 479
 480 .TP
 481 .BI "-L" "searchdir"\c
 482 \&
 483 This command adds path \c
 484 .I searchdir\c
 485 \& to the list of paths that
 486 \c
 487 .B gld\c
 488 \& will search for archive libraries.  You may use this option
 489 any number of times.
 490
 491 The default set of paths searched (without being specified with
 492 \c
 493 .B \-L\c
 494 \&) depends on what emulation mode \c
 495 .B gld\c
 496 \& is using, and in
 497 some cases also on how it was configured.    The
 498 paths can also be specified in a link script with the \c
 499 .B SEARCH_DIR\c
 500 \&
 501 command.
 502
 503 .TP
 504 .B \-M
 505 .TP
 506 .B \-m
 507 Print (to the standard output file) a link map\(em\&diagnostic information
 508 about where symbols are mapped by \c
 509 .B ld\c
 510 \&, and information on global
 511 common storage allocation.
 512
 513 .TP
 514 .B \-n
 515 sets the text segment to be read only, and \c
 516 .B NMAGIC\c
 517 \& is written
 518 if possible.
 519
 520 .TP
 521 .B \-noinhibit-exec
 522 Normally, the linker will not produce an output file if it encounters
 523 errors during the link process.  With this flag, you can specify that
 524 you wish the output file retained even after non-fatal errors.
 525
 526 .TP
 527 .BI "-o " "output"\c
 528 \&
 529 .I output\c
 530 \&
 531 \c
 532 .I output\c
 533 \& is a name for the program produced by \c
 534 .B ld\c
 535 \&; if this
 536 option is not specified, the name `\|\c
 537 .B a.out\c
 538 \|' is used by default.  The
 539 script command \c
 540 .B OUTPUT\c
 541 \& can also specify the output file name.
 542
 543 .TP
 544 .BI "-R " "filename"\c
 545 \&
 546 .I file\c
 547 \&
 548 Read symbol names and their addresses from \c
 549 .I filename\c
 550 \&, but do not
 551 relocate it or include it in the output.  This allows your output file
 552 to refer symbolically to absolute locations of memory defined in other
 553 programs.
 554
 555 .TP
 556 .B \-r
 557 Generates relocatable output\(em\&i.e., generate an output file that can in
 558 turn serve as input to \c
 559 .B gld\c
 560 \&.  This is often called \c
 561 .I partial
 562 linking\c
 563 \&.  As a side effect, in environments that support standard Unix
 564 magic numbers, this option also sets the output file's magic number to
 565 \c
 566 .B OMAGIC\c
 567 \&.
 568 If this option is not specified, an absolute file is produced.  When
 569 linking C++ programs, this option \c
 570 .I will not\c
 571 \& resolve references to
 572 constructors; \c
 573 .B \-Ur\c
 574 \& is an alternative.
 575
 576 This option does the same as \c
 577 .B \-i\c
 578 \&.
 579
 580 .TP
 581 .B \-S
 582 Omits debugger symbol information (but not all symbols) from the output file.
 583
 584 .TP
 585 .B \-s
 586 Omits all symbol information from the output file.
 587
 588 .TP
 589 .BI "{ " "script" " }"
 590 You can, if you wish, include a script of linker commands directly in
 591 the command line instead of referring to it via an input file.  When the
 592 character `\|\c
 593 .B {\c
 594 \|' occurs on the command line, the linker switches to
 595 interpreting the command language until the end of the list of commands
 596 is reached\(em\&flagged with a closing brace `\|\c
 597 .B }\c
 598 \|'.  Other command-line
 599 options will not be recognized while parsing the script.
 600 for a description of the command language.
 601
 602 .TP
 603 .BI "-Tbss " "org"\c
 604 .TP
 605 .BI "-Tdata " "org"\c
 606 .TP
 607 .BI "-Ttext " "org"\c
 608 Use \c
 609 .I org\c
 610 \& as the starting address for\(em\&respectively\(em\&the
 611 \c
 612 .B bss\c
 613 \&, \c
 614 .B data\c
 615 \&, or the \c
 616 .B text\c
 617 \& segment of the output file.
 618 \c
 619 .I textorg\c
 620 \& must be a hexadecimal integer.
 621
 622 .TP
 623 .BI "-T " "commandfile"\c
 624 \&
 625 .TP
 626 .BI "-T" "commandfile"\c
 627 Equivalent to \c
 628 .B \-c \c
 629 .I commandfile\c
 630 \&\c
 631 \&; supported for compatibility with
 632 other tools.
 633
 634 .TP
 635 .B \-t
 636 Prints names of input files as \c
 637 .B ld\c
 638 \& processes them.
 639
 640 .TP
 641 .BI "-u " "sym"\c
 642 \&
 643 .I sym\c
 644 \&
 645 Forces \c
 646 .I sym\c
 647 \& to be entered in the output file as an undefined symbol.
 648 This may, for example, trigger linking of additional modules from
 649 standard libraries.  \c
 650 .B \-u\c
 651 \& may be repeated with different option
 652 arguments to enter additional undefined symbols.
 653
 654 .TP
 655 .B \-Ur
 656 For anything other than C++ programs, this option is equivalent to
 657 \c
 658 .B \-r\c
 659 \&: it generates relocatable output\(em\&i.e., an output file that can in
 660 turn serve as input to \c
 661 .B gld\c
 662 \&.  When linking C++ programs, \c
 663 .B \-Ur\c
 664 \&
 665 \c
 666 .I will\c
 667 \& resolve references to constructors, unlike \c
 668 .B \-r\c
 669 \&.
 670
 671 .TP
 672 .B \-v
 673 Display the version number for \c
 674 .B gld\c
 675 \&.
 676
 677 .TP
 678 .B \-X
 679 If \c
 680 .B \-s\c
 681 \& or \c
 682 .B \-S\c
 683 \& is also specified, delete only local symbols
 684 beginning with `\|\c
 685 .B L\c
 686 \|'.
 687
 688 .TP
 689 .B \-x
 690 If \c
 691 .B \-s\c
 692 \& or \c
 693 .B \-S\c
 694 \& is also specified, delete all local symbols,
 695 not just those beginning with `\|\c
 696 .B L\c
 697 \|'.
 698
 699 .PP
 700
 701 .SH ENVIRONMENT
 702 \c
 703 .B gld\c
 704 \& always consults two environment variables: \c
 705 .B GNUTARGET\c
 706 \&
 707 and \c
 708 .B LDEMULATION\c
 709 \&.  Depending on the setting of the latter, other
 710 environment variables may be used as well.
 711
 712 \c
 713 .B GNUTARGET\c
 714 \& determines the input-file object format if you don't
 715 use \c
 716 .B \-b\c
 717 \& (or its synonym \c
 718 .B \-format\c
 719 \&).  Its value should be one
 720 of the BFD names for an input format.  If there is no
 721 \c
 722 .B GNUTARGET\c
 723 \& in the environment, \c
 724 .B gld\c
 725 \& uses the natural format
 726 of the host. If \c
 727 .B GNUTARGET\c
 728 \& is set to \c
 729 .B default\c
 730 \& then BFD attempts to discover the
 731 input format by examining binary input files; this method often
 732 succeeds, but there are potential ambiguities, since there is no method
 733 of ensuring that the magic number used to flag object-file formats is
 734 unique.  However, the configuration procedure for BFD on each system
 735 places the conventional format for that system first in the search-list,
 736 so ambiguities are resolved in favor of convention.
 737
 738 \c
 739 .B LDEMULATION\c
 740 \& controls some aspects of \c
 741 .B gld\c
 742 \&'s dominant
 743 personality.  Although \c
 744 .B gld\c
 745 \& is flexible enough to permit its use
 746 in many contexts regardless of configuration, you can use this variable
 747 to make it act more like one or another older linker by default.
 748
 749 In particular, the value of \c
 750 .B LDEMULATION\c
 751 \& controls what default
 752 linker script is used (thereby controlling the default input and output
 753 formats; ; what default paths are searched for
 754 archive libraries; and in some cases whether additional linker script
 755 commands are available.
 756
 757 Here is the current set of emulations available:
 758
 759 .TP
 760 .B LDEMULATION=gld
 761 Emulate the older GNU linker.  When this emulation is selected, the
 762 default library search paths are
 763 .sp
 764 .br
 765 /lib
 766 .br
 767 /usr/lib
 768 .br
 769 /usr/local/lib/lib
 770 .br
 771 .sp
 772
 773 The default output format is set to \c
 774 .B a.out-generic-big\c
 775 \&, and the
 776 default machine is the system's configured BFD default.
 777
 778 .TP
 779 .B LDEMULATION=gld68k
 780 A variant of the \c
 781 .B gld\c
 782 \& emulation; only differs in specifically
 783 setting the default BFD machine as \c
 784 .B m68k\c
 785 \&.
 786
 787 .TP
 788 .B LDEMULATION=gld960
 789 Emulate the Intel port of the older \c
 790 .B gld\c
 791 \& for the i960
 792 architectures.  The default library search paths are taken from two
 793 other environment variables, \c
 794 .B G960LIB\c
 795 \& and \c
 796 .B G960BASE\c
 797 \&.  The
 798 default architecture is \c
 799 .B i960\c
 800 \&.  The default output format is set
 801 to \c
 802 .B b.out.big\c
 803 \&, and in fact the default output file name (if
 804 \c
 805 .B \-o\c
 806 \& is not specified) is \c
 807 .B b.out\c
 808 \&, to reflect this variant
 809 format, for this emulation.
 810
 811 This emulation can behave slightly differently depending on the setting
 812 of the \c
 813 .B gld\c
 814 \& compile-time switch \c
 815 .B GNU960\c
 816 \&.  If \c
 817 .B gld\c
 818 \& is
 819 compiled with \c
 820 .B GNU960\c
 821 \& defined, then an additional environment
 822 variable\(em\&\c
 823 .B GNUTARGET\c
 824 \&\(em\&is available; its value, if available,
 825 specifies some other default output format than \c
 826 .B b.out.big\c
 827 \&.
 828
 829 .TP
 830 .B LDEMULATION=gldm88kbcs
 831 Sets the output format to \c
 832 .B m88kbcs\c
 833 \& and the architecture to
 834 \c
 835 .B m88k\c
 836 \&.  Default library search paths are
 837 .sp
 838 .br
 839 /lib
 840 .br
 841 /usr/lib
 842 .br
 843 /usr/local/lib
 844 .br
 845 .sp
 846
 847 .TP
 848 .B LDEMULATION=lnk960
 849 Emulate the Intel linker \c
 850 .B lnk960\c
 851 \&.  The default output format is
 852 \c
 853 .B coff-Intel-big\c
 854 \&.  With this emulation, \c
 855 .B gld\c
 856 \&
 857 supports the additional script commands \c
 858 .B HLL\c
 859 \& and \c
 860 .B SYSLIB\c
 861 \& for
 862 specification of library archives.  This is the only emulation with
 863 extensive support for the \c
 864 .B \-A\c
 865 \& (architecture) command-line option.
 866 By default, the architecture \c
 867 .B CORE\c
 868 \& is assumed, but you can choose
 869 additional features from the i960 architecture family by using one of
 870 the following with \c
 871 .B \-A\c
 872 \& (or by using the \c
 873 .B OUTPUT_ARCH\c
 874 \& command
 875 from a script):
 876 .sp
 877 .br
 878 CORE
 879 .br
 880 KB
 881 .br
 882 SB
 883 .br
 884 MC
 885 .br
 886 XA
 887 .br
 888 CA
 889 .br
 890 KA
 891 .br
 892 SA
 893 .br
 894 .sp
 895
 896 The default libraries are chosen with some attention to the architecture
 897 selected; the core library `\|\c
 898 .B cg\c
 899 \|' is always included, but the library
 900 \c
 901 .B fpg\c
 902 \& is also used if you've specified any of the architectures
 903 \c
 904 .B KA\c
 905 \&, \c
 906 .B SA\c
 907 \&, or \c
 908 .B CA\c
 909 \&.
 910
 911 Like \c
 912 .B gld960\c
 913 \&, this emulation uses additional environment variables
 914 to set the default library search paths.  Also like \c
 915 .B gld960\c
 916 \&, the
 917 behavior of this emulation is slightly different depending on whether
 918 \c
 919 .B gld\c
 920 \& itself was compiled with \c
 921 .B GNU960\c
 922 \& defined.
 923
 924 If your \c
 925 .B gld\c
 926 \& was compiled with \c
 927 .B GNU960\c
 928 \& defined, the default
 929 paths are taken from all three of \c
 930 .B G960LIB\c
 931 \&, \c
 932 .B G960BASE\c
 933 \&, and
 934 \c
 935 .B I960BASE\c
 936 \&.  For the first two, paths you supply are automatically
 937 suffixed with `\|\c
 938 .B /lib/libcoff\c
 939 \|'; for the last, your path is
 940 automatically suffixed with `\|\c
 941 .B /lib\c
 942 \|'.
 943
 944 If your \c
 945 .B gld\c
 946 \& was \c
 947 .I not\c
 948 \& compiled with \c
 949 .B GNU960\c
 950 \& defined,
 951 the default paths are taken from \c
 952 .B I960BASE\c
 953 \&, and \c
 954 .B G960BASE\c
 955 \& is
 956 only consulted if \c
 957 .B I960BASE\c
 958 \& is undefined.  In this case
 959 \c
 960 .B G960LIB\c
 961 \& is not used at all.
 962
 963 .TP
 964 .B LDEMULATION=vanilla
 965 This is the least specific setting for \c
 966 .B gld\c
 967 \&.  You can set
 968 \c
 969 .B LDEMULATION=vanilla\c
 970 \& to disable emulation of other linkers.  This
 971 setting makes \c
 972 .B gld\c
 973 \& take the default machine from the BFD
 974 configuration on your system; \c
 975 .B a.out-generic-big\c
 976 \& is the default
 977 target.  No other defaults are specified.
 978
 979 .PP
 980
 981 .SH "SEE ALSO"
 982
 983 .BR objdump ( 1 )
 984 .br
 985 .br
 986 .RB "`\|" ld "\|' and `\|" binutils "\|'"
 987 entries in
 988 .B info\c
 989 .br
 990 .I
 991 gld: the GNU linker\c
 992 , Steve Chamberlain and Roland Pesch;
 993 .I
 994 The GNU Binary Utilities\c
 995 , Roland H. Pesch.
 996
 997 .SH COPYING
 998 Copyright (c) 1991 Free Software Foundation, Inc.
 999 .PP
1000 Permission is granted to make and distribute verbatim copies of
1001 this manual provided the copyright notice and this permission notice
1002 are preserved on all copies.
1003 .PP
1004 Permission is granted to copy and distribute modified versions of this
1005 manual under the conditions for verbatim copying, provided that the
1006 entire resulting derived work is distributed under the terms of a
1007 permission notice identical to this one.
1008 .PP
1009 Permission is granted to copy and distribute translations of this
1010 manual into another language, under the above conditions for modified
1011 versions, except that this permission notice may be included in
1012 translations approved by the Free Software Foundation instead of in
1013 the original English.