gcc.hlp

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

GCC(1)				      GNU				GCC(1)



NAME
       gcc - GNU project C and C++ compiler

SYNOPSIS
       gcc [-c|-S|-E] [-std=standard]
	   [-g] [-pg] [-Olevel]
	   [-Wwarn...] [-pedantic]
	   [-Idir...] [-Ldir...]
	   [-Dmacro[=defn]...] [-Umacro]
	   [-foption...] [-mmachine-option...]
	   [-o outfile] infile...

       Only the most useful options are listed here; see below for the remain-
       der.  g++ accepts mostly the same options as gcc.

DESCRIPTION
       When you invoke GCC, it normally does preprocessing, compilation,
       assembly and linking.  The ``overall options'' allow you to stop this
       process at an intermediate stage.  For example, the -c option says not
       to run the linker.  Then the output consists of object files output by
       the assembler.

       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 docu-
       mented here, since you rarely need to use any of them.

       Most of the command line options that you can use with GCC 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.

       The gcc program accepts options and file names as operands.  Many
       options have multi-letter names; therefore multiple single-letter
       options may not be grouped: -dr is very different from -d -r.

       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 -L more than once, the
       directories are searched in the order specified.

       Many options have long names starting with -f or with -W---for example,
       -fforce-mem, -fstrength-reduce, -Wformat and so on.  Most of these have
       both positive and negative forms; the negative form of -ffoo would be
       -fno-foo.  This manual documents only one of these two forms, whichever
       one is not the default.

OPTIONS
       Option Summary

       Here is a summary of all the options, grouped by type.  Explanations
       are in the following sections.

       Overall Options
	   -c  -S  -E  -o file	-pipe  -pass-exit-codes	 -x language -v	 -###
	   --help  --target-help  --version

       C Language Options
	   -ansi  -std=standard	 -aux-info filename -fno-asm  -fno-builtin
	   -fno-builtin-function -fhosted  -ffreestanding -trigraphs
	   -no-integrated-cpp  -traditional  -traditional-cpp
	   -fallow-single-precision  -fcond-mismatch -fsigned-bitfields
	   -fsigned-char -funsigned-bitfields  -funsigned-char
	   -fwritable-strings

       C++ Language Options
	   -fno-access-control	-fcheck-new  -fconserve-space
	   -fno-const-strings  -fdollars-in-identifiers -fno-elide-construc-
	   tors -fno-enforce-eh-specs  -fexternal-templates -falt-exter-
	   nal-templates -ffor-scope  -fno-for-scope  -fno-gnu-keywords
	   -fno-implicit-templates -fno-implicit-inline-templates -fno-imple-
	   ment-inlines	 -fms-extensions -fno-nonansi-builtins	-fno-opera-
	   tor-names -fno-optional-diags  -fpermissive -frepo  -fno-rtti
	   -fstats  -ftemplate-depth-n -fuse-cxa-atexit	 -fvtable-gc
	   -fno-weak  -nostdinc++ -fno-default-inline -Wabi -Wctor-dtor-pri-
	   vacy -Wnon-virtual-dtor  -Wreorder -Weffc++	-Wno-deprecated
	   -Wno-non-template-friend  -Wold-style-cast -Woverloaded-virtual
	   -Wno-pmf-conversions -Wsign-promo  -Wsynth

       Objective-C Language Options
	   -fconstant-string-class=class-name -fgnu-runtime  -fnext-runtime
	   -gen-decls -Wno-protocol  -Wselector

       Language Independent Options
	   -fmessage-length=n -fdiagnostics-show-location=[once|every-line]

       Warning Options
	   -fsyntax-only  -pedantic  -pedantic-errors -w  -W  -Wall -Waggre-
	   gate-return -Wcast-align  -Wcast-qual  -Wchar-subscripts  -Wcomment
	   -Wconversion	 -Wno-deprecated-declarations -Wdisabled-optimization
	   -Wdiv-by-zero  -Werror -Wfloat-equal	 -Wformat  -Wformat=2 -Wfor-
	   mat-nonliteral  -Wformat-security -Wimplicit	 -Wimplicit-int -Wim-
	   plicit-function-declaration -Werror-implicit-function-declaration
	   -Wimport  -Winline -Wlarger-than-len	 -Wlong-long -Wmain  -Wmiss-
	   ing-braces -Wmissing-format-attribute  -Wmissing-noreturn -Wmulti-
	   char	 -Wno-format-extra-args	 -Wno-format-y2k -Wno-import  -Wpacked
	   -Wpadded -Wparentheses  -Wpointer-arith  -Wredundant-decls -Wre-
	   turn-type  -Wsequence-point	-Wshadow -Wsign-compare	 -Wswitch
	   -Wsystem-headers -Wtrigraphs	 -Wundef  -Wuninitialized -Wun-
	   known-pragmas  -Wunreachable-code -Wunused  -Wunused-function
	   -Wunused-label  -Wunused-parameter -Wunused-value  -Wunused-vari-
	   able	 -Wwrite-strings

       C-only Warning Options
	   -Wbad-function-cast	-Wmissing-declarations -Wmissing-prototypes
	   -Wnested-externs -Wstrict-prototypes	 -Wtraditional -Wdeclara-
	   tion-after-statement

       Debugging Options
	   -dletters  -dumpspecs  -dumpmachine	-dumpversion -fdump-unnumbered
	   -fdump-translation-unit[-n] -fdump-class-hierarchy[-n]
	   -fdump-tree-original[-n] -fdump-tree-optimized[-n]
	   -fdump-tree-inlined[-n] -fmem-report	 -fpretend-float -fpro-
	   file-arcs  -fsched-verbose=n -ftest-coverage	 -ftime-report -g
	   -glevel  -gcoff  -gdwarf  -gdwarf-1	-gdwarf-1+  -gdwarf-2 -ggdb
	   -gstabs  -gstabs+  -gvms  -gxcoff  -gxcoff+ -p  -pg
	   -print-file-name=library  -print-libgcc-file-name
	   -print-multi-directory  -print-multi-lib -print-prog-name=program
	   -print-search-dirs  -Q -feliminate-unused-debug-types -save-temps
	   -time

       Optimization Options
	   -falign-functions=n	-falign-jumps=n -falign-labels=n
	   -falign-loops=n -fbounds-check -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=n
	   -fkeep-inline-functions -fkeep-static-consts	 -fmerge-constants
	   -fmerge-all-constants -fmove-all-movables  -fno-branch-count-reg
	   -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	 -fre-
	   run-loop-opt -fschedule-insns  -fschedule-insns2
	   -fno-sched-interblock  -fno-sched-spec -fsched-spec-load
	   -fsched-spec-load-dangerous -fsingle-precision-constant  -fssa
	   -fssa-ccp -fssa-dce -fstrength-reduce  -fstrict-aliasing
	   -fthread-jumps -ftrapv -funroll-all-loops  -funroll-loops --param
	   name=value -O  -O0  -O1  -O2	 -O3  -Os

       Preprocessor Options
	   -$  -Aquestion=answer  -A-question[=answer] -C  -dD	-dI  -dM  -dN
	   -Dmacro[=defn]  -E  -H -idirafter dir -include file	-imacros file
	   -iprefix file  -iwithprefix dir -iwithprefixbefore dir  -isystem
	   dir -M  -MM	-MF  -MG  -MP  -MQ  -MT	 -nostdinc  -P	-remap -tri-
	   graphs  -undef  -Umacro  -Wp,option

       Assembler Option
	   -Wa,option

       Linker Options
	    object-file-name  -llibrary -nostartfiles  -nodefaultlibs  -nost-
	   dlib -s  -static  -static-libgcc  -shared  -shared-libgcc  -sym-
	   bolic -Wl,option  -Xlinker option -u symbol

       Directory Options
	   -Bprefix  -Idir  -I-	 -Ldir	-specs=file

       Target Options
	   -b machine  -V version

       Machine Dependent Options
	   M680x0 Options

	   -m68000  -m68020  -m68020-40	 -m68020-60  -m68030  -m68040 -m68060
	   -mcpu32  -m5200  -m68881  -mbitfield	 -mc68000  -mc68020 -mfpa
	   -mnobitfield	 -mrtd	-mshort	 -msoft-float  -mpcrel -malign-int
	   -mstrict-align

	   M68hc1x Options

	   -m6811  -m6812  -m68hc11  -m68hc12 -mauto-incdec  -mshort
	   -msoft-reg-count=count

	   VAX Options

	   -mg	-mgnu  -munix

	   SPARC Options

	   -mcpu=cpu-type -mtune=cpu-type -mcmodel=code-model -m32  -m64
	   -mapp-regs  -mbroken-saverestore  -mcypress -mfaster-structs
	   -mflat -mfpu	 -mhard-float  -mhard-quad-float -mimpure-text
	   -mlive-g0  -mno-app-regs -mno-faster-structs	 -mno-flat  -mno-fpu
	   -mno-impure-text  -mno-stack-bias  -mno-unaligned-doubles
	   -msoft-float	 -msoft-quad-float  -msparclite	 -mstack-bias -msuper-
	   sparc  -munaligned-doubles  -mv8

	   Convex Options

	   -mc1	 -mc2  -mc32  -mc34  -mc38 -margcount  -mnoargcount -mlong32
	   -mlong64 -mvolatile-cache  -mvolatile-nocache

	   AMD29K Options

	   -m29000  -m29050  -mbw  -mnbw  -mdw	-mndw -mlarge  -mnormal
	   -msmall -mkernel-registers  -mno-reuse-arg-regs -mno-stack-check
	   -mno-storem-bug -mreuse-arg-regs  -msoft-float  -mstack-check
	   -mstorem-bug	 -muser-registers

	   ARM Options

	   -mapcs-frame	 -mno-apcs-frame -mapcs-26  -mapcs-32
	   -mapcs-stack-check  -mno-apcs-stack-check -mapcs-float
	   -mno-apcs-float -mapcs-reentrant  -mno-apcs-reentrant -msched-pro-
	   log	-mno-sched-prolog -mlittle-endian  -mbig-endian	 -mwords-lit-
	   tle-endian -malignment-traps	 -mno-alignment-traps -msoft-float
	   -mhard-float	 -mfpe -mthumb-interwork  -mno-thumb-interwork
	   -mcpu=name  -march=name  -mfpe=name -mstructure-size-boundary=n
	   -mbsd -mxopen  -mno-symrename -mabort-on-noreturn -mlong-calls
	   -mno-long-calls -msingle-pic-base  -mno-single-pic-base -mpic-reg-
	   ister=reg -mnop-fun-dllimport -mpoke-function-name -mthumb  -marm
	   -mtpcs-frame	 -mtpcs-leaf-frame -mcaller-super-interworking
	   -mcallee-super-interworking

	   MN10200 Options

	   -mrelax

	   MN10300 Options

	   -mmult-bug  -mno-mult-bug -mam33  -mno-am33 -mno-crt0  -mrelax

	   M32R/D Options

	   -m32rx -m32r -mcode-model=model-type	 -msdata=sdata-type -G num

	   M88K Options

	   -m88000  -m88100  -m88110  -mbig-pic -mcheck-zero-division  -mhan-
	   dle-large-shift -midentify-revision	-mno-check-zero-division
	   -mno-ocs-debug-info	-mno-ocs-frame-position -mno-optimize-arg-area
	   -mno-serialize-volatile -mno-underscores  -mocs-debug-info
	   -mocs-frame-position	 -moptimize-arg-area -mserialize-volatile
	   -mshort-data-num  -msvr3 -msvr4  -mtrap-large-shift
	   -muse-div-instruction -mversion-03.00  -mwarn-passed-structs

	   RS/6000 and PowerPC Options

	   -mcpu=cpu-type -mtune=cpu-type -mpower  -mno-power  -mpower2
	   -mno-power2 -mpowerpc  -mpowerpc64  -mno-powerpc -maltivec
	   -mno-altivec -mpowerpc-gpopt	 -mno-powerpc-gpopt -mpowerpc-gfxopt
	   -mno-powerpc-gfxopt -mnew-mnemonics	-mold-mnemonics -mfull-toc
	   -mminimal-toc  -mno-fp-in-toc  -mno-sum-in-toc -m64	-m32
	   -mxl-call  -mno-xl-call  -mpe -msoft-float  -mhard-float  -mmulti-
	   ple	-mno-multiple -mstring	-mno-string  -mupdate  -mno-update
	   -mfused-madd	 -mno-fused-madd  -mbit-align  -mno-bit-align
	   -mstrict-align  -mno-strict-align  -mrelocatable -mno-relocatable
	   -mrelocatable-lib  -mno-relocatable-lib -mtoc  -mno-toc -mlittle
	   -mlittle-endian  -mbig  -mbig-endian -mcall-aix -mcall-sysv
	   -mcall-netbsd -maix-struct-return -msvr4-struct-return
	   -mabi=altivec -mabi=no-altivec -mprototype  -mno-prototype -msim
	   -mmvme  -mads  -myellowknife	 -memb -msdata -msdata=opt  -mvxworks
	   -G num -pthread

	   RT Options

	   -mcall-lib-mul  -mfp-arg-in-fpregs  -mfp-arg-in-gregs
	   -mfull-fp-blocks  -mhc-struct-return	 -min-line-mul -mmini-
	   mum-fp-blocks  -mnohc-struct-return

	   MIPS Options

	   -mabicalls -march=cpu-type -mtune=cpu=type -mcpu=cpu-type -membed-
	   ded-data  -muninit-const-in-rodata -membedded-pic  -mfp32  -mfp64
	   -mfused-madd	 -mno-fused-madd -mgas	-mgp32	-mgp64 -mgpopt
	   -mhalf-pic  -mhard-float  -mint64  -mips1 -mips2  -mips3  -mips4
	   -mlong64  -mlong32  -mlong-calls  -mmemcpy -mmips-as	 -mmips-tfile
	   -mno-abicalls -mno-embedded-data  -mno-uninit-const-in-rodata
	   -mno-embedded-pic  -mno-gpopt  -mno-long-calls -mno-memcpy
	   -mno-mips-tfile  -mno-rnames	 -mno-stats -mrnames  -msoft-float
	   -m4650  -msingle-float  -mmad -mstats  -EL  -EB  -G num  -nocpp
	   -mabi=32  -mabi=n32	-mabi=64  -mabi=eabi -mfix7000	-mno-crt0
	   -mflush-func=func -mno-flush-func

	   i386 and x86-64 Options

	   -mcpu=cpu-type  -march=cpu-type -mfpmath=unit -masm=dialect
	   -mno-fancy-math-387 -mno-fp-ret-in-387  -msoft-float	 -msvr3-shlib
	   -mno-wide-multiply  -mrtd  -malign-double -mpreferred-stack-bound-
	   ary=num -mmmx  -msse -msse2 -m3dnow -mthreads  -mno-align-stringops
	   -minline-all-stringops -mpush-args  -maccumulate-outgoing-args
	   -m128bit-long-double -m96bit-long-double  -mregparm=num
	   -momit-leaf-frame-pointer -mno-red-zone -mcmodel=code-model -m32
	   -m64

	   HPPA Options

	   -march=architecture-type -mbig-switch  -mdisable-fpregs  -mdis-
	   able-indexing -mfast-indirect-calls	-mgas  -mjump-in-delay
	   -mlong-load-store  -mno-big-switch  -mno-disable-fpregs -mno-dis-
	   able-indexing  -mno-fast-indirect-calls  -mno-gas
	   -mno-jump-in-delay  -mno-long-load-store -mno-portable-runtime
	   -mno-soft-float -mno-space-regs  -msoft-float  -mpa-risc-1-0
	   -mpa-risc-1-1  -mpa-risc-2-0	 -mportable-runtime -mschedule=cpu-
	   type	 -mspace-regs

	   Intel 960 Options

	   -mcpu-type  -masm-compat  -mclean-linkage -mcode-align  -mcom-
	   plex-addr  -mleaf-procedures -mic-compat  -mic2.0-compat
	   -mic3.0-compat -mintel-asm  -mno-clean-linkage  -mno-code-align