名称

ar − アーカイブとライブラリの維持管理プログラム

形式

ar [mrxtdpq][uvcnbailos] [ posname ] file1 ... fileN

解説

ar は、 複数のファイルを一つのアーカイブファイルとして維持管理します。 その主な用途は、 ローダが扱うライブラリファイルを作成し、 更新することです。 しかし、 ar は他の、 類似した目的のために使用することもできます。

注意: ar の本バージョンは、 UNIX が走る様々なマシンの間で移植可能な ASCII フォーマットのアーカイブを使用しています。

本文中で、 options は、 mrxtdpq のうちの 1 キャラクタでオプションとして、 uvcnbailos のうちの 1 つまたは複数のキャラクタを連結して使われます。 suboption は、 abiosu のうちのキャラクタで他のオプションと共に使用し、単独では使えません。

options キャラクタの意味は次のとおりです。

m 指定されたファイルをアーカイブファイルの最後へ移動します。 位置指定キャラクタがある場合には、 引数 posname がなければならず、 r の場合と同様にファイルを移動する場所を指定します。

r アーカイブファイル内の指定されたファイルを置き換えます。 オプションのキャラクタ u が共に使用されると、アーカイブファイルよりあとの 「最終変更」日付を持つファイルだけが置き換えられます。 オプションの位置指定キャラクタとして abi のうちのいずれか 1 つが使用された場合には、引数 posname が必要で、この引数は、新しいファイルが、 posname のあと (a の場合) または前 (b または i の場合) に置かれることを指定します。 位置指定キャラクタが使用されない場合には、 新しいファイルはアーカイブファイルの最後に入れられます。

x 指定されたファイルをアーカイブから取り出します。 名前が与えられない場合には、 アーカイブファイル内のすべてのファイルが取り出されます。 いずれの場合にも、 x はアーカイブファイルを変更しません。 通常、取り出された各ファイルの「最終変更」日付は、 それが取り出されたときの日付となります。 しかし、 o が使用されている場合には、「最終変更」日付は、 アーカイブ内に記録されている日付にリセットされます。

t アーカイブファイルの構成ファイルのリストを出力します。 名前が与えられない場合には、 アーカイブファイル内のすべてのファイルのリストが出力されます。 名前が与えられた場合には、 それらのファイルのリストだけが出力されます。

d 指定されたファイルをアーカイブファイルから削除します。

p アーカイブファイル内の指定されたファイルを出力します。

q 指定されたファイルをアーカイブファイルの最後にアペンドします。 オプションの位置指定キャラクタは無効です。 コマンドは、 追加されるメンバが既にアーカイブにあるかどうかはチェックしません。 このオプションは、 大きなアーカイブファイルを少しずつ作成していくときに、 何回もアーカイブファイルの内容をチェックすることによって 生ずる時間のロスを防ぐ場合に役立ちます。

u 置換が、既存のファイルより新しいものでない限り、アーカイバが既存の ファイルを置換しないようにします。 このオプションは、比較のために UNIX システムの「最終変更」日を 使用します。 r オプションとともにこのサブオプションを使用します。 v 新しいアーカイブファイルを古いものから作成したり、アーカイブの構成ファ イルを作成する度に、各ファイルの冗長な記述を表示します。 このオプションを t オプションと共に使用すると、 ar はアーカイブ内のファイルに関する全ての情報を表示します。また、 p オプションと共に使用すると、各ファイルの名前が表示されます。

c 指定のアーカイブファイルを作成した時に表示されるメッセージの生成を抑制 します。通常、 ar は必要があれば自動的に指定されたアーカイブファイルを生成します。

l 一時ファイルを現在のディレクトリに生成します。通常、 ar は一時ファイルをディレクトリ /tmp に作成します。

suboption キャラクタの意味は次のとおりです。

a ファイルを posname の位置に存在するファイルの後に置くことを指定します。 このサブオプションは、 m または r オプションとともに使用します。

b ファイルを posname の位置に存在するファイルの前に置くことを指定します。 このオプションは、 m または r オプションとともに使用します。

i ファイルを posname の位置に存在するファイルの前に置くことを指定します。 このサブオプションは、 m または r オプションとともに使用します。

o 新しく作成されたファイルに、それがアーカイブから抽出される前に もっていた「最終変更」 日を与えます。 x オプションとともにこのサブオプションを使用します。

s アーカイブの最初のファイルとしてシンボル定義 (symdef ファイル) を作ります。このファイルは、 ranlib 構造体のハッシュテーブルおよび対応する文字列テーブルを含みます。 symdef ファイルの名前は、ハッシュテーブルのバイト順序付けおよびファイル のターゲットマシンのバイト順序付けに基づいています。 アーカイバが symdef ファイルを作成する前に、各ファイルのバイト順序付けは、 ターゲットに一致していなければなりません。 アーカイブの内容を変更する場合とアーカイブファイルの名前が変わるために、 symdef ファイルは古いものとなります。 s を指定した場合、アーカイバは、実行を終了する前の最後のアクションとして、 symdef ファイルを作成します。 s オプションを使用する場合は、少なくとももう 1 つ別のアーカイブ オプションとして m、p、q、 r または t を指定しなければなりません。 NEWS-OS の場合、アーカイブは、共通オブジェクトを定義しますが、その オブジェクトは含みません。

z シンボルテーブルの構築を抑制します。

ファイル

/tmp/v∗一時ファイル

関連事項

lorder(1), ld(1), odump(1), ar(5), ranhash(3x). 

バグ

引数リスト中に同じファイルを 2 度指定すると、それは、アーカイブファイル 中に 2 度現れます。 o オプションは、あなたが抽出されたファイルの所有者であるか、スーパ ユーザでない限り、ファイルの「最終変更」日を変更しません。

NEWS-OSRelease 4.2.1R