Ubuntu Manpage: 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

http://cmpp.linuxforum.net

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

Ubuntu Manpages

ar

總覽

描述

選項

參考

版權

中文版維護人

中文版最新更新

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

跋