?? gcc中文手冊1.htm
字號:
<BR><BR>下面是所有選項的摘要,按類型分組,解釋放在后面的章節中.
<BR><BR>總體選項(Overall Option)
<BR><BR>-c -S -E -o file -pipe -v -x language
<BR>語言選項(Language Option)
<BR>-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
<BR>警告選項(Warning Option)
<BR>-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
<BR>調試選項(Debugging Option)
<BR>-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
<BR>優化選項(Optimization Option)
<BR>-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
<BR>預處理器選項(Preprocessor Option)
<BR>-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
<BR>匯編器選項(Assembler Option) <BR>-Wa,option
<BR>連接器選項(Linker Option)
<BR>-llibrary -nostartfiles -nostdlib -static -shared -symbolic -Xlinker option -Wl,option -u symbol
<BR>目錄選項(Directory Option)
<BR>-Bprefix -Idir -I- -Ldir
<BR>目標機選項(Target Option)
<BR>-b machine -V version
<BR>配置相關選項(Configuration Dependent Option)
<BR>M680x0 選項
<BR>-m68000 -m68020 -m68020-40 -m68030 -m68040 -m68881 -mbitfield -mc68000 -mc68020 -mfpa -mnobitfield -mrtd -mshort -msoft-float
<BR>VAX選項 <BR>-mg -mgnu -munix <BR><BR>SPARC選項
<BR>-mepilogue -mfpu -mhard-float -mno-fpu -mno-epilogue -msoft-float -msparclite -mv8 -msupersparc -mcypress
<BR><BR>Convex選項
<BR>-margcount -mc1 -mc2 -mnoargcount
<BR><BR>AMD29K選項
<BR>-m29000 -m29050 -mbw -mdw -mkernel-registers -mlarge -mnbw -mnodw -msmall -mstack-check -muser-registers
<BR><BR>M88K選項
<BR>-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
<BR><BR>RS6000選項 <BR>-mfp-in-toc -mno-fop-in-toc
<BR><BR>RT選項
<BR>-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
<BR><BR>MIPS選項
<BR>-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
<BR><BR>i386選項
<BR>-m486 -mno-486 -msoft-float -mno-fp-ret-in-387
<BR><BR>HPPA選項
<BR>-mpa-risc-1-0 -mpa-risc-1-1 -mkernel -mshared-libs -mno-shared-libs -mlong-calls -mdisable-fpregs -mdisable-indexing -mtrailing-colon
<BR><BR>i960選項
<BR>-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
<BR><BR>DEC Alpha選項
<BR>-mfp-regs -mno-fp-regs -mno-soft-float -msoft-float
<BR><BR>System V選項
<BR>-G -Qy -Qn -YP,paths -Ym,dir
<BR><BR>代碼生成選項(Code Generation Option)
<BR>-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
<BR><BR> <BR>總體選項(Overall Option)
<BR>-x language
<BR>明確指出后面輸入文件的語言為language (而不是從文件名后綴得到的默認選擇).這個選項應用于后面 所有的輸入文件,直到遇著下一個`-x’選項. language的可選值有`c’, `objective-c’, `c-header’, `c++’, `cpp-output’, `assembler’,和`assembler-with-cpp’.
<BR>-x none
<BR>關閉任何對語種的明確說明,因此依據文件名后綴處理后面的文件(就象是從未使用過`-x’選項).
<BR>如果只操作四個階段(預處理,編譯,匯編,連接)中的一部分,可以使用`-x’選項(或文件名后綴)告訴 gcc從哪里開始,用`-c’, `-S’,或`-E’選項告訴gcc到 哪里結束.注意,某些選項組合(例如, `-x cpp-output -E’)使gcc不作任何事情.
<BR><BR>-c <BR>編譯或匯編源文件,但是不作連接.編譯器輸出對應于源文件的目標文件.
<BR>缺省情況下, GCC通過用`.o’替換源文件名后綴`.c’, `.i’, `.s’,等等,產生目標文件名.可以使用-o選項選擇其他名字.
<BR><BR>GCC忽略-c選項后面任何無法識別的輸入文件(他們不需要編譯或匯編). <BR><BR>-S
<BR>編譯后即停止,不進行匯編.對于每個輸入的非匯編語言文件,輸出文件是匯編語言文件.
<BR>缺省情況下, GCC通過用`.o’替換源文件名后綴`.c’, `.i’,等等,產生 目標文件名.可以使用-o選項選擇其他名字.
<BR><BR>GCC忽略任何不需要編譯的輸入文件. <BR><BR>-E
<BR>預處理后即停止,不進行編譯.預處理后的代碼送往標準輸出. <BR>GCC忽略任何不需要預處理的輸入文件.
<BR><BR>-o file
<BR>指定輸出文件為file.該選項不在乎GCC產生什么輸出,無論是可執行文件,目標文件,匯編文件還是 預處理后的C代碼.
<BR>由于只能指定一個輸出文件,因此編譯多個輸入文件時,使用`-o’選項沒有意義,除非輸出一個可執行文件.
<BR><BR>如果沒有使用`-o’選項,默認的輸出結果是:可執行文件為`a.out’, `source.suffix ’的目標文件是`source.o’,匯編文件是 `source.s’,而預處理后的C源代碼送往標準輸出.
<BR><BR>-v <BR>(在標準錯誤)顯示執行編譯階段的命令.同時顯示編譯器驅動程序,預處理器,編譯器的版本號.
<BR>-pipe
<BR>在編譯過程的不同階段間使用管道而非臨時文件進行通信.這個選項在某些系統上無法工作,因為那些系統的 匯編器不能從管道讀取數據. GNU的匯編器沒有這個問題.
<BR><BR><BR>語言選項(LANGUAGE OPTIONS)
<BR>下列選項控制編譯器能夠接受的C "方言": <BR>-ansi
<BR>支持符合ANSI標準的C程序.
<BR>這樣就會關閉GNU C中某些不兼容ANSI C的特性,例如asm, inline和 typeof關鍵字,以及諸如unix和vax這些表明當前系統類型的預定義宏.同時開啟 不受歡迎和極少使用的ANSI trigraph特性,以及禁止`$’成為標識符的一部分.
<BR><BR><BR>盡管使用了`-ansi’選項,下面這些可選的關鍵字, __asm__, __extension__, __inline__和__typeof__仍然有效.你當然不會把 他們用在ANSI C程序中,但可以把他們放在頭文件里,因為編譯包含這些頭文件的程序時,可能會指定 `-ansi’選項.另外一些預定義宏,如__unix__和__vax__,無論有沒有使用 `-ansi’選項,始終有效.
<BR><BR><BR>使用`-ansi’選項不會自動拒絕編譯非ANSI程序,除非增加`-pedantic’選項作為 `-ansi’選項的補充.
<BR><BR><BR>使用`-ansi’選項的時候,預處理器會預定義一個__STRICT_ANSI__宏.有些頭文件 關注此宏,以避免聲明某些函數,或者避免定義某些宏,這些函數和宏不被ANSI標準調用;這樣就不會干擾在其他地方 使用這些名字的程序了.
<BR><BR><BR>-fno-asm
<BR>不把asm, inline或typeof當作關鍵字,因此這些詞可以用做標識符.用 __asm__, __inline__和__typeof__能夠替代他們. `-ansi’ 隱含聲明了`-fno-asm’.
<BR>-fno-builtin
<BR>不接受不是兩個下劃線開頭的內建函數(built-in function).目前受影響的函數有_exit, abort, abs, alloca, cos, exit, fabs, labs, memcmp, memcpy, sin, sqrt, strcmp, strcpy,和strlen.
<BR>`-ansi’選項能夠阻止alloca和_exit成為內建函數. <BR><BR><BR>-fhosted
<BR>按宿主環境編譯;他隱含聲明了`-fbuiltin’選項,而且警告不正確的main函數聲明.
<BR>-ffreestanding
<BR>按獨立環境編譯;他隱含聲明了`-fno-builtin’選項,而且對main函數沒有特別要求.
<BR>(譯注:宿主環境(hosted environment)下所有的標準庫可用, main函數返回一個int值,典型例子是除了 內核以外幾乎所有的程序.對應的獨立環境(freestanding environment)不存在標準庫,程序入口也不一定是 main,最明顯的例子就是操作系統內核.詳情參考gcc網站最近的資料)
<BR><BR><BR>-fno-strict-prototype
<BR>對于沒有參數的函數聲明,例如`int foo ();’,按C風格處理---即不說明參數個數或類型. (僅針對C++).正常情況下,這樣的函數foo在C++中意味著參數為空.
<BR><BR>-trigraphs
<BR>支持ANSI C trigraphs. `-ansi’選項隱含聲明了`-trigraphs’.
<BR><BR>-traditional
<BR>試圖支持傳統C編譯器的某些方面.詳見GNU C手冊,我們已經把細節清單從這里刪除,這樣當內容過時后,人們也不會 埋怨我們.
<BR>除了一件事:對于C++程序(不是C), `-traditional’選項帶來一個附加效應,允許對 this賦值.他和`-fthis-is-variable’選項的效果一樣.
<BR><BR><BR>-traditional-cpp
<BR>試圖支持傳統C預處理器的某些方面.特別是上面提到有關預處理器的內容,但是不包括 `-traditional’選項的其他效應.
<BR><BR>-fdollars-in-identifiers
<BR>允許在標識符(identifier)中使用`$’字符(僅針對C++).你可以指定 `-fno-dollars-in-identifiers’選項顯明禁止使用`$’符. (GNU C++在某些 目標系統缺省允許`$’符,但不是所有系統.)
<BR><BR>-fenum-int-equiv
<BR>允許int類型到枚舉類型(enumeration)的隱式轉換(僅限于C++).正常情況下GNU C++允許從 enum到int的轉換,反之則不行.
<BR><BR>-fexternal-templates
<BR>為模板聲明(template declaration)產生較小的代碼(僅限于C++),方法是對于每個模板函數 (template function),只在定義他們的地方生成一個副本.想要成功使用這個選項,你必須在所有使用模板的 文件中,標記`#pragma implementation’ (定義)或`#pragma interface’ (聲明).
<BR>當程序用`-fexternal-templates’編譯時,模板實例(template instantiation) 全部是外部類型.你必須讓需要的實例在實現文件中出現.可以通過typedef實現這一點,他引用所需的每個 實例.相對應的,如果編譯時使用缺省選項`-fno-external-templates’,所有模板實例明確的設為內置.
<BR><BR><BR>-fall-virtual
<BR>所有可能的成員函數默認為虛函數.所有的成員函數(除了構造子函數和new或delete 成員操作符)視為所在類的虛函數.
<BR>這不表明每次調用成員函數都將通過內部虛函數表.有些情況下,編譯器能夠判斷出可以直接調用某個虛函數;這時就 直接調用.
<BR><BR><BR>-fcond-mismatch
<BR>允許條件表達式的第二和第三個參數的類型不匹配.這種表達式的值是void.
<BR><BR>-fthis-is-variable
<BR>允許對this賦值(僅對C++).合并用戶自定義的自由存儲管理機制到C++后,使可賦值的 `this’顯得不合時宜.因此,默認情況下,類成員函數內部對this賦值是無效操作.然而為了 向后兼容,你可以通過`-fthis-is-variable’選項使這種操作有效.
<BR><BR>-funsigned-char
<BR>把char定義為無符號類型,如同unsigned char.
<BR>各種機器都有自己缺省的char類型.既可能是unsigned char也可能是signed char .
<BR><BR>理想情況下,當依賴于數據的符號性時,一個可移植程序總是應該使用signed char或unsigned char.但是許多程序已經寫成只用簡單的char,并且期待這是有符號數(或者無符號數,具體情況取決于 編寫程序的目標機器).這個選項,和它的反義選項,使那樣的程序工作在對應的默認值上.
<BR><BR>char的類型始終應該明確定義為signed char或unsigned char,即使 它表現的和其中之一完全一樣.
<BR><BR><BR>-fsigned-char
<BR>把char定義為有符號類型,如同signed char.
<BR>這個選項等同于`-fno-unsigned-char’,他是the negative form of `-funsigned-char’的相反選項.同樣, `-fno-signed-char’等價于 `-funsigned-char’.
<BR><BR><BR>-fsigned-bitfields <BR>-funsigned-bitfields
<BR>-fno-signed-bitfields <BR>-fno-unsigned-bitfields
<BR>如果沒有明確聲明`signed’或`unsigned’修飾符,這些選項用來定義有符號位域 (bitfield)或無符號位域.缺省情況下,位域是有符號的,因為他們繼承的基本整數類型,如int,是 有符號數.
<BR>然而,如果指定了`-traditional’選項,位域永遠是無符號數.
<BR><BR><BR>-fwritable-strings
<BR>把字符串常量存儲到可寫數據段,而且不做特別對待.這是為了兼容一些老程序,他們假設字符串常量是可寫的. `-traditional’選項也有相同效果.
<BR>篡改字符串常量是一個非常糟糕的想法; ``常量’’就應該是常量. <BR><BR><BR>
<BR>預處理器選項(Preprocessor Option)
<BR>下列選項針對C預處理器,預處理器用在正式編譯以前,對C 源文件進行某種處理.
<BR>如果指定了`-E’選項, GCC只進行預處理工作.下面的某些選項必須和`-E’選項一起才 有意義,因為他們的輸出結果不能用于編譯.
<BR><BR><BR>-include file
<BR>在處理常規輸入文件之前,首先處理文件file,其結果是,文件file的內容先得到編譯. 命令行上任何`-D’和`-U’選項永遠在`-include file’之前處理, 無論他們在命令行上的順序如何.然而`-include’和`-imacros’選項按書寫順序處理.
<BR><BR>-imacros file
<BR>在處理常規輸入文件之前,首先處理文件file,但是忽略輸出結果.由于丟棄了文件file的 輸出內容, `-imacros file’選項的唯一效果就是使文件file中的宏定義生效, 可以用于其他輸入文件.在處理`-imacrosfile’選項之前,預處理器首先處理`-D’ 和`-U’選項,并不在乎他們在命令行上的順序.然而`-include’和 `-imacros’選項按書寫順序處理.
<BR><BR>-idirafter dir
<BR>把目錄dir添加到第二包含路徑中.如果某個頭文件在主包含路徑(用`-I’添加的路徑)中沒有 找到,預處理器就搜索第二包含路徑.
<BR><BR>-iprefix prefix
<BR>指定prefix作為后續`-iwithprefix’選項的前綴.
<BR><BR>-iwithprefix dir
<BR>把目錄添加到第二包含路徑中.目錄名由prefix和dir合并而成,這里 prefix被先前的`-iprefix’選項指定.
<BR><BR>-nostdinc
<BR>不要在標準系統目錄中尋找頭文件.只搜索`-I’選項指定的目錄(以及當前目錄,如果合適).
<BR>結合使用`-nostdinc’和`-I-’選項,你可以把包含文件搜索限制在顯式指定的目錄.
<BR><BR><BR>-nostdinc++
<BR>不要在C++專用標準目錄中尋找頭文件,但是仍然搜索其他標準目錄. (當建立`libg++’時使用 這個選項.)
<BR>-undef <BR>不要預定義任何非標準宏. (包括系統結構標志). <BR><BR>-E
<BR>僅運行C預處理器.預處理所有指定的C源文件,結果送往標準輸出或指定的輸出文件. <BR><BR>-C
<BR>告訴預處理器不要丟棄注釋.配合`-E’選項使用. <BR><BR>-P
<BR>告訴預處理器不要產生`#line’命令.配合`-E’選項使用.
<BR><BR>-M [ -MG ]
<BR>告訴預處理器輸出一個適合make的規則,用于描述各目標文件的依賴關系.對于每個源文件,預處理器輸出 一個make規則,該規則的目標項(target)是源文件對應的目標文件名,依賴項(dependency)是源文件中 `#include引用的所有文件.生成的規則可以是單行,但如果太長,就用`\’-換行符續成多行.規則 顯示在標準輸出,不產生預處理過的C程序.
<BR>`-M’隱含了`-E’選項.
<BR><BR>`-MG’要求把缺失的頭文件按存在對待,并且假定他們和源程序文件在同一目錄下.必須和 `-M’選項一起用.
<BR><BR><BR>-MM [ -MG ]
<BR>和`-M’選項類似,但是輸出結果僅涉及用戶頭文件,象這樣`#include file"’.忽略系統頭文件如`#include <file>’.
<BR><BR>-MD
<BR>和`-M’選項類似,但是把依賴信息輸出在文件中,文件名通過把輸出文件名末尾的`.o’替換為 `.d’產生.同時繼續指定的編譯工作---`-MD’不象`-M’那樣阻止正常的編譯任務.
<BR>Mach的實用工具`md’能夠合并`.d’文件,產生適用于`make’命令的單一的 依賴文件.
<BR><BR><BR>-MMD <BR>和`-MD’選項類似,但是輸出結果僅涉及用戶頭文件,忽略系統頭文件.
<BR><BR>-H <BR>除了其他普通的操作, GCC顯示引用過的頭文件名.
<BR><BR>-Aquestion(answer)
<BR>如果預處理器做條件測試,如`#if #question(answer)’,該選項可以斷言(Assert) question的答案是answer. -A-’關閉一般用于描述目標機的標準斷言.
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -