ar コマンド

目的

リンケージ・エディターが使う索引付きライブラリーを保守します。

構文

ar [  -c ] [  -l ] [  -g | -o ] [  -s ] [  -v ] [  -C ] [  -T ] [  -z ] {  -h |  -p |  -t |  -x } [  -X  {32|64|32_64|d64| any}] ArchiveFile [ File ... ]

ar [  -c ] [  -l ] [  -g | -o ] [  -s ] [  -v ] [  -C ] [  -T ] [  -z ] {  -m |  -r [  -u ] } [ {  -a |  -b |  -i }  PositionName  ] [  -X  {32|64|32_64|d64|any}]   ArchiveFile File ...

ar [  -c ] [  -l ] [  -g | -o ] [  -s ] [  -v ] [  -C ] [  -T ] [  -z ] {  -d |  -q } [  -X  {32|64|32_64|d64|any}] ArchiveFile File ...

ar [  -c ] [  -l ] [  -v ] [  -C ] [  -T ] [  -z ] {  -g | -o |  -s |  -w } [  -X  {32|64|32_64|d64|any}] ArchiveFile

説明

ar コマンドは、リンケージ・エディターが使う索引付きライブラリーを保守します。 ar コマンドは、1 つ以上の指定されたファイルを組み合わせて、ar アーカイブ・フォーマットで書かれた単一のアーカイブ・ファイルにします。 ar コマンドは、ライブラリーを作成するときに、移送可能なフォーマットのヘッダーを作成します。また、ライブラリーを作成または更新するときには、記号テーブルを再構築します。 索引付きアーカイブと記号テーブルのフォーマットと構造については、ar ファイル・フォーマット・エントリーのセクションを参照してください。

ar コマンドが認識するファイル・フォーマットは 2 つあります。 ビッグ・アーカイブ・フォーマット ar_big はデフォルトのファイル・フォーマットで、32 ビットと 64 ビットの両方のオブジェクト・ファイルをサポートします。スモール・アーカイブ・フォーマットは、AIX® 4.3 よりも古いバージョンで認識されるアーカイブを 作成するために使用できます (-g フラグを参照してください)。 64 ビット・オブジェクトをスモール・フォーマット・アーカイブに追加する場合は、-g を指定した場合を除き、ar コマンドはまずそれをビッグ・フォーマットに変換します。 デフォルトでは、ar は 32 ビット・オブジェクト・ファイルだけを処理します。 アーカイブの 64 ビット・オブジェクト・ファイルは無視されます。 この動作を変更するには、-X フラグを使用するか、 OBJECT_MODE 環境変数を設定します。

フラグ

ar コマンドでは、cClosTv セットからオプションのフラグを幾つでも指定できます。 フラグ・セット dhmopqrstwx からは、フラグを 1 つ指定する必要があります。 -m または -r フラグを選択する場合は、位置決めフラグ (-a、-b、または -i) も指定できます。-a、-b、または -i フラグの場合は、ArchiveFile (PositionName) の中のファイルの名前も指定する必要があります。

終了状況

このコマンドは次の終了値を戻します。

例

1. ライブラリーを作成するには、次のように入力します。

   ar -v -q lib.a strlen.o strcpy.o

   lib.a ライブラリーが存在しない場合は、このコマンドはそのライブラリーを作成し、ファイル strlen.o および strcpy.o のコピーをそこに入れます。 lib.a ライブラリーが存在している場合は、このコマンドは、重複メンバーの有無を検査しないで、新しいメンバーを最後に追加します。v フラグは詳細モードを設定します。このモードでは、ar コマンドは進行中に進行状況レポートを表示します。
2. ライブラリーの内容テーブルを出力するには、次のように入力します。

   ar -v -t lib.a

   このコマンドは、lib.a ライブラリーの内容のテーブルを出力します。ls -l コマンドの出力に似た長形式のリストが表示されます。メンバー・ファイル名だけを出力するには、-v フラグを省略します。
3. ライブラリー内でメンバーを置換したり、新しいメンバーを追加したりするには、次のように入力します。

   ar -v -r lib.a strlen.o strcat.o

   このコマンドは、メンバー strlen.o および strcat.o を置換します。 lib.a が例 1 に示したように作成されている場合は、strlen.o メンバーが置換されます。strcat.o という名前のメンバーが存在していないので、そのメンバーがライブラリーの終わりに追加されます。
4. 新しいメンバーを挿入する位置を指定するには、次のように入力します。

   ar -v -r -b strlen.o lib.a strcmp.o

   このコマンドは、strcmp.o ファイルを追加し、strlen.o メンバーの前に新しいメンバーを配置します。
5. 変更されたメンバーを更新するには、次のように入力します。

   ar -v -r -u lib.a strcpy.o

   このコマンドは既存の strcpy.o メンバーを置換します。ただし、この置換が行われるのは、ファイル strcpy.o を最後にライブラリーに追加した後で、このファイルを修正した場合だけです。
6. ライブラリー・メンバーの順序を変更するには、次のように入力します。

   ar -v -m -a strcmp.o lib.a strcat.o strcpy.o

   このコマンドは、メンバー strcat.o および strcpy.o を、strcmp.o メンバーの直後の位置に移動します。strcat.o メンバーと strcpy.o メンバーの相対的な順序は変わりません。つまり、strcpy.o メンバーが strcat.o メンバーより前にあったとすれば、移動後もその順序は変わりません。
7. ライブラリー・メンバーを抽出するには、次のように入力します。

   ar -v -x lib.a strcat.o strcpy.o

   このコマンドは、メンバー strcat.o および strcpy.o を、それぞれ、strcat.o および strcpy.o という名前のファイルにコピーします。
8. メンバーを抽出し名前を変更するには、次のように入力します。

   ar -p lib.a strcpy.o >stringcopy.o

   このコマンドは、メンバー strcpy.o を stringcopy.o という名前のファイルにコピーします。
9. メンバーを削除するには、次のように入力します。

   ar -v -d lib.a strlen.o

   このコマンドは、lib.a ライブラリーからメンバー strlen.o を削除します。
10. ld コマンドにより作成した複数の共用モジュールからアーカイブ・ライブラリーを作成するには、次のように入力します。

    ar -r -v libshr.a shrsub.o shrsub2.o shrsub3.o ...

    このコマンドは、shrsub.o、shrsub2.o、 shrsub3.o などのように命名された共用モジュールから、 libshr.a という名前のアーカイブ・ライブラリーを作成します。libshr.a アーカイブ・ライブラリーを使って main プログラムをコンパイルしリンクするには、次のコマンドを使います。

    cc -o main main.c -L/u/sharedlib -lshr

    これで、main プログラムは実行可能になります。libshr.a アーカイブ・ライブラリー内にあり、main プログラムによって参照されているすべての記号に、据え置き解決のためのマークが付けられています。-l フラグは、libshr.a ライブラリーから記号を検索することを指定しています。
11. lib.a の内容を出力する (ただし 32 ビットのオブジェクト・ファイルは無視する) には、次のように入力します。

    ar -X64 -t -v lib.a

12. lib.a から 32 ビットのオブジェクト・ファイルを抽出するには、次のように入力します。

    ar -X32 -x lib.a

13. 32 ビット、64 ビット、さらに非オブジェクトも含めて、lib.a 内のすべてのファイルを出力するには、次のように入力します。

    ar -X32_64 -t -v lib.a

ファイル