gcc.hlp

gcc帮助文档！对linux c/c++开发大有帮助！

	   -mno-complex-addr  -mno-leaf-procedures -mno-old-align
	   -mno-strict-align  -mno-tail-call -mnumerics	 -mold-align
	   -msoft-float	 -mstrict-align -mtail-call

	   DEC Alpha Options

	   -mno-fp-regs	 -msoft-float  -malpha-as  -mgas -mieee
	   -mieee-with-inexact	-mieee-conformant -mfp-trap-mode=mode
	   -mfp-rounding-mode=mode -mtrap-precision=mode  -mbuild-constants
	   -mcpu=cpu-type  -mtune=cpu-type -mbwx  -mmax	 -mfix	-mcix
	   -mfloat-vax	-mfloat-ieee -mexplicit-relocs	-msmall-data
	   -mlarge-data -mmemory-latency=time

	   DEC Alpha/VMS Options

	   -mvms-return-codes

	   Clipper Options

	   -mc300  -mc400

	   H8/300 Options

	   -mrelax  -mh	 -ms  -mint32  -malign-300

	   SH Options

	   -m1	-m2  -m3  -m3e -m4-nofpu  -m4-single-only  -m4-single  -m4
	   -m5-64media -m5-64media-nofpu -m5-32media -m5-32media-nofpu
	   -m5-compact -m5-compact-nofpu -mb  -ml  -mdalign  -mrelax
	   -mbigtable  -mfmovd	-mhitachi  -mnomacsave -mieee  -misize	-mpad-
	   struct  -mspace -mprefergot	-musermode

	   System V Options

	   -Qy	-Qn  -YP,paths	-Ym,dir

	   ARC Options

	   -EB	-EL -mmangle-cpu  -mcpu=cpu  -mtext=text-section -mdata=data-
	   section  -mrodata=readonly-data-section

	   TMS320C3x/C4x Options

	   -mcpu=cpu  -mbig  -msmall  -mregparm	 -mmemparm -mfast-fix  -mmpyi
	   -mbk	 -mti  -mdp-isr-reload -mrpts=count  -mrptb  -mdb
	   -mloop-unsigned -mparallel-insns  -mparallel-mpy  -mpreserve-float

	   V850 Options

	   -mlong-calls	 -mno-long-calls  -mep	-mno-ep -mprolog-function
	   -mno-prolog-function	 -mspace -mtda=n  -msda=n  -mzda=n -mv850
	   -mbig-switch

	   NS32K Options

	   -m32032  -m32332  -m32532  -m32081  -m32381 -mmult-add  -mno-
	   mult-add  -msoft-float  -mrtd  -mnortd -mregparam  -mnoregparam
	   -msb	 -mnosb -mbitfield  -mnobitfield  -mhimem  -mnohimem

	   AVR Options

	   -mmcu=mcu  -msize  -minit-stack=n  -mno-interrupts -mcall-prologues
	   -mno-tablejump  -mtiny-stack

	   MCore Options

	   -mhardlit  -mno-hardlit  -mdiv  -mno-div  -mrelax-immediates
	   -mno-relax-immediates  -mwide-bitfields  -mno-wide-bitfields
	   -m4byte-functions  -mno-4byte-functions  -mcallgraph-data
	   -mno-callgraph-data	-mslow-bytes  -mno-slow-bytes  -mno-lsim
	   -mlittle-endian  -mbig-endian  -m210	 -m340	-mstack-increment

	   MMIX Options

	   -mlibfuncs -mno-libfuncs -mepsilon -mno-epsilon -mabi=gnu
	   -mabi=mmixware -mzero-extend -mknuthdiv -mtoplevel-symbols -melf
	   -mbranch-predict -mno-branch-predict -mbase-addresses
	   -mno-base-addresses

	   IA-64 Options

	   -mbig-endian	 -mlittle-endian  -mgnu-as  -mgnu-ld  -mno-pic
	   -mvolatile-asm-stop	-mb-step  -mregister-names  -mno-sdata -mcon-
	   stant-gp  -mauto-pic	 -minline-divide-min-latency
	   -minline-divide-max-throughput  -mno-dwarf2-asm -mfixed-range=reg-
	   ister-range

	   D30V Options

	   -mextmem  -mextmemory  -monchip  -mno-asm-optimize -masm-optimize
	   -mbranch-cost=n -mcond-exec=n

	   S/390 and zSeries Options

	   -mhard-float	 -msoft-float  -mbackchain  -mno-backchain
	   -msmall-exec	 -mno-small-exec  -mmvcle -mno-mvcle -m64 -m31 -mdebug
	   -mno-debug

	   CRIS Options

	   -mcpu=cpu -march=cpu -mtune=cpu -mmax-stack-frame=n -melinux-stack-
	   size=n -metrax4 -metrax100 -mpdebug -mcc-init -mno-side-effects
	   -mstack-align -mdata-align -mconst-align -m32-bit -m16-bit -m8-bit
	   -mno-prologue-epilogue -mno-gotplt -melf -maout -melinux -mlinux
	   -sim -sim2

	   PDP-11 Options

	   -mfpu  -msoft-float	-mac0  -mno-ac0	 -m40  -m45  -m10 -mbcopy
	   -mbcopy-builtin  -mint32  -mno-int16 -mint16	 -mno-int32  -mfloat32
	   -mno-float64 -mfloat64  -mno-float32	 -mabshi  -mno-abshi
	   -mbranch-expensive  -mbranch-cheap -msplit  -mno-split  -munix-asm
	   -mdec-asm

	   Xstormy16 Options

	   -msim

	   Xtensa Options

	   -mbig-endian -mlittle-endian -mdensity -mno-density -mmac16
	   -mno-mac16 -mmul16 -mno-mul16 -mmul32 -mno-mul32 -mnsa -mno-nsa
	   -mminmax -mno-minmax -msext -mno-sext -mbooleans -mno-booleans
	   -mhard-float -msoft-float -mfused-madd -mno-fused-madd -mserial-
	   ize-volatile -mno-serialize-volatile -mtext-section-literals
	   -mno-text-section-literals -mtarget-align -mno-target-align -mlong-
	   calls -mno-longcalls

       Code Generation Options
	   -fcall-saved-reg  -fcall-used-reg -ffixed-reg -fexceptions
	   -fnon-call-exceptions  -funwind-tables -fasynchronous-unwind-tables
	   -finhibit-size-directive  -finstrument-functions -fno-common
	   -fno-ident  -fno-gnu-linker -fpcc-struct-return  -fpic  -fPIC -fpie
	   -fPIE -freg-struct-return  -fshared-data  -fshort-enums
	   -fshort-double  -fshort-wchar -fvolatile -fvolatile-global
	   -fvolatile-static -fverbose-asm  -fpack-struct  -fstack-check
	   -fstack-limit-register=reg  -fstack-limit-symbol=sym -fargu-
	   ment-alias  -fargument-noalias -fargument-noalias-global  -flead-
	   ing-underscore -ftls-model=model

       Options Controlling the Kind of Output

       Compilation can involve up to four stages: preprocessing, compilation
       proper, assembly and linking, always in that order.  The first three
       stages apply to an individual source file, and end by producing an
       object file; linking combines all the object files (those newly com-
       piled, and those specified as input) into an executable file.

       For any given input file, the file name suffix determines what kind of
       compilation is done:

       file.c
	   C source code which must be preprocessed.

       file.i
	   C source code which should not be preprocessed.

       file.ii
	   C++ source code which should not be preprocessed.

       file.m
	   Objective-C source code.  Note that you must link with the library
	   libobjc.a to make an Objective-C program work.

       file.mi
	   Objective-C source code which should not be preprocessed.

       file.h
	   C header file (not to be compiled or linked).

       file.cc
       file.cp
       file.cxx
       file.cpp
       file.c++
       file.C
	   C++ source code which must be preprocessed.	Note that in .cxx, the
	   last two letters must both be literally x.  Likewise, .C refers to
	   a literal capital C.

       file.f
       file.for
       file.FOR
	   Fortran source code which should not be preprocessed.

       file.F
       file.fpp
       file.FPP
	   Fortran source code which must be preprocessed (with the tradi-
	   tional preprocessor).

       file.r
	   Fortran source code which must be preprocessed with a RATFOR pre-
	   processor (not included with GCC).

       file.ads
	   Ada source code file which contains a library unit declaration (a
	   declaration of a package, subprogram, or generic, or a generic
	   instantiation), or a library unit renaming declaration (a package,
	   generic, or subprogram renaming declaration).  Such files are also
	   called specs.

       file.adb
	   Ada source code file containing a library unit body (a subprogram
	   or package body).  Such files are also called bodies.

       file.s
	   Assembler code.

       file.S
	   Assembler code which must be preprocessed.

       other
	   An object file to be fed straight into linking.  Any file name with
	   no recognized suffix is treated this way.

       You can specify the input language explicitly with the -x option:

       -x language
	   Specify explicitly the language for the following input files
	   (rather than letting the compiler choose a default based on the
	   file name suffix).  This option applies to all following input
	   files until the next -x option.  Possible values for language are:

		   c  c-header	cpp-output
		   c++	c++-cpp-output
		   objective-c	objc-cpp-output
		   assembler  assembler-with-cpp
		   ada
		   f77	f77-cpp-input  ratfor
		   java

       -x none
	   Turn off any specification of a language, so that subsequent files
	   are handled according to their file name suffixes (as they are if
	   -x has not been used at all).

       -pass-exit-codes
	   Normally the gcc program will exit with the code of 1 if any phase
	   of the compiler returns a non-success return code.  If you specify
	   -pass-exit-codes, the gcc program will instead return with numeri-
	   cally highest error produced by any phase that returned an error
	   indication.

       If you only want some of the stages of compilation, you can use -x (or
       filename suffixes) to tell gcc where to start, and one of the options
       -c, -S, or -E to say where gcc is to stop.  Note that some combinations
       (for example, -x cpp-output -E) instruct gcc to do nothing at all.

       -c  Compile or assemble the source files, but do not link.  The linking
	   stage simply is not done.  The ultimate output is in the form of an
	   object file for each source file.

	   By default, the object file name for a source file is made by
	   replacing the suffix .c, .i, .s, etc., with .o.

	   Unrecognized input files, not requiring compilation or assembly,
	   are ignored.

       -S  Stop after the stage of compilation proper; do not assemble.	 The
	   output is in the form of an assembler code file for each non-assem-
	   bler input file specified.

	   By default, the assembler file name for a source file is made by
	   replacing the suffix .c, .i, etc., with .s.

	   Input files that don't require compilation are ignored.

       -E  Stop after the preprocessing stage; do not run the compiler proper.
	   The output is in the form of preprocessed source code, which is
	   sent to the standard output.

	   Input files which don't require preprocessing are ignored.

       -o file
	   Place output in file file.  This applies regardless to whatever
	   sort of output is being produced, whether it be an executable file,
	   an object file, an assembler file or preprocessed C code.

	   Since only one output file can be specified, it does not make sense
	   to use -o when compiling more than one input file, unless you are
	   producing an executable file as output.

	   If -o is not specified, the default is to put an executable file in
	   a.out, the object file for source.suffix in source.o, its assembler
	   file in source.s, and all preprocessed C source on standard output.

       -v  Print (on standard error output) the commands executed to run the
	   stages of compilation.  Also print the version number of the com-
	   piler driver program and of the preprocessor and the compiler
	   proper.

       -###
	   Like -v except the commands are not executed and all command argu-
	   ments are quoted.  This is useful for shell scripts to capture the
	   driver-generated command lines.

       -pipe
	   Use pipes rather than temporary files for communication between the
	   various stages of compilation.  This fails to work on some systems
	   where the assembler is unable to read from a pipe; but the GNU
	   assembler has no trouble.

       --help
	   Print (on the standard output) a description of the command line
	   options understood by gcc.  If the -v option is also specified then
	   --help will also be passed on to the various processes invoked by
	   gcc, so that they can display the command line options they accept.
	   If the -W option is also specified then command line options which
	   have no documentation associated with them will also be displayed.