NAME

ar - 建立，修改檔案或從檔案中抽取成員。

總覽

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

描述

GNU 組織的 ar 程式用於建立，修改檔案或從檔案中抽取成員。一個檔案是一個包含了很多其它檔案的單獨的檔案，它採用的結構使得可以很容易恢復原來獨立的檔案（稱為檔案的成員）。

原始檔案（成員）的內容、許可權、時間屬性、屬主和組都在檔案中得到保留，在抽取時可以得到恢復。

ar 程式維護的檔案成員可以擁有一定長度的名字；具體情況，與你係統上的 ar 是怎樣配置的有關。為了與其它工具維護的檔案格式相容，有可能對成員名字的長度有嚴格的限制，如果確實是這樣，通常要求採用 15 個字元（典型的格式是 a.out），或者 16 個字元（典型的格式是 coff）。

ar 是一個二進位制格式的工具，因為這一類檔案多數都作為儲存公共程式的 庫檔案 使用。

透過指定修飾符`s', ar 可以建立指向檔案中可重定位目標模組定義的符號表的索引, 一旦建立, 在ar 更新其內容時 (透過`q' 執行更新操作) , 此索引也會得到更新. 有這種索引的檔案可以加速到庫檔案的連線過程, 並且允許庫中的例程相互呼叫而無須考慮它們在檔案中的位置.

可以使用`nm -s' 或 `nm --print-armap' 列出這種索引, 如果檔案沒有這類索引, 可以使用另外一個稱為ranlib 的ar 程式增加這種索引.

ar 至少需要兩個引數才能執行：一個指明執行的操作（可能伴隨有其它的 修飾符 ），作用的檔案名字。多數操作可以接受更多的檔案引數, 指明操作的詳細檔案.

選項

ar 允許你在第一個命令列引數中以任意順序混合指定操作碼p 和修飾符mod .

只要你願意, 也可以用破折號作為命令列第一個引數的開始.

p 關鍵字指明要執行的操作, 只能指明為如下之一:

d

從檔案中刪除模組. 透過files 指明要刪除的模組的名稱; 如果沒有指出要刪除的檔案名稱, 檔案不會改變任何內容.

如果給出了'v' 修飾符,ar 會例出它刪除的每一個模組.

m

用此操作在檔案中移動成員.

如果某個符號名在檔案的多個成員中有定義, 那麼程式怎樣連線檔案檔案得到的結果可能是不同的.

如果沒有為m 指定修飾符, 由files 指出的成員將移動到檔案的末尾 ; 可以透過 `a', `b' 或 `i' 等修飾符, 指定成員移動的具體位置.

p

在標準輸出上列印檔案中指定的成員. 如果給出了`v' 修飾符, 在列印成員內容之前, 先列印成員的名字.

如果沒有指明files 引數, 檔案中所有的成員都會被列印出來.

q

快速追加; 增加 files 到 archive 的末尾, 不進行替換檢查.

修飾符 `a' `b' 和 `i'不影響此操作, 新成員始終追加到檔案的末尾處.

修飾符 `v' 可以使 ar 列出它追加的所有檔案.

由於本功能是用於快速操作, 即使檔案中有符號表索引也不進行更新; 可以使用 `ar s' 或 ranlib 明確要求更新這些索引.

在為快速追加重建索引時,由於有太多不同的系統, 所以 GNU ar 採用 `q' 作為 `r'的一個同義字.

r

把檔案 files 插入 archive ( 替換 ). 本操作與 `q' 是不同的, 如果檔案中已有的某個成員與插入檔案的名稱相同, 此成員將被刪除.

如果不存在名稱為 files 的檔案, ar 顯示一個錯誤訊息, 並且保留檔案中已有的同名成員.

預設情況下, 新成員增加到擋案的末尾; 可以透過使用 `a' `b' 或 `i' 等修飾符指定相對於已有成員的位置.

透過使用 `v' 修飾符會為每個插入的檔案產生一行輸出, 根據輸出中的字元 `a' 或 `r' 可以表明該檔案是追加的 (沒有刪除以前的成員) 還是替換的.

t

顯示一個 archive 檔案所包含內容的列表 , 或檔案中的由 files 指出的檔案列表. 通常只顯示成員的名稱, 如果使用 `v' 修飾符, 可以得到成員的許可權, 時間屬性, 屬主, 組和大小.

如果沒有指出 files, 檔案中的所有檔案都會列出.

如果檔案中 (稱為 `b.a') 有多個同名成員 (稱為 `fie'), `ar t b.a fie' 僅僅列出第一個; 要看到它們的全部, 必須要求完整的列表 —在本例中是 `ar t b.a'.

x

從檔案中抽取成員 (名稱為 files) . 如果使用 `v' 修飾符, ar 會列出它抽取的每一個檔案的名字.

如果沒有給出 files, 抽取檔案中所有的檔案.

可以在運算子 p 後緊隨一定數量的修飾符 mod 以指明操作的各種行為.

a: 增加檔案到檔案中已有成員之後 , 如果使用了修飾符 a, 必須在檔案名稱 archive 之前以 membername 引數的形式給出檔案中已有成員的名字.
b: 增加檔案到檔案中已有成員之前 , 如果使用了修飾符 b, 必須在檔案名稱 archive 之前以 membername 引數的形式給出檔案中已有成員的名字. (和修飾符 `i' 相同).
c: 建立檔案. 指定的檔案 archive 始終會被建立, 如果你要求執行的是更新, 透過此修飾符建立檔案時會給出一個警告.
f: 截短檔案成員的名字. ar 通常允許任意長度的檔名, 但這會導致與某些系統上的 ar 出現相容性問題, 使用 f 修飾符可以在往檔案中追加檔案時把名字截短.
i: 插入檔案到檔案中已有成員之前 , 如果使用了修飾符 i, 必須在檔案名稱 archive 之前以 membername 引數的形式給出檔案中已有成員的名字. (與修飾符 `b' 相同).
l: 接受此修飾符, 但不起作用.
N: 使用 count 引數. 本修飾符用於在檔案中有多個同名成員的情況. 刪除或抽取檔案中給定名字的第 count 個例項.
o: 抽取成員時保留他們 原始的 時間屬性. 如果沒有此修飾符, 檔案以抽取的時間作為它的時間屬性.
P: 匹配檔案中的名字時使用完整的路徑名. ar 不能建立使用完整路徑名的檔案 (這不符合 POSIX 標準), 但其它的檔案工具能夠建立, 本選項會使 ar 在抽取由其它工具建立的檔案檔案時, 使用完整的路徑名去匹配檔案中成員的名字.
s: 即使沒有對檔案進行改變, 用本修飾符也可以往檔案中寫一個目標檔案的索引或更新已經存在的索引. 可以與其它操作一起使用本修飾符, 也可以單獨使用. 對一個檔案執行 `ar s' 與執行 `ranlib' 等價.
S: 不生成檔案的符號表. 這可以加速建立大的檔案檔案的過程,但這樣建立的檔案不能被聯結器使用, 為建立符號表, 在最後執行 `ar' 時應該不用 `S' 修飾符, 或者對檔案執行一次 `ranlib' .
u: 通常ar r... 把所有列出的檔案插入到檔案中, 如果希望僅僅插入比檔案中已有成員更新的檔案時, 就應該使用此修飾符. `u' 修飾符僅允許與 `r' (替換) 操作一起使用. 某些情況下, 由於用 `q' 操作比較檔案的時間屬性會失去速度上的優勢, 所以不允許執行 `qu' 組合操作.
v: 使用本修飾符可以進行 冗餘的 操作。附加了此修飾符時，很多操作會顯示更多的訊息，如處理的檔名等。
V: 顯示 ar 的版本號。

參考

info 中的 `binutils' 條目; The GNU Binary Utilities, Roland H. Pesch (1991年10月). nm(1), ranlib(1).

版權

This document is distributed under the terms of the GNU Free Documentation License, version 1.1. That license is described in the sources for this manual page, but it is not displayed here in order to make this manual more consise. Copies of this license can also be obtained from: http://www.gnu.org/copyleft/.

中文版維護人

Yin Huaming <yhmact@pzh-public.sc.cninfo.net>

中文版最新更新

2002/06/23

中國 Linux 論壇 man 手冊頁翻譯計劃

http://cmpp.linuxforum.net

跋

本頁面中文版由中文 man 手冊頁計劃提供。
中文 man 手冊頁計劃：https://github.com/man-pages-zh/manpages-zh