pax コマンド

目的

アーカイブ・ファイルのメンバーを取り出して書き込み、リストします。ファイルおよびディレクトリー階層をコピーします。

構文

アーカイブ・ファイルのメンバー・ファイルをリストする

pax [  -c | -n] [-d] [-U ] [  -v] [  -H |  -L ] [-f  Archive] [  -s ReplacementString... ] [-x Format] [-o Options] [ -Z ] [Pattern... ]

-r フラグを使用してアーカイブ・ファイルを取り出す

pax -r [  -c  | -n ] [  -d ] [  -i ] [  -k ] [ -U ] [  -u ] [  -v ] [  -H |  -L ] [  -f Archive] [  -o Options] [  -p String... ] [  -s ReplacementString... ] [  -x Format] [ -Z ]  [Pattern ... ]

-w フラグを使用してアーカイブ・ファイルに書き込む

pax -w [  -d ] [  -i ] [  -t ] [ -U ] [  -u ] [  -v ] [  -X ] [  -H |   -L ] [ -E ] [  -b Blocking] [[ -a ]   -f Archive] [  -o Options] [  -s ReplacementString... ] [  -x Format] [ -Z ] [ File... ]

-r フラグと -w フラグを使用してファイルをコピーする

pax -r -w [  -d ] [  -i ] [  -k ] [  -l ] [  -t ] [ -U ] [  -u ] [  -v ] [  -X ] [  -H |   -L ] [  -p String... ] [  -o Options] [  -s ReplacementString... ] [  -x Format] [ -Z ] [File ... ] Directory

説明

アーカイブ・ファイルのメンバー・ファイルのリスト (リスト・モード)

-r フラグも -w フラグも指定されない場合、pax コマンドは、標準入力から読み取られたアーカイブ・ファイルのすべてのメンバー・ファイルをリストします。Pattern パラメーターを指定すると、指定したパターンに一致するパス名を持つメンバー・ファイルだけが標準出力に書き出されます。 指定されたファイルがディレクトリーの場合は、そのディレクトリーに含まれているファイル階層も取り出されます。 -r フラグも -w フラグも指定されない場合は、-c、-d、-f、-n、-s、および -v フラグと Pattern パラメーターを指定できます。

-r フラグを使用したアーカイブ・ファイルの取り出し (読み取りモード)

-r フラグは指定するが、-w フラグは指定しない場合、pax コマンドは標準入力から読んだアーカイブ・ファイルのすべてのメンバー・ファイルを取り出します。 Pattern パラメーターを指定すると、指定したパターンに一致するパス名を持つメンバー・ファイルだけが標準出力に書き出されます。 指定されたファイルがディレクトリーの場合は、そのディレクトリーに含まれているファイル階層も取り出されます。-r フラグは、-c、-d、-f、-i、-k、-n、-s、-u、-v フラグ、および Pattern パラメーターと一緒に指定できます。

取り出したファイルのアクセス時間および修正時間は、アーカイブ・ファイルの場合と同じです。 取り出したファイルのファイル・モードは、ファイルをアーカイブした場合と同じですが、ユーザーのデフォルトのファイル作成モード (umask) の影響を受けない場合に限られます。 取り出したファイルの S_ISUID ビットと S_ISGID ビットはクリアされます。

アーカイブ・メンバーを取り出すのに中間ディレクトリーが必要な場合には、pax コマンドは、S_IRWXU、S_IRWXG、S_IRWXO のマスクの値のビット単位の包含 OR として設定されたアクセス権を持つディレクトリーを作成します。

選択したアーカイブ・フォーマットがリンクされるファイルの指定をサポートする場合、そのアーカイブ・フォーマットが取り出されたときにそれらのファイルをリンクできないとエラーになります。

-w フラグを使用したアーカイブ・ファイルの書き込み (書き込みモード)

-w フラグを指定して -r フラグを指定しない場合、pax コマンドは、File パラメーターで指定されたファイルの内容をアーカイブ・フォーマットで標準出力に書き出します。 File パラメーターを指定しないと、コピーするファイルのリストが標準入力から 1 行に 1 つずつ読み取られます。 File パラメーターがディレクトリーを指定する場合は、そのディレクトリーに含まれるすべてのファイルが書き込まれます。-w フラグは、-a、-b、-d、-f、-i、-o、-s、-t、-u、-v、-x、-X フラグ、および File パラメーターと一緒に指定できます。

-r フラグと -w フラグを使用したファイルのコピー (コピー・モード)

-r フラグと -w フラグをともに指定する場合、pax コマンドは、File パラメーターで指定されたファイルを Directory パラメーターで指定された出力先ディレクトリーにコピーします。ファイルを指定しないと、コピーするファイルのリストが、1 行に 1 つずつ標準入力から読み取られます。 指定されたファイルがディレクトリーの場合は、そのディレクトリーに含まれているファイル階層もコピーされます。-r フラグと -w フラグは、 -d、 -i、-k、-l、-o、 -p、-s、-t、-u、 -v、-X フラグ、および File パラメーターと一緒に指定できます。 Directory パラメーターは必ず指定してくだ さい。

コピーされたファイルは、アーカイブ・ファイルに書き込まれ、その後で取り出された内容と同じですが、元のファイルとコピーされたファイルの間にハード・リンクがある点が異なります。

-o フラグを使用したアーカイブ・アルゴリズムの修正

-o フラグを使用して、キーワードと値の組に従ってアーカイブ・アルゴリズムを修正します。 キーワードと値の組は、正しいアーカイブ・フォーマットに準拠している必要があります。 有効なキーワードとその動作のリストは、後で、-o フラグの説明のところに出てきます。

その他の注意事項

読み取りモードまたはコピー・モードでは、アーカイブ・メンバーを取り出すために中間ディレクトリーが必要である場合、pax コマンドは mkdir() サブルーチンに類似したアクションを実行します。この場合、パス引数として中間ディレクトリーが使用され、モード引数として値 S_IRWXU が使用されます。

指定されたパターンまたはファイル・オペランドが少なくとも 1 つのファイルまたはアーカイブ・メンバーと一致しない場合、pax は、一致しなかったそれぞれのファイルまたはアーカイブ・メンバーごとに診断メッセージ 1 つずつを標準エラーに書き込み、エラー状況を表して終了します。

スキャン・ディレクトリーでは、pax コマンドは、最後に訪問されたファイルの祖先である、既に訪問されているディレクトリーを入力することによって、無限ループを検出します。無限ループを検出すると、pax コマンドは診断メッセージを標準エラーに書き込み、終了します。

pax コマンドが読み取りモードまたはリスト・モードのときは、-x pax アーカイブ・フォーマットを使用することにより、拡張ヘッダー・レコード内のファイル名、リンク名、所有者名、または他のフィールドを pax UTF8 コード・セット・フォーマットから現在のコード・セットとロケールに変換することはできません。 pax コマンドは、診断メッセージを標準エラーに書き込み、-o invalid= オプションで記述されている通りにファイルを処理してから、アーカイブ内の次のファイルを処理します。

AIX® 5.3 の場合、pax コマンドは、デフォルトでは拡張属性を無視します。 -U オプションは pax に、ACL を含む拡張属性をアーカイブまたは復元することを通知します。 -pe オプションは ACL を保存します。-pe オプションが指定されているときに pax が ACL を保持するのに失敗すると、診断メッセージが標準エラーに書き込まれますが、取り出されたファイルは削除されません。ゼロ以外の終了コードが返されます。 pax アーカイブ・ファイル内に、拡張属性用エントリーに新しいレコード・タイプが必要です。

変数

フラグ

拡張ヘッダー・キーワード

(-x pax フォーマットのみに適用されます。)

-x pax フォーマットを指定すると、下記のリストで定義されているキーワードと値は、次の 2 つのモードのどちらかで -o フラグへのパラメーターとして使用できます。

keyword=value

書き込みモードまたはコピー・モードで使用される場合、これらのキーワードと値の組は、新しいアーカイブのグローバル拡張ヘッダー・レコードに書き込まれます。 読み取りモードまたはリスト・モードで使用される場合、これらのキーワードと値の組は、読み取られるアーカイブのグローバル拡張ヘッダー・レコード内にそれらの組がある場合と同様の働きをします。どちらの場合も、その値は、指定されたキーワードの個々の拡張ヘッダー・レコード内で値が割り当てられていない、すべてのファイルに適用されます。

keyword:=value

書き込みモードまたはコピー・モードで使用される場合、これらのキーワードと値の組は、新しいアーカイブの各ファイルの拡張ヘッダー・レコードに書き込まれます。 読み取りモードまたはリスト・モードで使用される場合、これらのキーワードと値の組は、読み取られるアーカイブの各ファイルの拡張ヘッダー・レコード内にそれらの組がある場合と同様の働きをします。どちらの場合も、その値は、グローバルまたはファイル特定の拡張ヘッダー・レコードにある指定のキーワードの値をすべてオーバーライドします。

atime

後に続くファイル (1 つまたは複数) のファイル・アクセス時間。ファイルの stat 構造体の st_atime メンバーの値と同じ。

charset

後に続くファイルのデータをエンコードするために設定される文字セットの名前。 このテーブルのエントリーは、既知の標準を参照するために定義されます。

エンコードは、通知だけを目的として拡張ヘッダーに組み込まれています。 pax は、説明に従って使用すると、ファイル・データを他のどのエンコードにも変換しません。 BINARY エントリーは、エンコードされていないバイナリー・データを示します。

comment

コメントとして使用する一連の文字。pax は値フィールド内の文字をすべて無視します。

ctime

以下のファイルのファイル作成時間。ファイルの stat 構造体の st_ctime メンバーの値と同じ。

gid

ファイルを所有するグループのグループ ID。10 進数で表わす。このレコードは、後に続くヘッダー・ブロック (1 つまたは複数) 内の gid フィールドをオーバーライドします。 pax は、書き込みモードまたはコピー・モードで使用されると、グループ ID が 99,999,999 を超えるファイルごとに、gid 拡張ヘッダー・レコードを 1 つずつ組み込みます。

gname

グループ・データベース内でグループ名としてフォーマットされている、後に続くファイル (1 つまたは複数) のグループ。 このレコードは、後に続くヘッダー・ブロックの gid フィールドと gname フィールド、および gid 拡張ヘッダー・レコードをオーバーライドします。 読み取り、コピー、またはリスト・モードで使用されると、pax は、ヘッダー・レコードの UTF8 エンコードからの名前を、受信システム上のグループ・データベースに適した文字セットに変換します。 いずれかの UTF8 文字が変換できない場合に、-o invalid=UTF8 オプションが指定されていないと、未定義の結果が生じます。 pax は、書き込みモードまたはコピー・モードで使用されると、グループ名がポータブル文字セットの文字と数字だけで表すことができないファイルごとに、gname 拡張ヘッダー・レコードを 1 つずつ組み込みます。

hdrcharset

BINARY エントリーは、影響を受けたファイルの拡張ヘッダーに記録されるすべての値が、基本のシステムからの未エンコード・バイナリー・データであることを示しています。

linkpath

前にアーカイブされた別のファイル (タイプを問わず) に対して作成されるリンクのパス名。このレコードは、後に続く ustar ヘッダー・ブロック (1 つまたは複数) の linkname フィールドをオーバーライドします。

後に続く ustar ヘッダー・ブロックが、作成されるリンクのタイプ (ハードまたはシンボリック) を決定します。 後者の場合、リンク・パス値が、そのシンボリック・リンクの内容になります。 pax は、リンクの名前 (シンボリック・リンクの内容) を、UTF8 エンコードからローカル・ファイルシステムに適した文字セットに変換します。

書き込みモードまたはコピー・モードで使用される場合、pax は、パス名全体を NULL 以外のポータブル文字セットのメンバーで表すことができない各リンクのリンク・パス拡張ヘッダー・レコードを組み込みます。

mtime

後に続くファイル (1 つまたは複数) のファイル修正時間。ファイルの stat 構造体の st_mtime メンバーの値と同じ。 このレコードは、後に続くヘッダー・ブロック (1 つまたは複数) の mtime フィールドをオーバーライドします。 変更時間は、そのプロセスに、復元するために適切な特権があれば復元されます。

path

後に続くファイル (1 つまたは複数) のパス名。 このレコードは、後に続くヘッダー・ブロック (1 つまたは複数) の name フィールドと prefix フィールドをオーバーライドします。 pax は、ファイルのパス名を、UTF8 エンコードからローカル・ファイルシステムに適した文字セットに変換します。 pax は、書き込みモードまたはコピー・モードで使用されると、パス名を NULL 以外のポータブル文字セットのメンバーだけで表すことができないファイルごとに、path 拡張ヘッダー・レコードを 1 つずつ組み込みます。

realtime.any

real time が接頭部として付いたキーワードは、将来の POSIX リアルタイム標準化のために予約されます。pax はそれらを認識しますが、何もせずに無視します。

security.any

security が接頭部として付いたキーワードは、将来の POSIX セキュリティー標準化のために予約されます。pax はそれらを認識しますが、何もせずに無視します。

size

オクテット単位でのファイルのサイズ。ISO/IEC 646 からの数字を使用する 10 進数で表されます。 このレコードは、後に続くヘッダー・ブロック (1 つまたは複数) の size フィールドをオーバーライドします。 pax は、書き込みモードまたはコピー・モードで使用されると、サイズ値が 999,999,999,999 を超えるファイルごとに、拡張ヘッダー・レコードのサイズを組み込みます。

uid

ファイルを所有するユーザーのユーザー ID。ISO/IEC 646 からの数字を使用する 10 進数で表されます。 このレコードは、後に続くヘッダー・ブロック (1 つまたは複数) の uid フィールドをオーバーライドします。 pax は、書き込みモードまたはコピー・モードで使用されると、オーナー ID が 99,999,999 を超えるファイルごとに、uid 拡張ヘッダー・レコードを 1 つずつ組み込みます。

uname

ユーザー・データベース内のユーザー名としてフォーマットされている、後に続くファイル (1 つまたは複数) のオーナー。 このレコードは、後に続くヘッダー・ブロックの uid フィールドと uname フィールド、および uid 拡張ヘッダー・レコードをオーバーライドします。 読み取り、コピー、またはリスト・モードで使用されると、pax は、ヘッダー・レコード内の UTF8 エンコードからの名前を、受信システム上のデータベースに適した文字セットに変換します。 いずれかの UTF8 文字が変換できない場合に、-o invalid=UTF8 オプションが指定されていないと、未定義の結果が生じます。 pax は、書き込みモードまたはコピー・モードで使用されると、ユーザー名がポータブル文字セットの文字と数字だけで表すことができないファイルごとに、uname 拡張ヘッダー・レコードを 1 つずつ組み込みます。

value フィールドの長さがゼロの場合、ヘッダー・ブロック・フィールド、以前に入力された拡張ヘッダー値、または同じ名前のグローバル拡張ヘッダー値のどれかが削除されます。

拡張ヘッダー・レコード (または -o オプションと引数の組の中) のキーワードが、ustar ヘッダー・ブロック内の対応するフィールドをオーバーライドまたは削除 すると、pax はそのヘッダー・ブロック・フィールドの内容を無視します。

拡張ヘッダー・キーワードの優先度

(-x pax フォーマットのみに適用されます。)

このセクションでは、さまざまなヘッダー・レコードとファイル、およびコマンド・ライン・オプションを、アーカイブ内のファイルに適用するように選択する場合の優先度について説明します。 pax は、読み取りモードまたはリスト・モードで使用すると、次のシーケンスでファイル属性を判別します。

1. -o delete=keyword-prefix が使用される場合、影響を受ける属性は、ステップ (7) が適用可能であればこのステップから判別されます。使用されない場合は無視されます。
2. -o keyword:=NULL が使用される場合、影響を受ける属性は無視されます。
3. -o keyword:=value が使用される場合、影響を受ける属性には値が割り当てられます。
4. ファイル特定の拡張ヘッダー・レコードに value が存在する場合、影響を受ける属性には値が割り当てられます。 拡張ヘッダー・レコード同士が競合する場合、ヘッダー内で最後に指定されたものが優先されます。
5. -o keyword=value が使用される場合、影響を受ける属性には値が割り当てられます。
6. グローバル拡張ヘッダー・レコードに値が存在する場合、影響を受ける属性には値が割り当てられます。 グローバル拡張ヘッダー・レコード同士が競合する場合、グローバル・ヘッダー内で最後に指定されたものが優先されます。
7. 上記以外の場合、属性は、ustar ヘッダー・ブロックから判別されます。

フラグの相互作用および処理順序

ファイルまたはアーカイブ・メンバーの名前で動作するフラグ (-c、-i、-n、-s、-u、および -v) は、以下のように相互作用します。

• ファイルを取り出す場合、アーカイブ・メンバー は、-c、-n、-u フラグで変更されたユーザー指定の pattern パラメーターに従って選択されます。 次に、-s および -i フラグは、その順序で、選択されたファイルの名前を変更します。 -v フラグは、それらの変更の結果作成された名前を書き込みます。
• ファイルをアーカイブ・ファイルに書き込む場合、またはファイルをコピーする場合は、-n フラグ (コピー・モードの場合はこのオプションは無効) と -u フラグで変更されたユーザー指定のパス名に従って、ファイルが選択されます。次に、-s および -i フラグは、その順序で、それらの変更の結果作成された名前を変更します。 -v フラグは、その変更の結果作成された名前を書き込みます。
• -u フラグと -n フラグの両方を指定すると、pax コマンドは、 選択したファイルがそれを比較するファイルより新しくない限り、そのファイルを選択されたものと見なしません。

リスト・モード・フォーマットの仕様

-o listopt=format オプションを指定したリスト・モードでは、 フォーマット引数は、選択された各ファイルごとに適用されます。 pax は、選択された各ファイルごとに listopt 出力に改行文字を追加します。 フォーマット引数は、printf() で説明されたフォーマット文字列として使用されますが、次の例外があります。

1. シーケンス keyword は、フォーマット変換指定子の前に置くことができます。 変換引数は、keyword の値によって定義されます。 サポートされるキーワードは次のとおりです。
   • ustar および cpio ヘッダー・ブロックの任意のフィールド名エントリー。
   • 拡張ヘッダーに定義された任意のキーワード、または拡張ヘッダー内の拡張として提供された任意のキーワード。

   例えば、シーケンス %(charset)s は、拡張ヘッダー内の文字セットの名前の文字列値です。

   キーワード変換引数の結果は、末尾 NULL のない、適用可能ヘッダー・フィールドまたは拡張ヘッダーからの値です。

   変換引数として使用されるキーワードと値の組はすべて、UTF8 エンコードから、適用可能なローカル・ファイルシステム、ユーザー・データベースなどに適した文字セットに変換されます。

2. 追加の変換文字 T は、時刻形式を指定します。 T 変換文字の前にはシーケンス keyword=subformat を付けることができます。この場合、subformat は、date コマンドによって許可された日付形式です。 デフォルト・キーワードは mtime で、デフォルト・サブフォーマットは %b %e %H:%M %Y です。
3. 追加の変換文字 M は、ls -l コマンドによって表示されるファイル・モード文字列を指定します。 keyword を省略すると、mode キーワードが使用されます。 例えば、%.1M は、ls -l コマンドの entry type フィールドに対応する 1 文字を書き込みます。
4. 追加の変換文字 D は、ブロックまたはスペシャル・ファイルが適用可能であれば、そのデバイスを指定します。 これが適用可能でない場合に keyword を指定すると、この変換は %keyword u と同じになります。適用可能でない場合に keyword を指定しないなら、この変換は <スペース> と同じになります。
5. 追加の変換文字 F は、パス名を指定します。 F 変換文字の前には、コンマで区切られたキーワードのシーケンスを付けることができます。

   keyword,keyword...

   null でない全キーワードの値は連結され、それぞれが / で区切られます。 デフォルトは、キーワード・パスが定義されている場合は path です。 それ以外の場合、デフォルトは prefix,name です。

6. 追加の変換文字 L は、シンボリック・リンク拡張を指定します。 現在のファイルがシンボリック・リンクである場合、%L は次のように拡張されます。

   "%s -> %s", value_of_keyword, contents_of_link

   シンボリック・リンクでない場合、%L 変換文字は %F と同じです。

終了状況

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

セキュリティー

RBAC ユーザーおよび Trusted AIX ユーザーへの注意: このコマンドは特権操作を実行できます。特権命令を実行できるのは特権ユーザーのみです。 権限および特権について詳しくは、「セキュリティー」の『特権コマンド・データベース』を参照してください。このコマンドに関連した特権および権限のリストについては、lssecattr コマンドまたは getcmdattr サブコマンドの項を参照してください。

例

1. olddir ディレクトリー階層を newdir にコピーするには、以下のように入力します。

   mkdir newdir

   pax -rw olddir newdir

2. 現行ディレクトリーの内容をテープ・ドライブにコピーするには、以下のように入力します。

   pax -wf /dev/rmt0

3. ファイル xxx を XXX としてアーカイブし、正常に置き換えられたものを表示するには、以下のいずれかのコマンドを入力します。

   • pax -wvf/dev/rfd0 -s /xxx/XXX/p xxx

   • pax -wvf/dev/rfd0 -s/x/X/gp xxx

4. 標準入力からファイルを読み、指定したサイズでデータ・ストリーム・ファイルにダンプするには、以下のように入力します。

   dd if=/dev/hd6 bs=36b count=480 | pax -wf /dev/rfd0 -o
   datastream=_filename_,datastr_size=_size_

5. アーカイブ pax.ar の中のファイルを指定した形式でリスト表示するには、次のように入力します。

   pax -v -o listopt="start %F end" -f pax.ar

6. pax 形式のアーカイブ pax.ar を作成するには、次のように入力します。

   pax -wf pax.ar -x pax file1

7. pax 形式のアーカイブ pax.ar から新しいパスにファイルを抽出するには、次のように入力します。

   pax -rvf pax.ar -x pax -o path=newfilename

8. シンボリック・リンクの内容を、ソースから宛先にコピーするには、次のように入力します。

   pax -rwL srclink destdir

9. アーカイブからグループ名 bin のファイルを抽出するには、次のように入力します。

   pax -rvf pax.ar -x pax -o gname=bin

10. pax 形式のアーカイブからの抽出において、パス名を無視するには、次のように入力します。

    pax -rvf pax.ar -o delete=path

11. アーカイブの作成時に、長いユーザー名およびグループ名が切り捨てられないようにするには、 次のように入力します。

    pax -wEf file.pax file

12. olddir ディレクトリー階層を、ファイルに関連する ACL および EA 付き で newdir にコピーするには、次のように入力します。

    mkdir newdir
    
    pax -rUw olddir newdir

ファイル