This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Documenting -rdynamic
- From: Wolfgang Bangerth <bangerth at ices dot utexas dot edu>
- To: gcc-patches at gcc dot gnu dot org
- Cc: kenner at vlsi1 dot ultra dot nyu dot edu
- Date: Thu, 7 Jul 2005 15:25:50 -0500
- Subject: Documenting -rdynamic
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/