1.2 スクリプトを用いたarの制御

     ar -M [ <script ]

単一のコマンドラインオプション-Mをarで用いた場合， 基礎的なコマンド言語でその処理を制御することが可能です．arの この形式は，標準入力が端末から直接来ている場合，対話的に処理します．対 話的に使用している間，arは入力を促し(プロンプトは`AR >')，エラー後も実行を続けます．標準入力をスクリプトファイルにリダイレ クトしている場合，プロンプトは表示されず，arはエラーが発生す ると(ゼロでない終了コードで)実行を終了します．

arコマンド言語は，コマンドラインオプションと等価に設計されて いません．実際，それはアーカイブ上の制御が若干少なくなっていま す．コマンド言語の目的は，MRI “librarian”プログラムに対して書かれた スクリプトを既に所有している開発者が，gnu arへの変換を より簡単にすることです．

arコマンド言語の構文は簡単です．

• コマンドは大文字も小文字も認識します．例えば，LISTはlist と同じです．以下の記述では，明確さのためにコマンドは大文字で表示します．
• 単一のコマンドは，個別の行に配置してもかまいません．それは，行の最初の 単語となります．
• 空行が可能で，それは効果がありません．
• コメントが可能です．文字`*'または`;'以降のテキストは無視され ます．
• arコマンドの引数の一部として名前のリストを使用するときは，カ ンマまたは空白で，それぞれの名前を分けることが可能です．明確さのため， 以下の説明はカンマで表現されます．
• 行の連結文字として`+'が使用されます．`+'が行末に現れた場合， それに続く行のテキストは，現在のコマンドの一部と考えられます．

以下のものは，arで使用することが可能な，または，ar を対話的に使用しているときのコマンドです．そのうちの三つは特別な意味を 持ちます．

OPENやCREATEは現在のアーカイブ(current archive)を 指定し，それはそれ以外のほとんどのコマンドが要求する一時的なファイルで す．

SAVEは，スクリプトでこれまでに指定された変更をコミットします． SAVEの前のコマンドは，現在のアーカイブの一時的なコピーに対して のみ効果があります．

ADDLIB archive

ADDLIB archive (module, module, ... module)

archiveのすべての内容(または，指定されている場合，アーカイブのそ れぞれの指名されたmodule)を，現在のアーカイブに追加します．

OPENやCREATEを前もって使用することが要求されます．

ADDMOD member, member, ... member

それぞれの指名されたmemberを，モジュールとして，現在のアーカイブ に追加します．

OPENやCREATEを前もって使用することが要求されます．

CLEAR

現在のアーカイブの内容を削除し，最後にSAVEされてからのあらゆる 処理の効果を無効にします．現在のアーカイブが指定されていない場合でも実 行可能です(効果はありません)．

CREATE archive

アーカイブを作成し，それを現在のアーカイブにします(その他，多くのコマ ンドに対して必要になります)．新しいアーカイブは，一時的な名前で作成さ れます．それは，SAVEを使用するまで，archiveとして実際に保 存されません．既存のアーカイブに優先可能です．同様に，指名されている既 存のarchiveファイルの内容は，SAVEまで破壊されません．

DELETE module, module, ... module

リストアップされているそれぞれのmoduleを，現在のアーカイブから削 除します．`ar -d archive module ... module' と同じです．

OPENやCREATEを前もって使用することが要求されます．

DIRECTORY archive (module, ... module)

DIRECTORY archive (module, ... module) outputfile

archiveに存在している指名されたそれぞれmoduleをリストアッ プします．別のコマンドVERBOSEで，出力形式を指定します．冗長出力 がオフのとき，出力は`ar -t archive module...'のよ うになります．冗長出力がオンのとき，リストは`ar -tv archive module...'のようになります．

出力は通常，標準出力に流れていきます．しかし，outputfileを最後の 引数として指定した場合，arはそのファイルに出力を変更します．

END

arを，正しく完了したことを示す終了コード0で終了します． このコマンドは出力ファイルを保存しません．最後のSAVEコマンド以 降に現在のアーカイブを変更した場合．これらの変更は失われます．

EXTRACT module, module, ... module

指名されたそれぞれのmoduleを現在のアーカイブから抽出し，それらを 現在のディレクトリに個別のファイルとして書き出します．`ar -x archive module...'と同じです．

OPENやCREATEを前もって使用することが要求されます．

LIST

現在のアーカイブのすべての内容を，VERBOSEの状態に関わらず， “verbose”形式で表示します．効果は`ar tv archive'に似てい ます．(この単独コマンドはgnu ar拡張で，MRI互換に提供さ れているものではありません)．

OPENやCREATEを前もって使用することが要求されます．

OPEN archive

現在のアーカイブとして使用するために，既存のアーカイブを開きます(他の 多くのコマンドに対し必要です)．それに続くコマンドの結果からのあらゆる 変更は，次にSAVEが使用されるまで，archiveに対し実際に効果 はありません．

REPLACE module, module, ... module

現在のアーカイブで，それぞれの(REPLACEの引数で指名された)既存の moduleを，現在のワーキングディレクトリのファイルで置換します．エ ラー無くこのコマンドを実行するために，ファイルと現在のアーカイブのモ ジュールの両方が存在する必要があります．

OPENやCREATEを前もって使用することが要求されます．

VERBOSE

DIRECTORYからの出力を管理している内部フラグを切り替えます．フラ グがオンのとき，DIRECTORY出力は，`ar -tv '...からの出 力に一致します．

SAVE

現在のアーカイブへの変更をコミットし，それを，最後のCREATEや OPENコマンドで指定された名前のファイルに，実際に保存します．

OPENやCREATEを前もって使用することが要求されます．