.RB "[\|" \-G\c
.I size\c
\&\|]
+.RB "[\|" \-\-help "\|]"
.RB "[\|" \-i "\|]"
.RB "[\|" \-l\c
.I ar\c
.I searchdir\c
\&\|]
.RB "[\|" \-M "\|]"
+.RB "[\|" \-Map\c
+.I mapfile\c
+\&\|]
.RB "[\|" \-m\c
.I emulation\c
\&\|]
.RB "[\|" \-n | \-N "\|]"
.RB "[\|" \-noinhibit-exec "\|]"
+.RB "[\|" "\-oformat\ "\c
+.I output-format\c
+\&\|]
.RB "[\|" "\-R\ "\c
.I filename\c
\&\|]
.RB "[\|" \-r | \-Ur "\|]"
.RB "[\|" \-S "\|]"
.RB "[\|" \-s "\|]"
+.RB "[\|" \-sort\-common "\|]"
.RB "[\|" "\-T\ "\c
.I commandfile\c
\&\|]
\&]
.RB "[\|" \-V "\|]"
.RB "[\|" \-v "\|]"
+.RB "[\|" \-\-version "\|]"
+.RB "[\|" \-warn\-common "\|]"
.RB "[\|" \-X "\|]"
.RB "[\|" \-x "\|]"
-.RB "[\|" { \c
-.I script\c
-.BR } "\|]"
.ad b
.hy 1
.SH DESCRIPTION
specifies a library.
.TP
-.BI "-b " "input-format"\c
+.BI "\-b " "input-format"\c
\&
Specify the binary format for input object files that follow this option
on the command line. You don't usually need to specify this, as
.B \-format \c
.I input-format\c
\&\c
-\& has the same effect.
+\& has the same effect, as does the script command
+.BR TARGET .
You may want to use this option if you are linking files with an unusual
binary format. You can also use \c
\&.
.TP
-.BI "-c " "commandfile"\c
+.BI "\-c " "commandfile"\c
\&
Directs \c
.B ld\c
with scripts written to call the old linker.
.TP
-.BI "-format " "input-format"\c
+.BI "\-format " "input\-format"\c
\&
Synonym for \c
.B \-b\c
\& \c
-.I input-format\c
+.I input\-format\c
\&.
.TP
.I size
under MIPS ECOFF. Ignored for other object file formats.
+.TP
+.B \-\-help
+Print a summary of the command-line options on the standard output and exit.
+This option and
+.B \-\-version
+begin with two dashes instead of one
+for compatibility with other GNU programs. The other options start with
+only one dash for compatibility with other linkers.
+
.TP
.B \-i
Perform an incremental link (same as option \c
\&).
.TP
-.BI "-l" "ar"\c
+.BI "\-l" "ar"\c
\&
Add an archive file \c
.I ar\c
specified.
.TP
-.BI "-L" "searchdir"\c
+.BI "\-L" "searchdir"\c
\&
This command adds path \c
.I searchdir\c
\&, and information on global
common storage allocation.
+.TP
+.BI "\-Map " "mapfile"\c
+Print to the file
+.I mapfile
+a link map\(em\&diagnostic information
+about where symbols are mapped by \c
+.B ld\c
+\&, and information on global
+common storage allocation.
+
.TP
.BI "\-m " "emulation"\c
Emulate the
if possible.
.TP
-.B \-noinhibit-exec
+.B \-noinhibit\-exec
Normally, the linker will not produce an output file if it encounters
errors during the link process. With this flag, you can specify that
you wish the output file retained even after non-fatal errors.
.TP
-.BI "-o " "output"\c
+.BI "\-o " "output"\c
\&
.I output\c
\&
\& can also specify the output file name.
.TP
-.BI "-R " "filename"\c
+.BI "\-oformat " "output\-format"\c
+\&
+Specify the binary format for the output object file.
+You don't usually need to specify this, as
+\c
+.B ld\c
+\& is configured to produce as a default output format the most
+usual format on each machine. \c
+.I output-format\c
+\& is a text string, the
+name of a particular format supported by the BFD libraries.
+The script command
+.B OUTPUT_FORMAT
+can also specify the output format, but this option overrides it.
+
+.TP
+.BI "\-R " "filename"\c
\&
.I file\c
\&
Omits all symbol information from the output file.
.TP
-.BI "{ " "script" " }"
-You can, if you wish, include a script of linker commands directly in
-the command line instead of referring to it via an input file. When the
-character `\|\c
-.B {\c
-\|' occurs on the command line, the linker switches to
-interpreting the command language until the end of the list of commands
-is reached\(em\&flagged with a closing brace `\|\c
-.B }\c
-\|'. Other command-line
-options will not be recognized while parsing the script.
-See the `\|\c
-.B ld\c
-\|' entry in `\|\c
-.B info\c
-\|', or the manual
-.I
-ld: the GNU linker
-\&, for a description of the command language.
+.B \-sort\-common
+Normally, when
+.B ld
+places the global common symbols in the appropriate output sections,
+it sorts them by size. First come all the one byte symbols, then all
+the two bytes, then all the four bytes, and then everything else.
+This is to prevent gaps between symbols due to
+alignment constraints. This option disables that sorting.
.TP
-.BI "-Tbss " "org"\c
+.BI "\-Tbss " "org"\c
.TP
-.BI "-Tdata " "org"\c
+.BI "\-Tdata " "org"\c
.TP
-.BI "-Ttext " "org"\c
+.BI "\-Ttext " "org"\c
Use \c
.I org\c
\& as the starting address for\(em\&respectively\(em\&the
\& must be a hexadecimal integer.
.TP
-.BI "-T " "commandfile"\c
+.BI "\-T " "commandfile"\c
\&
.TP
-.BI "-T" "commandfile"\c
+.BI "\-T" "commandfile"\c
Equivalent to \c
.B \-c \c
.I commandfile\c
\& processes them.
.TP
-.BI "-u " "sym"
+.BI "\-u " "sym"
Forces \c
.I sym\c
\& to be entered in the output file as an undefined symbol.
Display the version number for \c
.B ld
and list the supported emulations.
-Print which input files can and can not be opened.
+Display which input files can and can not be opened.
.TP
.B \-v
Display the version number for \c
.B ld\c
\&.
-Print which input files can and can not be opened.
+
+.TP
+.B \-\-version
+Display the version number for \c
+.B ld
+and exit.
+
+.TP
+.B \-warn\-common
+Warn when a common symbol is combined with another common symbol or with
+a symbol definition. Unix linkers allow this somewhat sloppy practice,
+but linkers on some other operating systems do not. This option allows
+you to find potential problems from combining global symbols.
.TP
.B \-X
projects / deliverable / binutils-gdb.git / blobdiff