ar(1) | GNU Development Tools | ar(1) |
名前
ar -書庫の作成、変更、および書庫からのファイルの取出しを行う書式
ar [ -] {dmpqrtx}[abcilosSuvV] [ membername] archive files...説明
GNU arプログラムは書庫 ( archive ) ファイルの作成、変更、および書庫からのファイルの取出しを行う。書庫はいくつかのファイルを集めて一つのファイルにしたもので、内部からオリジナルのファイルそれぞれを復元することができるようになっている。内部に含まれるファイルを書庫の メンバー と呼ぶ。オプション
GNU arでは動作指定子 p と修正子 mod の順番は任意であるが、これらはまとめて最初のコマンドライン引数に与える必要がある。- d
-
書庫からモジュールを削除 (
Delete ) する。削除するモジュールの名前は
files に指定する。もし一つもファイルが指定されなかった場合は、書庫に何の操作も行わない。
- m
-
書庫中のメンバーを移動 (
Move )する。
- p
-
指定された書庫内部のメンバー (複数可) を標準出力に表示 (
Print ) する。 `
v' 修正子が指定された場合には、メンバーの内容を標準出力に表示する前にそのメンバーの名前を表示する。
- q
-
files を書庫の最後に追加する。このとき置き換えのチェックを行わない (
Quickappend
)。
- r
-
書庫に
files を挿入し、同名のファイルがあったら置換 (
Replacement ) する。この操作は
q とは異なり、もとから書庫にあったメンバーのうち追加したメンバーと同名のものはすべて削除される。
- t
-
書庫の内容の表 (
table ) を表示する。
files が指定された場合は、
files のうち書庫に存在するものを表示する。通常はメンバーの名前のみが表示される。モード (パーミッション)、タイムスタンプ、オーナー、グループ、サイズなども表示させたい場合には、リクエストの際に同時に修正子
v をつければ良い。
- x
-
メンバーを書庫から取り出す (
eXtract )。この操作に修正子
v を用いると、
ar は取出したファイルをそれぞれ表示する。
いくつかの修正子 ( mod ) を動作指定子 p に続けて指定することができる。これによって動作を調整することができる。
- a
-
新たなファイルを、すでに書庫に存在するメンバーの後 (
after ) に追加する。修正子
a を用いる場合は、書庫にすでに存在するメンバーの名前を引数
membername として書庫名の指定の前に置かなければならない。
- b
-
新たなファイルを、すでに書庫に存在するメンバーの前 (
before ) に追加する。修正子
b を用いる場合は、書庫にすでに存在するメンバーの名前を引数
membername として、書庫名の指定の前に置かなければならない。 (
i と同じ動作をする)
- c
-
書庫を作成 (
create ) する。書庫を更新する操作の場合には、指定した書庫が存在しなければ、それは常に作成される。しかしこのとき警告メッセージが出る。この修正子をあらかじめ同時に指定しておけば、この警告を抑止することができる。
- f
-
書庫の中の名前を切りつめる。通常
ar では、ファイル名には任意の長さを指定できる。しかしこのことは、他のシステムのネイティブな
ar プログラムと互換性のない書庫を作ってしまう原因にもなりかねない。もしこれが問題となるときは、修正子
f を用いれば書庫の中に入れるファイルの名前を切りつめることができる。
- i
-
新しいファイルを書庫に存在するメンバーの前に挿入 (insert) する。この修正子
i を用いる際には、書庫に存在しているメンバーの名前を
membername 引数として書庫の指定の前に置く必要がある。 (
b と同じ動作をする)
- l
-
この修正子はエラーにはならないが何の効力もない。
- o
-
書庫からメンバーを取り出すときに、元の日付を保存する (
original)。この修正子を指定しなければ、書庫から取り出されたファイルのタイムスタンプは取り出し時のものになる。
- s
-
オブジェクトファイルの索引を書庫に書き込むか、または存在する索引を更新する。書庫に何の変化がなくても更新は行われる。この修正子はどんな操作とも同時に用いることができるし、単独でも用いることができる。 `
ar s' を書庫に対して実行するのは、 `
ranlib' と等価である。
- S
-
書庫のシンボルテーブルを作成しない。これは大きな書庫を構築する場合は結構な速度向上になる。結果としてできた書庫は、リンカからは使うことができない。シンボルテーブルをつくるには、最後の段階で実行される
ar に
S 修正子をつけないか、あるいはそのアーカイブに
ranlib を実行しなければならない。
- u
-
通常
ar r... はリストされたすべてのファイルを書庫に挿入する。指定したファイルと同名のメンバーが書庫中にすでにあった時に、元のメンバーの方が古い場合に限って挿入を行いたい場合には、この修正子を使うと良い (update)。 `
u' 修正子を用いることができるのは
r 操作 (replace) の場合に限られる。
qu の組み合わせは許されない。なぜならタイムスタンプをチェックすると `
q' 操作の速度面での利点が損なわれてしまうからである。
- v
-
この修正子は饒舌 (
verbose ) モードの動作を指定するために用いられる。 `
v' 修正子が追加されると、多くの操作において、より詳細な情報が表示される (例えば処理しているファイル名など)。
- V
-
この修正子は
ar のバージョン番号を表示する。
関連項目
info の ` binutils ' エントリ、 The GNU Binary Utilities, Roland H. Pesch (October 1991)、 nm( 1)、 ranlib( 1)著作権
Copyright (c) 1991 Free Software Foundation, Inc.Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English.
5 November 1991 | cygnus support |