[VxWorks] Document VxWorks-specific options

Richard Sandiford richard@codesourcery.com
Mon Mar 12 11:35:00 GMT 2007

This patch documents the VxWorks-specific gcc options.  OK to install?

(There is precedent for having both OS-specific and processor-specific
options in the target list; we do the same for System V.)


	* doc/invoke.texi: Document VxWorks options.

Index: gcc/doc/invoke.texi
--- gcc/doc/invoke.texi	(revision 122836)
+++ gcc/doc/invoke.texi	(working copy)
@@ -770,6 +770,10 @@ See RS/6000 and PowerPC Options.
 @emph{VAX Options}
 @gccoptlist{-mg  -mgnu  -munix}
+@emph{VxWorks Options}
+@gccoptlist{-mrtp  -non-static  -Bstatic  -Bdynamic @gol
+-Xbind-lazy  -Xbind-now}
 @emph{x86-64 Options}
 See i386 and x86-64 Options.
@@ -7746,6 +7750,7 @@ platform.
 * TMS320C3x/C4x Options::
 * V850 Options::
 * VAX Options::
+* VxWorks Options::
 * x86-64 Options::
 * Xstormy16 Options::
 * Xtensa Options::
@@ -13794,6 +13799,46 @@ will assemble with the GNU assembler.
 Output code for g-format floating point numbers instead of d-format.
 @end table
+@node VxWorks Options
+@subsection VxWorks Options
+@cindex VxWorks Options
+The options in this section are defined for all VxWorks targets.
+Options specific to the target hardware are listed with the other
+options for that target.
+@table @gcctabopt
+@item -mrtp
+@opindex mrtp
+GCC can generate code for both VxWorks kernels and real time processes
+(RTPs).  This option switches from the former to the latter.  It also
+defines the preprocessor macro @code{__RTP__}.
+@item -non-static
+@opindex non-static
+Link an RTP executable against shared libraries rather than static
+libraries.  The options @option{-static} and @option{-shared} can
+also be used for RTPs (@pxref{Link Options}); @option{-static}
+is the default.
+@item -Bstatic
+@itemx -Bdynamic
+@opindex Bstatic
+@opindex Bdynamic
+These options are passed down to the linker.  They are defined for
+compatibility with Diab.
+@item -Xbind-lazy
+@opindex Xbind-lazy
+Enable lazy binding of function calls.  This option is equivalent to
+@option{-Wl,-z,now} and is defined for compatibility with Diab.
+@itemx -Xbind-now
+@opindex Xbind-now
+Disable lazy binding of function calls.  This option is the default and
+is defined for compatibility with Diab.
+@end table
 @node x86-64 Options
 @subsection x86-64 Options
 @cindex x86-64 options

More information about the Gcc-patches mailing list