匯編器選項(xiàng)(ASSEMBLER OPTION)

-Wa,option

把選項(xiàng)option傳遞給匯編器.如果option含有逗號(hào),就在逗號(hào)處分割成多個(gè)選項(xiàng).

 

連接器選項(xiàng)(LINKER OPTION)

object-file-name

如果某些文件沒(méi)有特別明確的后綴a special recognized suffix, GCC就認(rèn)為他們是目標(biāo)文件或庫(kù)文件. (根據(jù)文件內(nèi)容,連接器能夠區(qū)分目標(biāo)文件和庫(kù)文件).如果GCC執(zhí)行連接操作,這些目標(biāo)文件將成為連接器的輸入文件.

 

-llibrary

連接名為library的庫(kù)文件.

連接器在標(biāo)準(zhǔn)搜索目錄中尋找這個(gè)庫(kù)文件,庫(kù)文件的真正名字是`liblibrary.a'.連接器會(huì) 當(dāng)做文件名得到準(zhǔn)確說(shuō)明一樣引用這個(gè)文件.

搜索目錄除了一些系統(tǒng)標(biāo)準(zhǔn)目錄外,還包括用戶以`-L'選項(xiàng)指定的路徑.

一般說(shuō)來(lái)用這個(gè)方法找到的文件是庫(kù)文件---即由目標(biāo)文件組成的歸檔文件(archive file).連接器處理歸檔文件的 方法是:掃描歸檔文件,尋找某些成員,這些成員的符號(hào)目前已被引用,不過(guò)還沒(méi)有被定義.但是,如果連接器找到普通的 目標(biāo)文件,而不是庫(kù)文件,就把這個(gè)目標(biāo)文件按平常方式連接進(jìn)來(lái).指定`-l'選項(xiàng)和指定文件名的唯一區(qū)別是, `-l選項(xiàng)用`lib'和`.a'把library包裹起來(lái),而且搜索一些目錄.

 

-lobjc

這個(gè)-l選項(xiàng)的特殊形式用于連接Objective C程序.

 

-nostartfiles

不連接系統(tǒng)標(biāo)準(zhǔn)啟動(dòng)文件,而標(biāo)準(zhǔn)庫(kù)文件仍然正常使用.

 

-nostdlib

不連接系統(tǒng)標(biāo)準(zhǔn)啟動(dòng)文件和標(biāo)準(zhǔn)庫(kù)文件.只把指定的文件傳遞給連接器.

 

-static

在支持動(dòng)態(tài)連接(dynamic linking)的系統(tǒng)上,阻止連接共享庫(kù).該選項(xiàng)在其他系統(tǒng)上無(wú)效.

 

-shared

生成一個(gè)共享目標(biāo)文件,他可以和其他目標(biāo)文件連接產(chǎn)生可執(zhí)行文件.只有部分系統(tǒng)支持該選項(xiàng).

 

-symbolic

建立共享目標(biāo)文件的時(shí)候,把引用綁定到全局符號(hào)上.對(duì)所有無(wú)法解析的引用作出警告(除非用連接編輯選項(xiàng) `-Xlinker -z -Xlinker defs'取代).只有部分系統(tǒng)支持該選項(xiàng).

 

-Xlinker option

把選項(xiàng)option傳遞給連接器.可以用他傳遞系統(tǒng)特定的連接選項(xiàng), GNU CC無(wú)法識(shí)別這些選項(xiàng).

如果需要傳遞攜帶參數(shù)的選項(xiàng),你必須使用兩次`-Xlinker',一次傳遞選項(xiàng),另一次傳遞他的參數(shù). 例如,如果傳遞`-assert definitions',你必須寫成`-Xlinker -assert -Xlinker definitions',而不能寫成`-Xlinker "-assert definitions"',因?yàn)檫@樣會(huì)把整個(gè) 字符串當(dāng)做一個(gè)參數(shù)傳遞,顯然這不是連接器期待的.

 

-Wl,option

把選項(xiàng)option傳遞給連接器.如果option中含有逗號(hào),就在逗號(hào)處分割成多個(gè)選項(xiàng).

 

-u symbol

使連接器認(rèn)為取消了symbol的符號(hào)定義,從而連接庫(kù)模塊以取得定義.你可以使用多個(gè) `-u'選項(xiàng),各自跟上不同的符號(hào),使得連接器調(diào)入附加的庫(kù)模塊.

 

目錄選項(xiàng)(DIRECTORY OPTION)

-Idir

在頭文件的搜索路徑列表中添加dir 目錄.

 

-I-

任何在`-I-'前面用`-I'選項(xiàng)指定的搜索路徑只適用于`#include "file"'這種情況;他們不能用來(lái)搜索`#include <file>'包含的頭文件.

如果用`-I'選項(xiàng)指定的搜索路徑位于`-I-'選項(xiàng)后面,就可以在這些路徑中搜索所有的 `#include'指令. (一般說(shuō)來(lái)-I選項(xiàng)就是這么用的.)

還有, `-I-'選項(xiàng)能夠阻止當(dāng)前目錄(存放當(dāng)前輸入文件的地方)成為搜索`#include "file"'的第一選擇.沒(méi)有辦法克服`-I-'選項(xiàng)的這個(gè)效應(yīng).你可以指定 `-I.'搜索那個(gè)目錄,它在調(diào)用編譯器時(shí)是當(dāng)前目錄.這和預(yù)處理器的默認(rèn)行為不完全一樣,但是結(jié)果通常 令人滿意.

`-I-'不影響使用系統(tǒng)標(biāo)準(zhǔn)目錄,因此, `-I-'和`-nostdinc'是不同的選項(xiàng).

 

-Ldir

在`-l'選項(xiàng)的搜索路徑列表中添加dir目錄.

 

-Bprefix

這個(gè)選項(xiàng)指出在何處尋找可執(zhí)行文件,庫(kù)文件,以及編譯器自己的數(shù)據(jù)文件.

編譯器驅(qū)動(dòng)程序需要執(zhí)行某些下面的子程序: `cpp', `cc1' (或C++的 `cc1plus'), `as'和`ld'.他把prefix當(dāng)作欲執(zhí)行的程序的 前綴,既可以包括也可以不包括`machine/version/'.

對(duì)于要運(yùn)行的子程序,編譯器驅(qū)動(dòng)程序首先試著加上`-B'前綴(如果存在).如果沒(méi)有找到文件,或沒(méi)有指定 `-B'選項(xiàng),編譯器接著會(huì)試驗(yàn)兩個(gè)標(biāo)準(zhǔn)前綴`/usr/lib/gcc/'和 `/usr/local/lib/gcc-lib/'.如果仍然沒(méi)能夠找到所需文件,編譯器就在`PATH'環(huán)境變量 指定的路徑中尋找沒(méi)加任何前綴的文件名.

如果有需要,運(yùn)行時(shí)(run-time)支持文件`libgcc.a'也在`-B'前綴的搜索范圍之內(nèi). 如果這里沒(méi)有找到,就在上面提到的兩個(gè)標(biāo)準(zhǔn)前綴中尋找,僅此而已.如果上述方法沒(méi)有找到這個(gè)文件,就不連接他了.多數(shù) 情況的多數(shù)機(jī)器上, `libgcc.a'并非必不可少.

你可以通過(guò)環(huán)境變量GCC_EXEC_PREFIX獲得近似的效果;如果定義了這個(gè)變量,其值就和上面說(shuō)的 一樣用做前綴.如果同時(shí)指定了`-B'選項(xiàng)和GCC_EXEC_PREFIX變量,編譯器首先使用 `-B'選項(xiàng),然后才嘗試環(huán)境變量值.

 

警告選項(xiàng)(WARNING OPTION)

下列選項(xiàng)控制GNU CC產(chǎn)生的警告的數(shù)量和類型:

-fsyntax-only

檢查程序中的語(yǔ)法錯(cuò)誤,但是不產(chǎn)生輸出信息.

-w

禁止所有警告信息.

-Wno-import

禁止所有關(guān)于#import的警告信息.

-pedantic

打開(kāi)完全服從ANSI C標(biāo)準(zhǔn)所需的全部警告診斷;拒絕接受采用了被禁止的語(yǔ)法擴(kuò)展的程序.

無(wú)論有沒(méi)有這個(gè)選項(xiàng),符合ANSI C標(biāo)準(zhǔn)的程序應(yīng)該能夠被正確編譯(雖然極少數(shù)程序需要`-ansi' 選項(xiàng)).然而,如果沒(méi)有這個(gè)選項(xiàng),某些GNU擴(kuò)展和傳統(tǒng)C特性也得到支持.使用這個(gè)選項(xiàng)可以拒絕這些程序.沒(méi)有理由 使用這個(gè)選項(xiàng),他存在只是為了滿足一些書呆子(pedant).

對(duì)于替選關(guān)鍵字(他們以`__'開(kāi)始和結(jié)束) `-pedantic'不會(huì)產(chǎn)生警告信息. Pedantic 也不警告跟在__extension__后面的表達(dá)式.不過(guò)只應(yīng)該在系統(tǒng)頭文件中使用這種轉(zhuǎn)義措施,應(yīng)用程序最好 避免.

-pedantic-errors

該選項(xiàng)和`-pedantic'類似,但是顯示錯(cuò)誤而不是警告.

-W

對(duì)下列事件顯示額外的警告信息:

   *

非易變自動(dòng)變量(nonvolatile automatic variable)可能在調(diào)用longjmp時(shí)發(fā)生改變. 這些警告僅在優(yōu)化編譯時(shí)發(fā)生.

編譯器只知道對(duì)setjmp的調(diào)用,他不可能知道會(huì)在哪里調(diào)用longjmp,事實(shí)上一個(gè) 信號(hào)處理例程可以在程序的任何地點(diǎn)調(diào)用他.其結(jié)果是,即使程序沒(méi)有問(wèn)題,你也可能會(huì)得到警告,因?yàn)闊o(wú)法在可能出現(xiàn)問(wèn)題 的地方調(diào)用longjmp.

 

   *

既可以返回值,也可以不返回值的函數(shù). (缺少結(jié)尾的函數(shù)體被看作不返回函數(shù)值)例如,下面的函數(shù)將導(dǎo)致這種警告:

foo (a)
{
if (a > 0)
return a;
}

由于GNU CC不知道某些函數(shù)永不返回(含有abort和longjmp),因此有可能出現(xiàn) 虛假警告.

 

   *

表達(dá)式語(yǔ)句或逗號(hào)表達(dá)式的左側(cè)沒(méi)有產(chǎn)生作用(side effect).如果要防止這種警告,應(yīng)該把未使用的表達(dá)式強(qiáng)制轉(zhuǎn)換 為void類型.例如,這樣的表達(dá)式`x[i,j]'會(huì)導(dǎo)致警告,而`x[(void)i,j]'就不會(huì).

 

   *

無(wú)符號(hào)數(shù)用`>'或`<='和零做比較.

-Wimplicit-int

警告沒(méi)有指定類型的聲明.

 

-Wimplicit-function-declaration

警告在聲明之前就使用的函數(shù).

 

-Wimplicit

同-Wimplicit-int和-Wimplicit-function-declaration.

 

-Wmain

如果把main函數(shù)聲明或定義成奇怪的類型,編譯器就發(fā)出警告.典型情況下,這個(gè)函數(shù)用于外部連接, 返回int數(shù)值,不需要參數(shù),或指定兩個(gè)參數(shù).

 

-Wreturn-type

如果函數(shù)定義了返回類型,而默認(rèn)類型是int型,編譯器就發(fā)出警告.同時(shí)警告那些不帶返回值的 return語(yǔ)句,如果他們所屬的函數(shù)并非void類型.

 

-Wunused

如果某個(gè)局部變量除了聲明就沒(méi)再使用,或者聲明了靜態(tài)函數(shù)但是沒(méi)有定義,或者某條語(yǔ)句的運(yùn)算結(jié)果顯然沒(méi)有使用, 編譯器就發(fā)出警告.

 

-Wswitch

如果某條switch語(yǔ)句的參數(shù)屬于枚舉類型,但是沒(méi)有對(duì)應(yīng)的case語(yǔ)句使用枚舉元素,編譯器 就發(fā)出警告. ( default語(yǔ)句的出現(xiàn)能夠防止這個(gè)警告.)超出枚舉范圍的case語(yǔ)句同樣會(huì) 導(dǎo)致這個(gè)警告.

 

-Wcomment

如果注釋起始序列`/*'出現(xiàn)在注釋中,編譯器就發(fā)出警告.

 

-Wtrigraphs

警告任何出現(xiàn)的trigraph (假設(shè)允許使用他們).

 

-Wformat

檢查對(duì)printf和scanf等函數(shù)的調(diào)用,確認(rèn)各個(gè)參數(shù)類型和格式串中的一致.

 

-Wchar-subscripts

警告類型是char的數(shù)組下標(biāo).這是常見(jiàn)錯(cuò)誤,程序員經(jīng)常忘記在某些機(jī)器上char有符號(hào).

 

-Wuninitialized

在初始化之前就使用自動(dòng)變量.

這些警告只可能做優(yōu)化編譯時(shí)出現(xiàn),因?yàn)樗麄冃枰獢?shù)據(jù)流信息,只有做優(yōu)化的時(shí)候才估算數(shù)據(jù)流信息.如果不指定 `-O'選項(xiàng),就不會(huì)出現(xiàn)這些警告.

這些警告僅針對(duì)等候分配寄存器的變量.因此不會(huì)發(fā)生在聲明為volatile的變量上面,不會(huì)發(fā)生在已經(jīng) 取得地址的變量,或長(zhǎng)度不等于1, 2, 4, 8字節(jié)的變量.同樣也不會(huì)發(fā)生在結(jié)構(gòu),聯(lián)合或數(shù)組上面,即使他們?cè)?寄存器中.

注意,如果某個(gè)變量只計(jì)算了一個(gè)從未使用過(guò)的值,這里可能不會(huì)警告.因?yàn)樵陲@示警告之前,這樣的計(jì)算已經(jīng)被 數(shù)據(jù)流分析刪除了.

這些警告作為可選項(xiàng)是因?yàn)?/font>GNU CC還沒(méi)有智能到判別所有的情況,知道有些看上去錯(cuò)誤的代碼其實(shí)是正確的.下面是 一個(gè)這樣的例子:

{
int x;
switch (y)
{
case 1: x = 1;
break;
case 2: x = 4;
break;
case 3: x = 5;
}
foo (x);
}

如果y始終是1, 2或3,那么x總會(huì)被初始化,但是GNU CC不知道這一點(diǎn).下面是 另一個(gè)普遍案例:

{
int save_y;
if (change_y) save_y = y, y = new_y;
...
if (change_y) y = save_y;
}

這里沒(méi)有錯(cuò)誤,因?yàn)橹挥性O(shè)置了save_y才使用他.

把所有不返回的函數(shù)定義為volatile可以避免某些似是而非的警告.

 

-Wparentheses

在某些情況下如果忽略了括號(hào),編譯器就發(fā)出警告.

 

-Wtemplate-debugging

當(dāng)在C++程序中使用template的時(shí)候,如果調(diào)試(debugging)沒(méi)有完全生效,編譯器就發(fā)出警告. (僅用于C++).

 

-Wall

結(jié)合所有上述的`-W'選項(xiàng).通常我們建議避免這些被警告的用法，我們相信,恰當(dāng)結(jié)合宏的使用能夠 輕易避免這些用法。