ar

Section: GNU 开发工具 (1)
Updated: 1999
Index Return to Main Contents

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

This document was created by man2html, using the manual pages.
Time: 13:11:55 GMT, December 24, 2015