Linker documentation patch

Nick Clifton nickc@cygnus.com
Sat Apr 1 00:00:00 GMT 2000


Hi Guys,

  I have applied the following supplimental patch to my previous patch
  updating the linker documentation.  This patch adds a note that
  other (non-GNU) compiler drivers may not use -Wl, as the linker
  command line option prefix.

  It also fixes a error in the documentation of the -n command line
  switch.  This option does not mark the text section as read-only.
  (It is marked as such by default, and the -N option can be used to
  make it read-write, but -n will not set it back to being
  read-only).   What it does do, however, is to turn off page
  alignment of the sections, so I have added this to the
  documentation.

Cheers
	Nick

2000-01-07  Nick Clifton  <nickc@cygnus.com>

	* ld.texinfo (Options): Remind users to preceed linker command
	line switches with -Wl, (or whatever is appropriate) if it is
	being invoked by a comnpiler driver program.
	Fix description of the behaviour of the -n command line switch. 

Index: ld.texinfo
===================================================================
RCS file: /cvs/binutils/binutils/ld/ld.texinfo,v
retrieving revision 1.9
diff -p -r1.9 ld.texinfo
*** ld.texinfo	2000/01/07 19:06:46	1.9
--- ld.texinfo	2000/01/07 19:34:02
*************** of multiple-letter options are accepted.
*** 230,236 ****
  
  Note - if the linker is being invoked indirectly, via a compiler driver
  (eg @samp{gcc}) then all the linker command line options should be
! prefixed by @samp{-Wl,}  like this:
  
  @smallexample
    gcc -Wl,--startgroup foo.o bar.o -Wl,--endgroup
--- 230,237 ----
  
  Note - if the linker is being invoked indirectly, via a compiler driver
  (eg @samp{gcc}) then all the linker command line options should be
! prefixed by @samp{-Wl,} (or whatever is appropriate for the particular
! compiler driver) like this:
  
  @smallexample
    gcc -Wl,--startgroup foo.o bar.o -Wl,--endgroup
*************** which caused the archive member to be br
*** 558,565 ****
  @kindex --nmagic
  @item -n
  @itemx --nmagic
! Set the text segment to be read only, and mark the output as
! @code{NMAGIC} if possible.
  
  @kindex -N
  @kindex --omagic
--- 559,566 ----
  @kindex --nmagic
  @item -n
  @itemx --nmagic
! Turn off page alignment of sections, and mark the output as
! @code{NMAGIC} if possible. 
  
  @kindex -N
  @kindex --omagic


More information about the Binutils mailing list