xscale_be-gcc.1

Intel ixp425 toolchain

.\" Automatically generated by Pod::Man version 1.15
.\" Wed Aug 14 09:36:36 2002
.\"
.\" Standard preamble:
.\" ======================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R

.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used
.\" to do unbreakable dashes and therefore won't be available.  \*(C` and
.\" \*(C' expand to `' in nroff, nothing in troff, for use with C<>
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr
.\" for titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and
.\" index entries marked with X<> in POD.  Of course, you'll have to process
.\" the output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it
.\" makes way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.bd B 3
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ======================================================================
.\"
.IX Title "GCC 1"
.TH GCC 1 "gcc-3.2" "2002-08-14" "GNU"
.UC
.SH "NAME"
gcc \- \s-1GNU\s0 project C and \*(C+ compiler
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
gcc [\fB\-c\fR|\fB\-S\fR|\fB\-E\fR] [\fB\-std=\fR\fIstandard\fR]
    [\fB\-g\fR] [\fB\-pg\fR] [\fB\-O\fR\fIlevel\fR]
    [\fB\-W\fR\fIwarn\fR...] [\fB\-pedantic\fR]
    [\fB\-I\fR\fIdir\fR...] [\fB\-L\fR\fIdir\fR...]
    [\fB\-D\fR\fImacro\fR[=\fIdefn\fR]...] [\fB\-U\fR\fImacro\fR]
    [\fB\-f\fR\fIoption\fR...] [\fB\-m\fR\fImachine-option\fR...]
    [\fB\-o\fR \fIoutfile\fR] \fIinfile\fR...
.PP
Only the most useful options are listed here; see below for the
remainder.  \fBg++\fR accepts mostly the same options as \fBgcc\fR.
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
When you invoke \s-1GCC\s0, it normally does preprocessing, compilation,
assembly and linking.  The ``overall options'' allow you to stop this
process at an intermediate stage.  For example, the \fB\-c\fR option
says not to run the linker.  Then the output consists of object files
output by the assembler.
.PP
Other options are passed on to one stage of processing.  Some options
control the preprocessor and others the compiler itself.  Yet other
options control the assembler and linker; most of these are not
documented here, since you rarely need to use any of them.
.PP
Most of the command line options that you can use with \s-1GCC\s0 are useful
for C programs; when an option is only useful with another language
(usually \*(C+), the explanation says so explicitly.  If the description
for a particular option does not mention a source language, you can use
that option with all supported languages.
.PP
The \fBgcc\fR program accepts options and file names as operands.  Many
options have multi-letter names; therefore multiple single-letter options
may \fInot\fR be grouped: \fB\-dr\fR is very different from \fB\-d\ \-r\fR.
.PP
You can mix options and other arguments.  For the most part, the order
you use doesn't matter.  Order does matter when you use several options
of the same kind; for example, if you specify \fB\-L\fR more than once,
the directories are searched in the order specified.
.PP
Many options have long names starting with \fB\-f\fR or with
\&\fB\-W\fR\-\-\-for example, \fB\-fforce-mem\fR,
\&\fB\-fstrength-reduce\fR, \fB\-Wformat\fR and so on.  Most of
these have both positive and negative forms; the negative form of
\&\fB\-ffoo\fR would be \fB\-fno-foo\fR.  This manual documents
only one of these two forms, whichever one is not the default.
.SH "OPTIONS"
.IX Header "OPTIONS"
.Sh "Option Summary"
.IX Subsection "Option Summary"
Here is a summary of all the options, grouped by type.  Explanations are
in the following sections.
.Ip "\fIOverall Options\fR" 4
.IX Item "Overall Options"
\&\fB\-c  \-S  \-E  \-o\fR \fIfile\fR  \fB\-pipe  \-pass-exit-codes  \-x\fR \fIlanguage\fR 
\&\fB\-v  \-###  \-\-target-help  \-\-help\fR
.Ip "\fIC Language Options\fR" 4
.IX Item "C Language Options"
\&\fB\-ansi  \-std=\fR\fIstandard\fR  \fB\-aux-info\fR \fIfilename\fR 
\&\fB\-fno-asm  \-fno-builtin \-fno-builtin-\fR\fIfunction\fR 
\&\fB\-fhosted  \-ffreestanding 
\&\-trigraphs  \-no-integrated-cpp  \-traditional  \-traditional-cpp 
\&\-fallow-single-precision  \-fcond-mismatch 
\&\-fsigned-bitfields  \-fsigned-char 
\&\-funsigned-bitfields  \-funsigned-char 
\&\-fwritable-strings  \-fshort-wchar\fR
.Ip "\fI\*(C+ Language Options\fR" 4
.IX Item " Language Options"
\&\fB\-fno-access-control  \-fcheck-new  \-fconserve-space 
\&\-fno-const-strings  \-fdollars-in-identifiers 
\&\-fno-elide-constructors 
\&\-fno-enforce-eh-specs  \-fexternal-templates 
\&\-falt-external-templates 
\&\-ffor-scope  \-fno-for-scope  \-fno-gnu-keywords 
\&\-fno-implicit-templates 
\&\-fno-implicit-inline-templates 
\&\-fno-implement-inlines  \-fms-extensions 
\&\-fno-nonansi-builtins  \-fno-operator-names 
\&\-fno-optional-diags  \-fpermissive 
\&\-frepo  \-fno-rtti  \-fstats  \-ftemplate-depth-\fR\fIn\fR 
\&\fB\-fuse-cxa-atexit  \-fvtable-gc  \-fno-weak  \-nostdinc++ 
\&\-fno-default-inline  \-Wctor-dtor-privacy 
\&\-Wnon-virtual-dtor  \-Wreorder 
\&\-Weffc++  \-Wno-deprecated 
\&\-Wno-non-template-friend  \-Wold-style-cast 
\&\-Woverloaded-virtual  \-Wno-pmf-conversions 
\&\-Wsign-promo  \-Wsynth\fR
.Ip "\fIObjective-C Language Options\fR" 4
.IX Item "Objective-C Language Options"
\&\fB\-fconstant-string-class=\fR\fIclass-name\fR 
\&\fB\-fgnu-runtime  \-fnext-runtime  \-gen-decls 
\&\-Wno-protocol  \-Wselector\fR
.Ip "\fILanguage Independent Options\fR" 4
.IX Item "Language Independent Options"
\&\fB\-fmessage-length=\fR\fIn\fR  
\&\fB\-fdiagnostics-show-location=\fR[\fBonce\fR|\fBevery-line\fR]
.Ip "\fIWarning Options\fR" 4
.IX Item "Warning Options"
\&\fB\-fsyntax-only  \-pedantic  \-pedantic-errors 
\&\-w  \-W  \-Wall  \-Waggregate-return 
\&\-Wcast-align  \-Wcast-qual  \-Wchar-subscripts  \-Wcomment 
\&\-Wconversion  \-Wno-deprecated-declarations 
\&\-Wdisabled-optimization  \-Wdiv-by-zero  \-Werror 
\&\-Wfloat-equal  \-Wformat  \-Wformat=2 
\&\-Wformat-nonliteral  \-Wformat-security 
\&\-Wimplicit  \-Wimplicit-int  
\&\-Wimplicit-function-declaration 
\&\-Werror-implicit-function-declaration 
\&\-Wimport  \-Winline 
\&\-Wlarger-than-\fR\fIlen\fR  \fB\-Wlong-long 
\&\-Wmain  \-Wmissing-braces  \-Wmissing-declarations 
\&\-Wmissing-format-attribute  \-Wmissing-noreturn 
\&\-Wmultichar  \-Wno-format-extra-args  \-Wno-format-y2k 
\&\-Wno-import  \-Wpacked  \-Wpadded 
\&\-Wparentheses  \-Wpointer-arith  \-Wredundant-decls 
\&\-Wreturn-type  \-Wsequence-point  \-Wshadow 
\&\-Wsign-compare  \-Wswitch  \-Wsystem-headers 
\&\-Wtrigraphs  \-Wundef  \-Wuninitialized 
\&\-Wunknown-pragmas  \-Wunreachable-code 
\&\-Wunused  \-Wunused-function  \-Wunused-label  \-Wunused-parameter 
\&\-Wunused-value  \-Wunused-variable  \-Wwrite-strings\fR
.Ip "\fIC-only Warning Options\fR" 4
.IX Item "C-only Warning Options"
\&\fB\-Wbad-function-cast  \-Wmissing-prototypes  \-Wnested-externs 
\&\-Wstrict-prototypes  \-Wtraditional\fR
.Ip "\fIDebugging Options\fR" 4
.IX Item "Debugging Options"
\&\fB\-d\fR\fIletters\fR  \fB\-dumpspecs  \-dumpmachine  \-dumpversion 
\&\-fdump-unnumbered \-fdump-translation-unit\fR[\fB-\fR\fIn\fR] 
\&\fB\-fdump-class-hierarchy\fR[\fB-\fR\fIn\fR] 
\&\fB\-fdump-tree-original\fR[\fB-\fR\fIn\fR] \fB\-fdump-tree-optimized\fR[\fB-\fR\fIn\fR] 
\&\fB\-fdump-tree-inlined\fR[\fB-\fR\fIn\fR] 
\&\fB\-fmem-report  \-fpretend-float 
\&\-fprofile-arcs  \-ftest-coverage  \-ftime-report 
\&\-g  \-g\fR\fIlevel\fR  \fB\-gcoff  \-gdwarf  \-gdwarf-1  \-gdwarf-1+  \-gdwarf-2 
\&\-ggdb  \-gstabs  \-gstabs+  \-gvms  \-gxcoff  \-gxcoff+ 
\&\-p  \-pg  \-print-file-name=\fR\fIlibrary\fR  \fB\-print-libgcc-file-name 
\&\-print-multi-directory  \-print-multi-lib 
\&\-print-prog-name=\fR\fIprogram\fR  \fB\-print-search-dirs  \-Q 
\&\-save-temps  \-time\fR
.Ip "\fIOptimization Options\fR" 4
.IX Item "Optimization Options"
\&\fB\-falign-functions=\fR\fIn\fR  \fB\-falign-jumps=\fR\fIn\fR 
\&\fB\-falign-labels=\fR\fIn\fR  \fB\-falign-loops=\fR\fIn\fR  
\&\fB\-fbranch-probabilities  \-fcaller-saves \-fcprop-registers 
\&\-fcse-follow-jumps  \-fcse-skip-blocks  \-fdata-sections 
\&\-fdelayed-branch  \-fdelete-null-pointer-checks 
\&\-fexpensive-optimizations  \-ffast-math  \-ffloat-store 
\&\-fforce-addr  \-fforce-mem  \-ffunction-sections 
\&\-fgcse  \-fgcse-lm  \-fgcse-sm 
\&\-finline-functions  \-finline-limit=\fR\fIn\fR  \fB\-fkeep-inline-functions 
\&\-fkeep-static-consts  \-fmerge-constants  \-fmerge-all-constants 
\&\-fmove-all-movables  \-fno-default-inline  \-fno-defer-pop 
\&\-fno-function-cse  \-fno-guess-branch-probability 
\&\-fno-inline  \-fno-math-errno  \-fno-peephole  \-fno-peephole2 
\&\-funsafe-math-optimizations \-fno-trapping-math 
\&\-fomit-frame-pointer  \-foptimize-register-move 
\&\-foptimize-sibling-calls  \-fprefetch-loop-arrays 
\&\-freduce-all-givs \-fregmove  \-frename-registers 
\&\-frerun-cse-after-loop  \-frerun-loop-opt 
\&\-fschedule-insns  \-fschedule-insns2 
\&\-fsingle-precision-constant  \-fssa \-fssa-ccp \-fssa-dce 
\&\-fstrength-reduce  \-fstrict-aliasing  \-fthread-jumps  \-ftrapv 
\&\-funroll-all-loops  \-funroll-loops  
\&\-\-param\fR \fIname\fR\fB=\fR\fIvalue\fR
\&\fB\-O  \-O0  \-O1  \-O2  \-O3  \-Os\fR
.Ip "\fIPreprocessor Options\fR" 4