ar(1) manページ

amp;GNU ar は最初のコマンド行オプションとして、オペレーションコード p と、修飾子 mod を任意の順序で組み合わせたものを受け付けます。

最初のオプションの先頭にダッシュ(ハイフン)をつけることもできます。

キー文字 p は、どのオペレーションを実行するかを指定します。キー文字としては以下のいずれか一つだけを指定することができます。

d アーカイブからモジュールを削除します。削除するモジュール名を member... として指定して下さい。ファイル名を指定しなければアーカイブは変更されません。
v 修飾子を指定した時には、 ar は削除する際にそのモジュール名を表示します。

m メンバをアーカイブ内で移動します。
あるシンボルが複数のメンバで定義されている場合は、アーカイブ内でのメンバの順序によって、プログラムがライブラリをリンクした結果が異なることがあります。
m に修飾子が指定されなかった場合は member 引数で指定したメンバはアーカイブの最後に移動されます。 a, b, i 修飾子を指定することによって、修飾子に応じた場所に移動します。

p アーカイブ内の指定されたメンバを標準出力に出力します。 v 修飾子が指定されたときは、メンバの内容を出力する前にメンバ名を出力します。
member 引数を指定しなければ、アーカイブ内のすべてのファイルが出力されます。

q クイックアペンド。歴史的には、member で指定されたファイルを、重複をチェックせずに amp;アーカイブ の末尾に追加します。
amp;a, b, i 修飾子はこのオペレーションには amp;影響しません。新たなメンバは常にアーカイブの末尾に置かれます。
v 修飾子を指定すると、 ar は追加の際にそのファイル名を出力します。
このオペレーションの特徴は動作速度ですので、たとえシンボルテーブルのインデックスが存在したとしても、それを更新しません。シンボルテーブルのインデックスを更新するには、明示的に ar s か ranlib を使って下さい。
しかしながら、多くの異なるシステムにおいてクイックアペンドがインデックスを再構築することが仮定されていますので、 GNU ar は q は r と同じ動作をするように実装しています。

r ファイル member... をアーカイブに挿入 (重複の際は置換) します。このオペレーションは q とは異なり、追加するファイルと同名のメンバがすでに存在する場合は削除されます。
もし member... で指定したファイルの中に存在しないものが一つでも含まれている場合は ar はエラーメッセージを出力し、そのファイル名と同名のメンバは変更されずに保存されます。
デフォルトでは新しいメンバはファイルの末尾に追加されますが、 a, b, i 修飾子を指定することにより、既存のメンバに対する相対的な位置関係を指定することができます。
このオペレーションに v 修飾子を指定すると、挿入された各ファイルに対して、ファイルが追加された (削除された古いメンバがない) か、置換されたかを示す a または r のどちらかを含んだ一行が出力されます。

t アーカイブ の内容、または member... に列挙されたファイルのうち、アーカイブ内に存在するものの一覧を出力します。通常はメンバ名だけを表示しますが、 v 修飾子を指定することにより、モード (パーミッション)、タイムスタンプ、所有者、グループ、サイズも表示します。
member の指定がない場合はアーカイブ内のすべてのファイルの一覧を表示します。
あるアーカイブ ( b.a とします) の中に同じ名前 ( fie とします) の複数のファイルが存在する場合は、 ar t b.a fie は最初のファイルだけを表示します。同名のファイルをすべて見たい場合はすべてのファイルの一覧を表示して下さい。この例では ar t b.a です。

x アーカイブから files で指定されたメンバを抽出します。 v 修飾子を指定すると、 ar は抽出の際にそのファイル名を出力します。
member の指定がない場合はアーカイブ内のすべてのファイルを抽出します。

いくつかの修飾子 ( mod) をキー文字 p の直後に付けることによって、オペレーションの動作を変更することができます。

a 新しいファイルを既存のメンバの後に追加します。 a 修飾子を用いるときは、 archive 引数の前に relpos 引数として既存のメンバ名を指定する必要があります。

b 新しいファイルを既存のメンバの前に追加します。 b 修飾子を用いるときは、 archive 引数の前に relpos 引数として既存のメンバの名前を指定する必要があります ( i と同じ)。

c アーカイブを作成します。存在しない アーカイブ を更新するように指定した場合、そのアーカイブは必ず作成されますが、その際、この修飾子を指定することによって、アーカイブを作成することを明示していなければ、警告を出力します。

f アーカイブ内の名前を切り詰めます。通常 GNU ar は任意の長さのファイル名を受け付けます。このため、いくつかのシステムで使われている従来の ar と互換性のないアーカイブが作成されることになります。これが問題になる場合は、 f 修飾子を指定して、ファイルをアーカイブに追加する際にそのファイル名を切り詰めることができます。

i 新しいファイルを既存のメンバの前に挿入します。 i 修飾子を用いる時は、 archive 引数の前に relpos 引数として既存のメンバ名を指定する必要があります ( b と同じ)。

l この修飾子は指定可能ですが、使用されません。

N count パラメータを使用します。アーカイブに同一名のエントリが複数ある場合、これが使用されます。指定した名前のインスタンス count を、アーカイブから抽出または削除します。

o メンバを抽出する際に オリジナル の時刻を保存します。この修飾子を指定しないと、アーカイブから抽出されたファイルのタイムスタンプは抽出時の時刻になります。

P アーカイブ中の名前とマッチングを取るときに、フルパス名を使用します。 GNU ar はフルパス名のアーカイブ (このようなアーカイブは POSIX 準拠ではありません) を作成できませんが、他のアーカイブ作成器は可能です。このオプションを使用すると、 GNU ar は完全なパス名を使用してファイル名のマッチングを行います。他のツールで作成したアーカイブから 1 個のファイルを取り出す場合に有用でしょう。

s アーカイブに他の変更がない場合でも、アーカイブにオブジェクトファイルのインデックスを書き込んだり、既存のインデックスを更新します。この修飾子はほかのオペレーションと併用することも、単独で使用することも可能です。あるアーカイブに対して ar s を実行することは、そのアーカイブに対して ranlib を実行することと等価です。

S アーカイブのシンボルテーブルを作成しません。これを用いると大きなライブラリを何回かに分けて作成する際に時間を短縮することができます。この結果得られるアーカイブはリンカで使用することはできません。シンボルテーブルを作成するためには最後に ar を実行する時に S 修飾子を外すか、そのアーカイブに対して ranlib を実行する必要があります。

u 通常 ar r... は列挙されたファイルをすべてアーカイブに挿入します。この修飾子を指定すると、指定したファイルが既存の同名のメンバより新しい場合のみファイルを挿入します。 u 修飾子は r (置換) オペレーションだけに付けることができます。特に、タイムスタンプの確認は q オペレーションの利点である速度を低下させるので、 qu の組み合わせは認められません。

v オペレーションに対して冗長な表示を要求します。多くのオペレーションにおいて v 修飾子が指定されると、処理されたファイル名などの付加的な情報が表示されます。

V この修飾子は ar のバージョン番号を表示します。

amp;ar は、最初のオプションが -X32_64 の場合これを無視します。 AIX との互換性のためです。本オプション指定時の動作が GNU ar デフォルトです。 ar は他のいかなる amp;-X もサポートしません。特に AIX ar のデフォルトである -X32 はサポートしません。

manページ — AR

名称

内容

書式

解説

オプション

関連項目

COPYRIGHT

d	アーカイブからモジュールを削除します。削除するモジュール名を member... として指定して下さい。ファイル名を指定しなければアーカイブは変更されません。 v 修飾子を指定した時には、 ar は削除する際にそのモジュール名を表示します。
m	メンバをアーカイブ内で移動します。あるシンボルが複数のメンバで定義されている場合は、アーカイブ内でのメンバの順序によって、プログラムがライブラリをリンクした結果が異なることがあります。 `m` に修飾子が指定されなかった場合は member 引数で指定したメンバはアーカイブの最後に移動されます。 a, b, i 修飾子を指定することによって、修飾子に応じた場所に移動します。
p	アーカイブ内の指定されたメンバを標準出力に出力します。 v 修飾子が指定されたときは、メンバの内容を出力する前にメンバ名を出力します。 member 引数を指定しなければ、アーカイブ内のすべてのファイルが出力されます。
q	クイックアペンド。歴史的には、member で指定されたファイルを、重複をチェックせずに amp;アーカイブの末尾に追加します。 amp;a, b, i 修飾子はこのオペレーションには amp;影響しません。新たなメンバは常にアーカイブの末尾に置かれます。 v 修飾子を指定すると、 ar は追加の際にそのファイル名を出力します。このオペレーションの特徴は動作速度ですので、たとえシンボルテーブルのインデックスが存在したとしても、それを更新しません。シンボルテーブルのインデックスを更新するには、明示的に ar s か ranlib を使って下さい。しかしながら、多くの異なるシステムにおいてクイックアペンドがインデックスを再構築することが仮定されていますので、 GNU ar は q は r と同じ動作をするように実装しています。
r	ファイル member... をアーカイブに挿入 (重複の際は置換) します。このオペレーションは q とは異なり、追加するファイルと同名のメンバがすでに存在する場合は削除されます。もし member... で指定したファイルの中に存在しないものが一つでも含まれている場合は ar はエラーメッセージを出力し、そのファイル名と同名のメンバは変更されずに保存されます。デフォルトでは新しいメンバはファイルの末尾に追加されますが、 a, b, i 修飾子を指定することにより、既存のメンバに対する相対的な位置関係を指定することができます。このオペレーションに v 修飾子を指定すると、挿入された各ファイルに対して、ファイルが追加された (削除された古いメンバがない) か、置換されたかを示す a または r のどちらかを含んだ一行が出力されます。
t	アーカイブの内容、または member... に列挙されたファイルのうち、アーカイブ内に存在するものの一覧を出力します。通常はメンバ名だけを表示しますが、 v 修飾子を指定することにより、モード (パーミッション)、タイムスタンプ、所有者、グループ、サイズも表示します。 member の指定がない場合はアーカイブ内のすべてのファイルの一覧を表示します。あるアーカイブ ( b.a とします) の中に同じ名前 ( fie とします) の複数のファイルが存在する場合は、 ar t b.a fie は最初のファイルだけを表示します。同名のファイルをすべて見たい場合はすべてのファイルの一覧を表示して下さい。この例では ar t b.a です。
x	アーカイブから files で指定されたメンバを抽出します。 v 修飾子を指定すると、 ar は抽出の際にそのファイル名を出力します。 member の指定がない場合はアーカイブ内のすべてのファイルを抽出します。

a	新しいファイルを既存のメンバの後に追加します。 a 修飾子を用いるときは、 archive 引数の前に relpos 引数として既存のメンバ名を指定する必要があります。
b	新しいファイルを既存のメンバの前に追加します。 b 修飾子を用いるときは、 archive 引数の前に relpos 引数として既存のメンバの名前を指定する必要があります ( i と同じ)。
c	アーカイブを作成します。存在しないアーカイブを更新するように指定した場合、そのアーカイブは必ず作成されますが、その際、この修飾子を指定することによって、アーカイブを作成することを明示していなければ、警告を出力します。
f	アーカイブ内の名前を切り詰めます。通常 GNU ar は任意の長さのファイル名を受け付けます。このため、いくつかのシステムで使われている従来の ar と互換性のないアーカイブが作成されることになります。これが問題になる場合は、 f 修飾子を指定して、ファイルをアーカイブに追加する際にそのファイル名を切り詰めることができます。
i	新しいファイルを既存のメンバの前に挿入します。 i 修飾子を用いる時は、 archive 引数の前に relpos 引数として既存のメンバ名を指定する必要があります ( b と同じ)。
l	この修飾子は指定可能ですが、使用されません。
N	count パラメータを使用します。アーカイブに同一名のエントリが複数ある場合、これが使用されます。指定した名前のインスタンス count を、アーカイブから抽出または削除します。
o	メンバを抽出する際にオリジナルの時刻を保存します。この修飾子を指定しないと、アーカイブから抽出されたファイルのタイムスタンプは抽出時の時刻になります。
P	アーカイブ中の名前とマッチングを取るときに、フルパス名を使用します。 GNU ar はフルパス名のアーカイブ (このようなアーカイブは POSIX 準拠ではありません) を作成できませんが、他のアーカイブ作成器は可能です。このオプションを使用すると、 GNU ar は完全なパス名を使用してファイル名のマッチングを行います。他のツールで作成したアーカイブから 1 個のファイルを取り出す場合に有用でしょう。
s	アーカイブに他の変更がない場合でも、アーカイブにオブジェクトファイルのインデックスを書き込んだり、既存のインデックスを更新します。この修飾子はほかのオペレーションと併用することも、単独で使用することも可能です。あるアーカイブに対して ar s を実行することは、そのアーカイブに対して ranlib を実行することと等価です。
S	アーカイブのシンボルテーブルを作成しません。これを用いると大きなライブラリを何回かに分けて作成する際に時間を短縮することができます。この結果得られるアーカイブはリンカで使用することはできません。シンボルテーブルを作成するためには最後に ar を実行する時に S 修飾子を外すか、そのアーカイブに対して ranlib を実行する必要があります。
u	通常 ar r... は列挙されたファイルをすべてアーカイブに挿入します。この修飾子を指定すると、指定したファイルが既存の同名のメンバより新しい場合のみファイルを挿入します。 u 修飾子は r (置換) オペレーションだけに付けることができます。特に、タイムスタンプの確認は q オペレーションの利点である速度を低下させるので、 qu の組み合わせは認められません。
v	オペレーションに対して冗長な表示を要求します。多くのオペレーションにおいて v 修飾子が指定されると、処理されたファイル名などの付加的な情報が表示されます。
V	この修飾子は ar のバージョン番号を表示します。