ar

下面是ar命令的格式：

ar [-]{dmpqrtx}[abcfilNoPsSuvV] [membername] [count] archive files...

例如我們可以用ar rv libtest.a hello.o hello1.o來生成一個庫，庫名字是test，鏈接時可以用-ltest鏈接。該庫中存放了兩個模塊hello.o和hello1.o。選項前可以有‘-’字元，也可以沒有。下面我們來看看命令的操作選項和任選項。現在我們把{dmpqrtx}部分稱為操作選項，而[abcfilNoPsSuvV]部分稱為任選項。

{dmpqrtx}中的操作選項在命令中只能並且必須使用其中一個，它們的含義如下：

d：從庫中刪除模塊。按模塊原來的文件名指定要刪除的模塊。如果使用了任選項v則列出被刪除的每個模塊。

m：該操作是在一個庫中移動成員。當庫中如果有若干模塊有相同的符號定義(如函數定義)，則成員的位置順序很重要。如果沒有指定任選項，任何指定的成員將移到庫的最後。也可以使用’a’，’b’，或’I’任選項移動到指定的位置。

p：顯示庫中指定的成員到標準輸出。如果指定任選項v，則在輸出成員的內容前，將顯示成員的名字。如果沒有指定成員的名字，所有庫中的文件將顯示出來。

q：快速追加。增加新模塊到庫的結尾處。並不檢查是否需要替換。’a’，’b’，或’I’任選項對此操作沒有影響，模塊總是追加的庫的結尾處。如果使用了任選項v則列出每個模塊。這時，庫的符號表沒有更新，可以用’ar s’或ranlib來更新庫的符號表索引。

r：在庫中插入模塊(替換)。當插入的模塊名已經在庫中存在，則替換同名的模塊。如果若干模塊中有一個模塊在庫中不存在，ar顯示一個錯誤消息，並不替換其他同名模塊。默認的情況下，新的成員增加在庫的結尾處，可以使用其他任選項來改變增加的位置。

t：顯示庫的模塊表清單。一般只顯示模塊名。

x：從庫中提取一個成員。如果不指定要提取的模塊，則提取庫中所有的模塊。

下面在看看可與操作選項結合使用的任選項：

a：在庫的一個已經存在的成員後面增加一個新的文件。如果使用任選項a，則應該為命令行中membername參數指定一個已經存在的成員名。

b：在庫的一個已經存在的成員前面增加一個新的文件。如果使用任選項b，則應該為命令行中membername參數指定一個已經存在的成員名。

c：創建一個庫。不管庫是否存在，都將創建。

f：在庫中截短指定的名字。預設情況下，文件名的長度是不受限制的，可以使用此參數將文件名截短，以保證與其它系統的兼容。

i：在庫的一個已經存在的成員前面增加一個新的文件。如果使用任選項i，則應該為命令行中membername參數指定一個已經存在的成員名(類似任選項b)。

l：暫未使用

N：與count參數一起使用，在庫中有多個相同的文件名時指定提取或輸出的個數。

o：當提取成員時，保留成員的原始數據。如果不指定該任選項，則提取出的模塊的時間將標為提取出的時間。

P：進行文件名匹配時使用全路徑名。ar在創建庫時不能使用全路徑名（這樣的庫文件不符合POSIX標準），但是有些工具可以。

s：寫入一個目標文件索引到庫中，或者更新一個存在的目標文件索引。甚至對於沒有任何變化的庫也作該動作。對一個庫做ar s等同於對該庫做ranlib。

S：不創建目標文件索引，這在創建較大的庫時能加快時間。

u：一般說來，命令ar r…插入所有列出的文件到庫中，如果你只想插入列出文件中那些比庫中同名文件新的文件，就可以使用該任選項。該任選項只用於r操作選項。

v：該選項用來顯示執行操作選項的附加信息。

V：顯示ar的版本。