diff options
author | David MacKenzie <djm@cygnus> | 1993-06-17 20:55:43 +0000 |
---|---|---|
committer | David MacKenzie <djm@cygnus> | 1993-06-17 20:55:43 +0000 |
commit | 8ddef5528d34f05ff9a492e23b15ef5c6c8eb5fb (patch) | |
tree | f921e9cedac5cd479f9954d6b30598061db2e93d /ld/ld.texinfo | |
parent | 21cc14d8505ad50143ea248c0de12bfa9eecf1e7 (diff) | |
download | gdb-8ddef5528d34f05ff9a492e23b15ef5c6c8eb5fb.zip gdb-8ddef5528d34f05ff9a492e23b15ef5c6c8eb5fb.tar.gz gdb-8ddef5528d34f05ff9a492e23b15ef5c6c8eb5fb.tar.bz2 |
* ldfile.c (ldfile_open_command): Don't try .ld extension.
It wasn't documented (or likely used) and wastes time.
(try_open): If EXTEN is empty, don't try it.
* ldctor.c, lderror.c, ldexp.c, ldfile.c, ldindr.c, ldlang.c,
ldlex.l, ldmain.c, ldmisc.c, ldsym.c, ldver.c, ldwarn.c,
ldwrite.c, lexsup.c, mri.c, relax.c: Replace DEFUN macro calls
with normal function declarations.
* Move *.em to emultempl/*.em. Move *.sh to emulparams/*.sh.
Move *.sc-sh to scripttempl/*.sc.
* {emultempl,emulparams,scripttempl}/README: New files.
* sh.em, st2000.em, z8ksim.em, h8300hms.em, h8500hms.em: Files
removed, replaced with generic.em.
* h8300.sh, h8500.sh, h8300.sc, h8500.sc: Renamed from
h8[35]00hms.s[ch]. Change their contents to omit the "hms".
* *.em (*_get_script): Return script name instead of script contents.
* ldlang.c (lang_process): Change caller.
* ldlex.l, ldgram.y: Recognize -m option.
Check for input files after *all* options in grammar.
* ldmain.c (main): Check for -m options. Add default directory
for -m.
* mkscript.c: File removed.
* genscripts.sh: Take two more parameters, tooldirlib and libdir,
to add to the default LIB_PATH.
Look for input files in the new subdirectories.
Create the scripts in emulations subdirectory and don't filter
them through mkscript.
* configure.in: Make the emulations subdirectory.
* Makefile.in: Account for all of the above changes.
Remove unused .SUFFIXES. Get libgcc.a path with gcc
-print-libgcc-file-name instead of $(libdir)/libgcc.a.
Put CFLAGS last in the compilation rules.
Add -I../bfd to INCLUDES so sysdep.h is found.
* ldfile.c (try_open): If opening without the extension fails,
try with the extension even if -v or -V was given.
had_script is imported (from ldgram.y), not exported.
Diffstat (limited to 'ld/ld.texinfo')
-rw-r--r-- | ld/ld.texinfo | 52 |
1 files changed, 38 insertions, 14 deletions
diff --git a/ld/ld.texinfo b/ld/ld.texinfo index a918e1a..33317d6 100644 --- a/ld/ld.texinfo +++ b/ld/ld.texinfo @@ -9,7 +9,7 @@ @ifinfo @format START-INFO-DIR-ENTRY -* Ld: (ld). The GNU linker. +* Ld:: The GNU linker. END-INFO-DIR-ENTRY @end format @end ifinfo @@ -163,17 +163,17 @@ line: @c FIXME! -relax only avail h8/300, i960. Conditionals screwed in examples. @smallexample -ld [-o @var{output} ] @var{objfile@dots{}} +ld [-o @var{output} ] @var{objfile}@dots{} [ -A@var{architecture} ] [ -b @var{input-format} ] [ -Bstatic ] [ -c @var{MRI-commandfile} ] [ -d | -dc | -dp ] [ -defsym @var{symbol}=@var{expression} ] [ -e @var{entry} ] [ -F ] [ -F @var{format} ] - [ -format @var{input-format} ] [ -g ] [ -i ] - [ -l@var{ar} ] [ -L@var{searchdir} ] [ -M | -m ] - [ -n | -N ] [ -noinhibit-exec ] [ -R @var{filename} ] + [ -format @var{input-format} ] [ -g ] [ -G @var{size} ] [ -i ] + [ -l@var{ar} ] [ -L@var{searchdir} ] [ -M ] [ -m @var{emulation} ] + [ -N | -n ] [ -noinhibit-exec ] [ -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] [ -X ] [ -x ] [ -y@var{symbol} ] + [ -t ] [ -u @var{sym}] [-V] [-v] [ -X ] [ -x ] [ -y@var{symbol} ] [ @{ @var{script} @} ] @end smallexample @@ -210,7 +210,7 @@ The exceptions---which may meaningfully be used more than once---are @end ifset @cindex object files -The list of object files to be linked together, shown as @var{objfile@dots{}}, +The list of object files to be linked together, shown as @var{objfile}@dots{}, may follow, precede, or be mixed in with command-line options, except that an @var{objfile} argument may not be placed between an option and its argument. @@ -226,7 +226,7 @@ whitespace, or be given as separate arguments immediately following the option that requires them. @table @code -@item @var{objfile@dots{}} +@item @var{objfile}@dots{} The object files to be linked. @ifset I960 @@ -286,6 +286,8 @@ files written in an alternate, restricted command language, described in @ref{MRI,,MRI Compatible Script Files}. Introduce MRI script files with the option @samp{-c}; use the @samp{-T} option to run linker scripts written in the general-purpose @code{ld} scripting language. +If @var{MRI-cmdfile} does not exist, @code{ld} looks for it in the directories +specified by any @samp{-L} options. @cindex common allocation @kindex -d @@ -346,12 +348,18 @@ Synonym for @samp{-b @var{input-format}}. @item -g Ignored. Provided for compatibility with other tools. +@kindex -G +@cindex object size +@item -G@var{value} +@itemx -G @var{value} +Set the maximum size of objects to be optimized using the GP register to +@var{size} under MIPS ECOFF. Ignored for other object file formats. + @kindex -i @cindex incremental link @item -i Perform an incremental link (same as option @samp{-r}). - @cindex archive files, from cmd line @kindex -l@var{ar} @item -l@var{ar} @@ -364,7 +372,8 @@ specified. @kindex -L@var{dir} @item -L@var{searchdir} Add path @var{searchdir} to the list of paths that @code{ld} will search -for archive libraries. You may use this option any number of times. +for archive libraries and @code{ld} control scripts. You may use this +option any number of times. @ifset UsesEnvVars The default set of paths searched (without being specified with @@ -378,12 +387,18 @@ The paths can also be specified in a link script with the @cindex link map @kindex -M @item -M -@kindex -m -@itemx -m Print (to the standard output) a link map---diagnostic information about where symbols are mapped by @code{ld}, and information on global common storage allocation. +@cindex emulation +@kindex -m @var{emulation} +@item -m@var{emulation} +@itemx -m @var{emulation} +Emulate the @var{emulation} linker. You can list the available +emulations with the @samp{-V} option. The +default is the system for which you configured @code{ld}. + @kindex -N @cindex read/write from cmd line @kindex OMAGIC @@ -499,6 +514,8 @@ Read link commands from the file default link format (rather than adding to it); @var{commandfile} must specify everything necessary to describe the target format. @xref{Commands}. +If @var{commandfile} does not exist, @code{ld} looks for it in the directories +specified by any @samp{-L} options. You may also include a script of link commands directly in the command line by bracketing it between @samp{@{} and @samp{@}}. @@ -527,10 +544,17 @@ For anything other than C++ programs, this option is equivalent to turn serve as input to @code{ld}. When linking C++ programs, @samp{-Ur} @emph{will} resolve references to constructors, unlike @samp{-r}. +@item -V +@kindex -V +@cindex version +Display the version number for @code{ld} and list the supported emulations. +Print which input files can and can not be opened. + @item -v @kindex -v @cindex version Display the version number for @code{ld}. +Print which input files can and can not be opened. @item -X @kindex -X @@ -1316,7 +1340,7 @@ file have not yet been defined. @kindex [ @var{sections} ] This is an alternate notation to specify named sections from all unallocated input files; its effect is exactly the same as that of -@samp{* (@var{section@dots{}})} +@samp{* (@var{section}@dots{})} @item @var{filename}@code{( COMMON )} @itemx ( COMMON ) @@ -2194,7 +2218,7 @@ COFF (the @samp{coff-m68k} variant in BFD), if @var{output-format} is @samp{COFF} @end enumerate -@item LIST @var{@dots{}} +@item LIST @var{anything}@dots{} @cindex @code{LIST} (MRI) Print (to the standard output file) a link map, as produced by the @code{ld} command-line option @samp{-M}. |