tar - ファイルのコピーまたはバックアップを作成するために tar アーカイブ・ファイルを操作する

構文に示されているコマンドの 4 つの形式は、次のような tar の 主要機能を表しています。

–c

アーカイブを作成します。指定した各ファイルを新しく作成した アーカイブに書き込みます。ディレクトリーは、すべてのコンポーネントを再帰的に組み込みます。USTAR (–U) オプションの下では、tar は、ディレクトリーおよびテープ・アーカイブ内の他のスペシャル・ファイルを記録します。それ以外の場合は、そのようなファイルを無視します。ファイル名の代わりに – があると 、tar は標準入力からファイルのリストを 1 行に 1 つ読み取りま す。これにより 、tar がアーカイブするファイルのリストを他のコマンドで生成することが可能になります。

ヒント: 拡張属性および外部リンクに関する情報を 保存するには、USTAR フォーマット (-U) を使用する必要があります。さらに、ACL、ファイル・タグ情報、 および 100 文字を超えるリンク名を保存するには、USTAR フォーマット (-U) と -X オプションを 使用する必要があります。-S オプションを使用して、OS390 アーカイブ・フォーマットでもすべてのファイル属性 を保管することができます。

–r

指定したファイルをアーカイブの終わりに書き込みます。この方式を使用すると 、1 つのファイルのコピーをテープ・アーカイブ内に複数 持つことが可能です。コマンドのこの形式をテープで使用するには、テープをバックスペースできることが必要です。OS390 フォーマットを非 OS390 フォーマットのアーカイブに追加する指定や、非 OS390 フォーマットを OS390 フォーマットのアーカイブに追加する指定はできません。

制約事項: –r オプションと –z オプションを両方同時に指定することはできません。

–t

目次を表示します。このオプションは、アーカイブ内のすべてのファイルの名前を、1 行 に 1 つ、表示します。コマンド行で 1 つまたは複数のファイルを指定すると 、tar は指定したファイル名のみを出力します。詳細 (-v) オプションを使用すると、 各コンポーネントの属性を表示することができます。USTAR フォーマットのアーカイブ、 または OS390 フォーマットのアーカイブの場合は、-L E オプションを使用すると、 各コンポーネントの属性と拡張属性を表示することができます。

–x

アーカイブからファイルを抽出します。tar は、指定されたファイルを同じ名前のファイルに抽出し ます。コマンド行でファイルを指定しなかった場合、アーカイブ内のすべてのファイルが抽出され ます。この抽出により、すべてのファイル・システム属性は、他のオプションによって 制御されるように、復元されます。

基本オプションの 1 つをオプション・ストリングの先頭文字として 指定する 必要があります。他の文字をオプション・ストリングに追加することができます。最初のオプション・ストリングの先行ダッシュを省略できますが、すべての後続のオプションの前にはダッシュを付ける必要があります。 オプション・ストリングに使用可能な他のオプションは以下のとおりです。

-A

–x オプションを指定して使用されたときは ACL 情報を復元します。

-b

テープ・アーカイブの読み取り/書き込み操作に使用する 512 バイト・ブロックの数 を、blocksize に設定します。blocksize 引数は必ず指定する必要があります。blocksize が指定できるのは、b がオプション・ストリングにある場合のみです。テープ・アーカイブから 読み取る際、tar は、許される最大のブロック化因数を読み取ろうと試み、読み取った実際の数を blocksize として使用することによって、自動的にブロック化因数を判別します。

UNIX 互換の場合、有効な最大ブロック・サイズは 20 ブロックです。USTAR モードでは、63 ブロックになります。

–C pathname

オプションとしては変わっています。ファイル・リストの真ん中に指定されるからです。tar がファイルをアーカイブしている 最中に –C pathname オプションに出会うと、作業ディレクトリー (tar 専用) を pathname に変更し、ファイル・リスト内の後続入力のすべて (別の –C を含む) を pathname に対して 相対であるとして扱います。

–E

以前のバージョンのtar との互換性はまだサポートされていますが、 このオプションは –L E で置き換えられました。

-f

-f を指定する必要があります。-f オプションでは、ファイル tarfile をテープ・アーカイブ用に使用し、デフォルトは使用しません。tarfile 引数は必ず指定する必要がありますが 、tarfile が指定できるのは、-f がオプション・ストリング内にある場合のみ です。両方がある場合、tarfile 引数は blocksize 引数の前に置く必要があります。tarfile が文字 – の場合、アーカイブ・フォーマットのデフォルトは USTAR となり、標準入力がアーカイブ読み取りに、標準出力がアーカイブ書き込みに使用されます。

-l

テープ・アーカイブにファイルを追加中に、リンクがすべて解決されない場合、エラー・メッセージを書き込みます。

–L type

–L により、アーカイブの内容をリスト時に追加情報が 表示されます。–L オプションにつき 1 つのタイプのみ 指定できます。ただし、–L は複数回指定できます。表示可能なタイプは以下のとおりです。

A

拡張 ACL (アクセス制御リスト) データを表示します。

tar –L A を指定しても、詳細な目次形式は自動的にオンになりません。ファイルと関連した chmod 設定を表示するには、–v も 指定する必要があります。

ACL について詳しくは、「z/OS UNIX System Services 計画」のアクセス制御リストの制御に関するセクション、および アクセス制御リスト (ACL) の tar サポートを参照してください。

E

詳細 (–v) 出力と同じですが、さらに拡張属性も表示します。詳細は、出力を参照してください。 –L E は tar –E と同じです。

T

ファイル・タグ情報を表示します。詳細 –v オプションを自動的にオンにしませんが 、–v または目次の表示オプションとの他の任意の組み合わせと一緒に使用できます。詳細は、出力を参照してください。

-m

アーカイブから抽出する際、ファイルの変更タイム・スタンプを 復元しません。デフォルトでは、アーカイブに含まれている情報からタイム・スタンプを復元することになっています。

-o

アーカイブにファイルを書き込む際、アーカイブ内の所有者およびディレクトリーの モードを記録しません。既存の tar アーカイブから抽出する際にこれが指定されている と、tar はアーカイブ内の所有者およびグループ情報を何も復元しません。デフォルトは、tar アーカイブを作成する際にこの情報を記録し、アーカイブから抽出する際に復元することです。

–O

USTAR フォーマットのアーカイブの場合、このオプションは拡張 USTAR サポートを オフにします。-O はデフォルトであり、ユーザーは USTAR アーカイブ用に拡張 USTAR サポートを オンにするには、-X オプションを使用する必要があります。

詳しくは、z/OS 拡張 USTAR サポートを参照してください。

-p

抽出するとき、3 つの高順位ファイル許可ビットを アーカイブと正確に同じに復元します。ビットはそれぞれ、セット・ユーザー ID、セット・グループ ID、および スティッキー・ビットを示します。USTAR フォーマットのアーカイブの場合、p も拡張属性 (存在していれば) を 復元し、-A は ACL を復元します。

ヒント: -O が指定されている場合、 それは拡張属性に対して -p をオーバーライドします。 拡張属性は復元されません。tar は、 アーカイブに格納された通りにモードを復元し、UMASK を無視します。 UNIX システムで -p を使用するには、適切な権限を持っている必要 があります。tar は、モードを正確にアーカイブにある 通りに復元し、UMASK は無視します。

-#s

-#s は、z/OS UNIX に よってサポートされません。tar が 使用するデフォルトの アーカイブ・ファイル名は、/dev/mt/0m です。 このオプションは、このデフォルトを変更するには、最も一般的ではない方法です。もっと一般的な方法については、-f オプションを参照して ください。このオプションによって生成されるファイル名の 形式は、/dev/mt/#s です。# は、0 と 7 を含む、0 と 7 の間の任意の数字で、磁気テープ装置を選択するのに使用します。密度セレクター s は、l (低)、m (中)、または h (高) のいずれかです。

-S

tar に OS390 フォーマットを使用するように強制します。OS390 フォーマットは、デフォルトですべてのファイル属性を保管するためのサポートを提供します。

–X

USTAR フォーマットのアーカイブの場合、–X は拡張 USTAR サポート を使用可能にします。このオプションは、USTAR フォーマット以外のアーカイブには影響を与えません。tar –X は、次のように機能します。

• アーカイブの書き込み時には、-X が指定されていると、tar は拡張 USTAR 情報を保存します。
• アーカイブのリスト時には、-X が指定されていると、tar は USTAR 情報を表示します。これはデフォルトです。-O を使用すれば、拡張 USTAR サポートを使用不可にできます。
• アーカイブの読み取り中に、-X が指定されていると、tar は拡張 USTAR 情報を復元します。これはデフォルトです。-O を使用すれば、拡張 USTAR サポートを使用不可にできます。

  環境変数 _OS390_USTAR=Y も、 拡張 USTAR 情報をオンにします。

ある特定の情報を復元するには、ユーザーは該当する権限も持っ ていなければならず、さらに対応するオプションを指定している必要があり ます。例えば、 拡張属性を復元し、ACL を復元するには、–p を指定する必要があります。

拡張属性の詳細については、z/OS 拡張 USTAR サポートを参照してください。

-U

新しいテープ・アーカイブを –c オプションで作成する際 、tar が USTAR フォーマットを使用するようにします。新しいアーカイブを作成する際に使用される デフォルトのフォーマットは、元の UNIX tar フォーマットです。–c を指定しない場合、tar はテープ・アーカイブを読み 取り、それが USTAR フォーマットであるかどうかを推測することができます。したがって、U を使用し て USTAR フォーマットについての警告を抑制することができます。

外部リンク、 拡張属性、ファイル・タグ情報、ACL を保管するには、拡張 USTAR フォーマットを 使用する必要があります。拡張 USTAR フォーマットをオンにするには、-U と -X オプションを 指定する必要があります。OS390 フォーマットを使用して (-S オプション)、 デフォルトですべてのファイル属性を保管することもできます。

-v

それぞれのファイル名を、アーカイブを処理する度に、適切なアクション・ キー文字と共に表示します。コマンドの –t 形式と共に、このオプション は、リストするアーカイブ・メンバーそれぞれについての詳細を提供 し、ls –l コマンドによって使用される形式と同じ形式で、メンバーに関する 情報を示します。–L type オプションも使用することができます。このオプションにより、拡張属性やファイル・タグ情報などの追加情報を表示できる ようになります。詳細は、出力を参照してください。

–V volpat

自動マルチボリューム・サポートを提供します。tar は、出力をファイルに書き込みます。ファイルの名前は、volpat を使ってフォーマットされています。volpat 内の # のオカレンスはすべて、現行のボリューム番号で置き換えられます。tar は、このオプション付きで呼び出されると、アーカイブ・セットの 最初の番号を入力するようにプロンプトを出し、数値とキャリッジ・リターン が入力されるまで待ってから、次の操作に進みます。tar はアーカイブで読み取りエラーまたは書き込みエラーが起きた場合、同じ種類のメッセージを出します。この種類のエラーは、tar がボリュームの終わりに 到達したので、新規のボリュームに進む必要があることを意味します。

-w

置換、抽出などの各操作を確認するために使用されます。tar は、関係した操作とファイルを表示します。ユーザーは次に、操作を行うかどうかを確認することができます。“y” で始まる応答を入力すると、tar に その操作を行うように命じることになります。その他の応答は、tar にその次の操作に進むように指示することになります。

-z

テープ・アーカイブの読み取りまたは書き込み、または読み取りおよび書き込み を、compress と互換性のある圧縮アルゴリズムを最初にパスすることによって行います。

制約事項: –r オプションと –z オプションを両方同時に指定することはできません。

–t (目次) と共に –v または –L E (または–E) オプションを 使用すると、tar はアーカイブの詳細な目次を作成します。–L T オプションは さらに、ファイル・タグ情報を表示するのにも使用するか、または詳細出力なしに使用できます。 –v の出力は、以下の例外を除いて、ls –l コマンドからの出力と同じ です。

• ハード・リンク、シンボリック・リンク、および外部リンクを表すために、以下の表記を使用します。

  hlink external link to origfile

  これは hlink が origfile への ハード・リンクであることを示します。

  slink symbolic link to origfile

  これは、slink が origfile への シンボリック・リンクであることを示します。

  elink external link to ORIG.FILE

  これは elink が ORIG.FILE への 外部リンクであることを示します。
• シンボリック・リンクおよび外部リンクの場合、pax 出力は常に 0 のファイル・サイズ を示します。

ls –v の説明については、ls の説明を参照してください。

–L E (または –E) オプションからの出力は、–v と 同じフォーマットですが、さらに次の拡張属性を示す欄を表示します。

a

プログラムは AC=1 でリンクされていれば APF 許可で実行されます。

p

プログラムはプログラム制御であるととられます。

s

プログラムは共用アドレス・スペースで実行されます。

l

プログラムは共用ライブラリー領域からロードされます。

注: l は、i の大文字ではなく、L の小文字です。

–

属性は設定されていません。

tar –L E (または –E) 出力のフォーマットは可変長であり 、tar –v (ls –l) ではサポートされない追加のファイル特性を 表示するために必要に応じて拡張されます。

tar –L T の出力形式は、chtag –p からの 出力に類似しています。–v または –L E と一緒に指定すると、その出力は –v 出力と同一行上でその前に表示されます。–v を指定せずに使用した場合、ファイル・タグ情報とファイル名だけが 表示されます。例えば、以下のとおりです。

/tmp> tar -L T -tf asciitagged.tar
m ISO8859-1   T=off text_am
t ISO8859-1   T=on  text_at
- untagged    T=off text_au

このオプションは、–v または –o E のいずれか (あるいは両方) と一緒に使用されて、追加の詳細出力を表示します。例えば、以下のとおりです。

/tmp> tar -L T -tvf asciitagged.tar
m ISO8859-1  T=off -rw-r--r--  1 SteveS  Kings   9 Apr 30 22:31 text_am
t ISO8859-1  T=on  -rw r--r--  1 SteveS  Kings   9 Apr 30 22:31 text_at
- untagged   T=off -rw-r--r--  1 SteveS  Kings   9 Apr 30 22:06 text_au

tar は、以下のローカライズ環境変数を使用します。

• LANG
• LC_ALL
• LC_MESSAGES
• NLSPATH

0

正常終了

1

以下のいずれかによる失敗。

• オプションが正しくない
• コマンド行の引数が正しくない
• メモリー不足
• 圧縮エラー
• 抽出の失敗
• 作成の失敗