Documenting -rdynamic

Wolfgang Bangerth bangerth@ices.utexas.edu
Thu Jul 7 20:26:00 GMT 2005


As some software archaeologists found out for me on gcc@gcc.gnu.org, the 
-rdynamic flag has gone undocumented for more than 10 years now after Richard 
Kenner added it initially. Let's change this.

The following patch adds some documentation to invoke.texi. It survived a full 
bootstrap on my x86 linux machine.

Best
  Wolfgang

Index: ChangeLog
===================================================================
RCS file: /cvsroot/gcc/gcc/gcc/ChangeLog,v
retrieving revision 2.9373
diff -c -r2.9373 ChangeLog
*** ChangeLog	7 Jul 2005 14:29:18 -0000	2.9373
--- ChangeLog	7 Jul 2005 20:12:58 -0000
***************
*** 1,3 ****
--- 1,7 ----
+ 2005-07-07  Wolfgang Bangerth <bangerth@dealii.org>
+ 
+ 	* doc/invoke.texi: Document -rdynamic.
+ 
  2005-07-07  David Edelsohn  <edelsohn@gnu.org>
  
  	* config/rs6000/rs6000.md (UNSPEC_SYNC, UNSPEC_SYNC_OP,
Index: doc/invoke.texi
===================================================================
RCS file: /cvsroot/gcc/gcc/gcc/doc/invoke.texi,v
retrieving revision 1.643
diff -c -r1.643 invoke.texi
*** doc/invoke.texi	7 Jul 2005 10:25:32 -0000	1.643
--- doc/invoke.texi	7 Jul 2005 20:12:59 -0000
***************
*** 361,367 ****
  @item Linker Options
  @xref{Link Options,,Options for Linking}.
  @gccoptlist{@var{object-file-name}  -l@var{library} @gol
! -nostartfiles  -nodefaultlibs  -nostdlib -pie @gol
  -s  -static  -static-libgcc  -shared  -shared-libgcc  -symbolic @gol
  -Wl,@var{option}  -Xlinker @var{option} @gol
  -u @var{symbol}}
--- 361,367 ----
  @item Linker Options
  @xref{Link Options,,Options for Linking}.
  @gccoptlist{@var{object-file-name}  -l@var{library} @gol
! -nostartfiles  -nodefaultlibs  -nostdlib -pie -rdynamic @gol
  -s  -static  -static-libgcc  -shared  -shared-libgcc  -symbolic @gol
  -Wl,@var{option}  -Xlinker @var{option} @gol
  -u @var{symbol}}
***************
*** 6158,6163 ****
--- 6158,6170 ----
  that were used to generate code (@option{-fpie}, @option{-fPIE},
  or model suboptions) when you specify this option.
  
+ @item -rdynamic
+ @opindex rdynamic
+ Pass the flag @option{-export-dynamic} to the ELF linker. This instructs
+ the linker to add all symbols, not only used ones, to the dynamic
+ symbol table. This option is needed for some uses of @code{dlopen} or
+ to allow obtaining backtraces from within a program.
+ 
  @item -s
  @opindex s
  Remove all symbol table and relocation information from the executable.

 
-------------------------------------------------------------------------
Wolfgang Bangerth              email:            bangerth@ices.utexas.edu
                               www: http://www.ices.utexas.edu/~bangerth/



More information about the Gcc-patches mailing list