GCC 1

NAME

總覽(SYNOPSIS)

警告(WARNING)

除非有人自愿維護,否則本手冊頁不再更新.如果發現手冊頁和軟件之間有所矛盾,請查對Info文件, Info文件是權威文檔.

如果我們發覺本手冊頁的內容由于過時而導致明顯的混亂和抱怨時,我們就停止發布它.不可能有其他選擇,象更新Info文件同時更新man手冊,因為其他維護GNU CC的工作沒有留給我們時間做這個. GNU工程認為man手冊是過時產物,應該把時間用到別的地方.

如果需要完整和最新的文檔,請查閱Info文件`gcc'或Using and Porting GNU CC (for version 2.0) (使用和移植GNU CC 2.0) 手冊.二者均來自Texinfo原文件 gcc.texinfo.

描述(DESCRIPTION)

gcc

認為預處理后的文件(.i)是C文件,并且設定C形式的連接.

g++

認為預處理后的文件(.i)是C++文件,并且設定C++形式的連接.

源文件后綴名指出語言種類以及后期的操作:

.c      C源程序;預處理,編譯,匯編
.C      C++源程序;預處理,編譯,匯編
.cc     C++源程序;預處理,編譯,匯編
.cxx    C++源程序;預處理,編譯,匯編
.m      Objective-C源程序;預處理,編譯,匯編
.i     預處理后的C文件;編譯,匯編
.ii    預處理后的C++文件;編譯,匯編
.s     匯編語言源程序;匯編
.S     匯編語言源程序;預處理,匯編
.h     預處理器文件;通常不出現在命令行上

.o     目標文件(Object file)
.a     歸檔庫文件(Archive file)

除非使用了-c, -S,或-E選項(或者編譯錯誤阻止了完整的過程),否則連接總是 最后的步驟.在連接階段中,所有對應于源程序的.o文件, -l庫文件,無法識別的文件名(包括指定的 .o目標文件和.a庫文件)按命令行中的順序傳遞給連接器.

選項(OPTIONS)

大多數`-f'和`-W'選項有兩個相反的格式: -fname和 -fno-name (或-Wname和-Wno-name).這里 只列舉不是默認選項的格式.

下面是所有選項的摘要,按類型分組,解釋放在后面的章節中.

總體選項(Overall Option)

-c -S -E -o file -pipe -v -x language

語言選項(Language Option)

-ansi -fall-virtual -fcond-mismatch -fdollars-in-identifiers -fenum-int-equiv -fexternal-templates -fno-asm -fno-builtin -fhosted -fno-hosted -ffreestanding -fno-freestanding -fno-strict-prototype -fsigned-bitfields -fsigned-char -fthis-is-variable -funsigned-bitfields -funsigned-char -fwritable-strings -traditional -traditional-cpp -trigraphs

警告選項(Warning Option)

-fsyntax-only -pedantic -pedantic-errors -w -W -Wall -Waggregate-return -Wcast-align -Wcast-qual -Wchar-subscript -Wcomment -Wconversion -Wenum-clash -Werror -Wformat -Wid-clash-len -Wimplicit -Wimplicit-int -Wimplicit-function-declaration -Winline -Wlong-long -Wmain -Wmissing-prototypes -Wmissing-declarations -Wnested-externs -Wno-import -Wparentheses -Wpointer-arith -Wredundant-decls -Wreturn-type -Wshadow -Wstrict-prototypes -Wswitch -Wtemplate-debugging -Wtraditional -Wtrigraphs -Wuninitialized -Wunused -Wwrite-strings

調試選項(Debugging Option)

-a -dletters -fpretend-float -g -glevel -gcoff -gxcoff -gxcoff+ -gdwarf -gdwarf+ -gstabs -gstabs+ -ggdb -p -pg -save-temps -print-file-name=library -print-libgcc-file-name -print-prog-name=program

優化選項(Optimization Option)

-fcaller-saves -fcse-follow-jumps -fcse-skip-blocks -fdelayed-branch -felide-constructors -fexpensive-optimizations -ffast-math -ffloat-store -fforce-addr -fforce-mem -finline-functions -fkeep-inline-functions -fmemoize-lookups -fno-default-inline -fno-defer-pop -fno-function-cse -fno-inline -fno-peephole -fomit-frame-pointer -frerun-cse-after-loop -fschedule-insns -fschedule-insns2 -fstrength-reduce -fthread-jumps -funroll-all-loops -funroll-loops -O -O2 -O3

預處理器選項(Preprocessor Option)

-Aassertion -C -dD -dM -dN -Dmacro[=defn] -E -H -idirafter dir -include file -imacros file -iprefix file -iwithprefix dir -M -MD -MM -MMD -nostdinc -P -Umacro -undef

匯編器選項(Assembler Option)

-Wa,option

連接器選項(Linker Option)

-llibrary -nostartfiles -nostdlib -static -shared -symbolic -Xlinker option -Wl,option -u symbol

目錄選項(Directory Option)

-Bprefix -Idir -I- -Ldir

目標機選項(Target Option)

-b machine -V version

配置相關選項(Configuration Dependent Option)

M680x0 選項
-m68000 -m68020 -m68020-40 -m68030 -m68040 -m68881 -mbitfield -mc68000 -mc68020 -mfpa -mnobitfield -mrtd -mshort -msoft-float

VAX選項
-mg -mgnu -munix

SPARC選項
-mepilogue -mfpu -mhard-float -mno-fpu -mno-epilogue -msoft-float -msparclite -mv8 -msupersparc -mcypress

Convex選項
-margcount -mc1 -mc2 -mnoargcount

AMD29K選項
-m29000 -m29050 -mbw -mdw -mkernel-registers -mlarge -mnbw -mnodw -msmall -mstack-check -muser-registers

M88K選項
-m88000 -m88100 -m88110 -mbig-pic -mcheck-zero-division -mhandle-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

RS6000選項
-mfp-in-toc -mno-fop-in-toc

RT選項
-mcall-lib-mul -mfp-arg-in-fpregs -mfp-arg-in-gregs -mfull-fp-blocks -mhc-struct-return -min-line-mul -mminimum-fp-blocks -mnohc-struct-return

MIPS選項
-mcpu=cpu type -mips2 -mips3 -mint64 -mlong64 -mmips-as -mgas -mrnames -mno-rnames -mgpopt -mno-gpopt -mstats -mno-stats -mmemcpy -mno-memcpy -mno-mips-tfile -mmips-tfile -msoft-float -mhard-float -mabicalls -mno-abicalls -mhalf-pic -mno-half-pic -G num -nocpp

i386選項
-m486 -mno-486 -msoft-float -mno-fp-ret-in-387

HPPA選項
-mpa-risc-1-0 -mpa-risc-1-1 -mkernel -mshared-libs -mno-shared-libs -mlong-calls -mdisable-fpregs -mdisable-indexing -mtrailing-colon

i960選項
-mcpu-type -mnumerics -msoft-float -mleaf-procedures -mno-leaf-procedures -mtail-call -mno-tail-call -mcomplex-addr -mno-complex-addr -mcode-align -mno-code-align -mic-compat -mic2.0-compat -mic3.0-compat -masm-compat -mintel-asm -mstrict-align -mno-strict-align -mold-align -mno-old-align

DEC Alpha選項
-mfp-regs -mno-fp-regs -mno-soft-float -msoft-float

System V選項
-G -Qy -Qn -YP,paths -Ym,dir

代碼生成選項(Code Generation Option)

-fcall-saved-reg -fcall-used-reg -ffixed-reg -finhibit-size-directive -fnonnull-objects -fno-common -fno-ident -fno-gnu-linker -fpcc-struct-return -fpic -fPIC -freg-struct-return -fshared-data -fshort-enums -fshort-double -fvolatile -fvolatile-global -fverbose-asm

 

總體選項(Overall Option)

-x language

明確指出后面輸入文件的語言為language (而不是從文件名后綴得到的默認選擇).這個選項應用于后面 所有的輸入文件,直到遇著下一個`-x'選項. language的可選值有`c', `objective-c', `c-header', `c++', `cpp-output', `assembler',和`assembler-with-cpp'.

-x none

關閉任何對語種的明確說明,因此依據文件名后綴處理后面的文件(就象是從未使用過`-x'選項).

如果只操作四個階段(預處理,編譯,匯編,連接)中的一部分,可以使用`-x'選項(或文件名后綴)告訴 gcc從哪里開始,用`-c', `-S',或`-E'選項告訴gcc到 哪里結束.注意,某些選項組合(例如, `-x cpp-output -E')使gcc不作任何事情.

-c

編譯或匯編源文件,但是不作連接.編譯器輸出對應于源文件的目標文件.

缺省情況下, GCC通過用`.o'替換源文件名后綴`.c', `.i', `.s',等等,產生目標文件名.可以使用-o選項選擇其他名字.

GCC忽略-c選項后面任何無法識別的輸入文件(他們不需要編譯或匯編).

-S

編譯后即停止,不進行匯編.對于每個輸入的非匯編語言文件,輸出文件是匯編語言文件.

缺省情況下, GCC通過用`.o'替換源文件名后綴`.c', `.i',等等,產生 目標文件名.可以使用-o選項選擇其他名字.

GCC忽略任何不需要編譯的輸入文件.

-E

預處理后即停止,不進行編譯.預處理后的代碼送往標準輸出.

GCC忽略任何不需要預處理的輸入文件.

-o file

指定輸出文件為file.該選項不在乎GCC產生什么輸出,無論是可執行文件,目標文件,匯編文件還是 預處理后的C代碼.

由于只能指定一個輸出文件,因此編譯多個輸入文件時,使用`-o'選項沒有意義,除非輸出一個可執行文件.

如果沒有使用`-o'選項,默認的輸出結果是:可執行文件為`a.out', `source.suffix '的目標文件是`source.o',匯編文件是 `source.s',而預處理后的C源代碼送往標準輸出.

-v

(在標準錯誤)顯示執行編譯階段的命令.同時顯示編譯器驅動程序,預處理器,編譯器的版本號.

-pipe

在編譯過程的不同階段間使用管道而非臨時文件進行通信.這個選項在某些系統上無法工作,因為那些系統的 匯編器不能從管道讀取數據. GNU的匯編器沒有這個問題.

語言選項(LANGUAGE OPTIONS)

-ansi

支持符合ANSI標準的C程序.

這樣就會關閉GNU C中某些不兼容ANSI C的特性,例如asm, inline和 typeof關鍵字,以及諸如unix和vax這些表明當前系統類型的預定義宏.同時開啟 不受歡迎和極少使用的ANSI trigraph特性,以及禁止`$'成為標識符的一部分.

盡管使用了`-ansi'選項,下面這些可選的關鍵字, __asm__, __extension__, __inline__和__typeof__仍然有效.你當然不會把 他們用在ANSI C程序中,但可以把他們放在頭文件里,因為編譯包含這些頭文件的程序時,可能會指定 `-ansi'選項.另外一些預定義宏,如__unix__和__vax__,無論有沒有使用 `-ansi'選項,始終有效.

使用`-ansi'選項不會自動拒絕編譯非ANSI程序,除非增加`-pedantic'選項作為 `-ansi'選項的補充.

使用`-ansi'選項的時候,預處理器會預定義一個__STRICT_ANSI__宏.有些頭文件 關注此宏,以避免聲明某些函數,或者避免定義某些宏,這些函數和宏不被ANSI標準調用;這樣就不會干擾在其他地方 使用這些名字的程序了.

 

-fno-asm

不把asm, inline或typeof當作關鍵字,因此這些詞可以用做標識符.用 __asm__, __inline__和__typeof__能夠替代他們. `-ansi' 隱含聲明了`-fno-asm'.

-fno-builtin

不接受不是兩個下劃線開頭的內建函數(built-in function).目前受影響的函數有_exit, abort, abs, alloca, cos, exit, fabs, labs, memcmp, memcpy, sin, sqrt, strcmp, strcpy,和strlen.

`-ansi'選項能夠阻止alloca和_exit成為內建函數.

 

-fhosted

按宿主環境編譯;他隱含聲明了`-fbuiltin'選項,而且警告不正確的main函數聲明.

-ffreestanding

按獨立環境編譯;他隱含聲明了`-fno-builtin'選項,而且對main函數沒有特別要求.

(譯注:宿主環境(hosted environment)下所有的標準庫可用, main函數返回一個int值,典型例子是除了 內核以外幾乎所有的程序.對應的獨立環境(freestanding environment)不存在標準庫,程序入口也不一定是 main,最明顯的例子就是操作系統內核.詳情參考gcc網站最近的資料)

 

-fno-strict-prototype

對于沒有參數的函數聲明,例如`int foo ();',按C風格處理---即不說明參數個數或類型. (僅針對C++).正常情況下,這樣的函數foo在C++中意味著參數為空.

 

-trigraphs

支持ANSI C trigraphs. `-ansi'選項隱含聲明了`-trigraphs'.

 

-traditional

試圖支持傳統C編譯器的某些方面.詳見GNU C手冊,我們已經把細節清單從這里刪除,這樣當內容過時后,人們也不會 埋怨我們.

除了一件事:對于C++程序(不是C), `-traditional'選項帶來一個附加效應,允許對 this賦值.他和`-fthis-is-variable'選項的效果一樣.

 

-traditional-cpp

試圖支持傳統C預處理器的某些方面.特別是上面提到有關預處理器的內容,但是不包括 `-traditional'選項的其他效應.

 

-fdollars-in-identifiers

允許在標識符(identifier)中使用`$'字符(僅針對C++).你可以指定 `-fno-dollars-in-identifiers'選項顯明禁止使用`$'符. (GNU C++在某些 目標系統缺省允許`$'符,但不是所有系統.)

 

-fenum-int-equiv

允許int類型到枚舉類型(enumeration)的隱式轉換(僅限于C++).正常情況下GNU C++允許從 enum到int的轉換,反之則不行.

 

-fexternal-templates

為模板聲明(template declaration)產生較小的代碼(僅限于C++),方法是對于每個模板函數 (template function),只在定義他們的地方生成一個副本.想要成功使用這個選項,你必須在所有使用模板的 文件中,標記`#pragma implementation' (定義)或`#pragma interface' (聲明).

當程序用`-fexternal-templates'編譯時,模板實例(template instantiation) 全部是外部類型.你必須讓需要的實例在實現文件中出現.可以通過typedef實現這一點,他引用所需的每個 實例.相對應的,如果編譯時使用缺省選項`-fno-external-templates',所有模板實例明確的設為內置.

 

-fall-virtual

所有可能的成員函數默認為虛函數.所有的成員函數(除了構造子函數和new或delete 成員操作符)視為所在類的虛函數.

這不表明每次調用成員函數都將通過內部虛函數表.有些情況下,編譯器能夠判斷出可以直接調用某個虛函數;這時就 直接調用.

 

-fcond-mismatch

允許條件表達式的第二和第三個參數的類型不匹配.這種表達式的值是void.

 

-fthis-is-variable

允許對this賦值(僅對C++).合并用戶自定義的自由存儲管理機制到C++后,使可賦值的 `this'顯得不合時宜.因此,默認情況下,類成員函數內部對this賦值是無效操作.然而為了 向后兼容,你可以通過`-fthis-is-variable'選項使這種操作有效.

 

-funsigned-char

把char定義為無符號類型,如同unsigned char.

各種機器都有自己缺省的char類型.既可能是unsigned char也可能是signed char .

理想情況下,當依賴于數據的符號性時,一個可移植程序總是應該使用signed char或unsigned char.但是許多程序已經寫成只用簡單的char,并且期待這是有符號數(或者無符號數,具體情況取決于 編寫程序的目標機器).這個選項,和它的反義選項,使那樣的程序工作在對應的默認值上.

char的類型始終應該明確定義為signed char或unsigned char,即使 它表現的和其中之一完全一樣.

 

-fsigned-char

把char定義為有符號類型,如同signed char.

這個選項等同于`-fno-unsigned-char',他是the negative form of `-funsigned-char'的相反選項.同樣, `-fno-signed-char'等價于 `-funsigned-char'.

 

-fsigned-bitfields

-funsigned-bitfields

-fno-signed-bitfields

-fno-unsigned-bitfields

如果沒有明確聲明`signed'或`unsigned'修飾符,這些選項用來定義有符號位域 (bitfield)或無符號位域.缺省情況下,位域是有符號的,因為他們繼承的基本整數類型,如int,是 有符號數.

然而,如果指定了`-traditional'選項,位域永遠是無符號數.

 

-fwritable-strings

把字符串常量存儲到可寫數據段,而且不做特別對待.這是為了兼容一些老程序,他們假設字符串常量是可寫的. `-traditional'選項也有相同效果.

篡改字符串常量是一個非常糟糕的想法; ``常量''就應該是常量.