\&\|]
.RB "[\|" \-n | \-N "\|]"
.RB "[\|" \-noinhibit-exec "\|]"
+.RB "[\|" "\-oformat\ "\c
+.I output-format\c
+\&\|]
.RB "[\|" "\-R\ "\c
.I filename\c
\&\|]
.RB "[\|" \-v "\|]"
.RB "[\|" \-X "\|]"
.RB "[\|" \-x "\|]"
-.RB "[\|" { \c
-.I script\c
-.BR } "\|]"
.ad b
.hy 1
.SH DESCRIPTION
.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
.B OUTPUT\c
\& can also specify the output file name.
+.TP
+.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
\&
.B \-s
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.
-
.TP
.BI "-Tbss " "org"\c
.TP
[ -format @var{input-format} ] [ -g ] [ -G @var{size} ] [ -i ]
[ -l@var{ar} ] [ -L@var{searchdir} ] [ -M ] [ -Map @var{mapfile} ]
[ -m @var{emulation} ] [ -N | -n ] [ -noinhibit-exec ]
- [ -R @var{filename} ] [ -relax ] [ -r | -Ur ] [ -S ] [ -s ]
- [ -T @var{commandfile} ] [ -Ttext @var{textorg} ] [ -Tdata @var{dataorg} ]
+ [ -oformat @var{output-format} ] [ -R @var{filename} ] [ -relax ]
+ [ -r | -Ur ] [ -S ] [ -s ] [ -T @var{commandfile} ]
+ [ -Ttext @var{textorg} ] [ -Tdata @var{dataorg} ]
[ -Tbss @var{bssorg} ] [ -t ] [ -u @var{sym}] [-V] [-v] [ -X ] [-x ]
- [ -y@var{symbol} ] [ @{ @var{script} @} ]
+ [ -y@var{symbol} ]
@end smallexample
This plethora of command-line options may seem intimidating, but in
@code{ld} is configured to expect as a default input format the most
usual format on each machine. @var{input-format} is a text string, the
name of a particular format supported by the BFD libraries.
-@w{@samp{-format @var{input-format}}} has the same effect. @xref{BFD}.
+(You can list the available binary formats with @samp{objdump -i}.)
+@w{@samp{-format @var{input-format}}} has the same effect, as does the
+script command @code{TARGET}. @xref{BFD}.
You may want to use this option if you are linking files with an unusual
binary format. You can also use @samp{-b} to switch formats explicitly (when
option is not specified, the name @file{a.out} is used by default. The
script command @code{OUTPUT} can also specify the output file name.
+@kindex -oformat
+@item -oformat @var{output-format}
+Specify the binary format for the output object file. You don't usually
+need to specify this, as @code{ld} is configured to produce as a default
+output format the most usual format on each machine.
+@var{output-format} is a text string, the name of a particular format
+supported by the BFD libraries. (You can list the available binary
+formats with @samp{objdump -i}.) The script command
+@code{OUTPUT_FORMAT} can also specify the output format, but this option
+overrides it. @xref{BFD}.
+
@item -R @var{filename}
@kindex -R @var{file}
@cindex symbol-only input
@cindex strip all symbols
Omit all symbol information from the output file.
-@item @{ @var{script} @}
-@kindex @{ @var{script} @}
-@cindex scripts on command line
-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 @samp{@{} occurs on the command line, the linker switches to
-interpreting the command language until the end of the list of commands
-is reached; the end is indicated with a closing brace @samp{@}}.
-@code{ld} does not recognize other command-line options while parsing
-the script. @xref{Commands}, for a description of the command language.
-
@item -Tbss @var{bssorg}
@kindex -Tbss @var{bssorg}
@itemx -Tdata @var{dataorg}