TAR(1)

FreeBSD General Commands Manual

TAR(1)

名称

tar — テープアーカイブを操作する

書式

tar	[ bundled-flags <args>][ < file> \| < pattern> ...]

tar	{ -c}[ options][ files \| directories]

tar	{ -r \| -u} -f archive-file [ options][ files \| directories]

tar	{ -t \| -x}[ options][ patterns]

解説

tar は、ストリーミングアーカイブファイルを作成して、操作します。この実装は、 tar, pax, cpio, zip, jar, ar, xar, rpm, 7-zip と ISO 9660 cdrom イメージから抽出することができ、 tar, pax, cpio, ar, zip, 7-zip shar アーカイブを作成することができます。

最初の書式の形式は、“バンドルされた” (bundled) オプションの単語を示します。この使用法は、歴史的な実装との互換性のために提供されています。詳細については、下記の「互換性」を参照してください。

その他の書式の形式は、好ましい使用法を示します。 tar への最初のオプションは、次のリストのモード指示子です:

-c, -r, -u モードにおいて、指定されたファイルまたはディレクトリは、コマンドラインで指定された順にアーカイブに追加されます。デフォルトでは、各ディレクトリ内のファイルもアーカイブされます。

展開またはリストモードでは、アーカイブをオープンする前にコマンドライン全体が読み込まれ、解析されます。コマンドラインのパス名またはパターンは、アーカイブ内の処理対象となるアイテムを示します。パターンは、シェル形式のグロブパターンであり、 tcsh(1) に文書化されています。

オプション

明記していないオプションは、全ての操作モードに適用可能です。

環境変数

次の環境変数が、 tar の実行に関係します:

終了ステータス

The tar utility exits 0 on success, and >0 if an error occurs.

使用例

二つのファイル source.c と source.h を含む新しいアーカイブ file.tar.gz を作成します:

tar -czf file.tar.gz source.c source.h

アーカイブの詳細な内容一覧を表示します:

tar -tvf file.tar.gz

デフォルトのテープドライブにあるアーカイブの、全てのエントリを展開します:

tar -x

ISO9660 cdrom イメージの内容を調べるためには:

tar -tf image.iso

ファイル階層を移動するには、 tar を

tar -cf - -C srcdir . | tar -xpf - -C destdir

またはより伝統的な

cd srcdir ; tar -cf - . | ( cd destdir ; tar -xpf -)

として実行します。

作成モードにおいて、アーカイブされるファイルとディレクトリのリストには、 -Cfoo/baz の形式でディレクトリの変更命令を取り込めます。また @archive-file の形式でアーカイブのエントリを取り込むこともできます。例えば、次のコマンドライン

tar -c -f new.tar foo1 @old.tgz -C/tmp foo2

では、新しいアーカイブ new.tar を作成します。 tar は、カレントディレクトリからファイル foo1 を読み込み、出力するアーカイブに追加します。次に old.tgz の各エントリを読み込み、これらのエントリを、出力するアーカイブに追加します。最後にディレクトリを /tmp に変更し、 foo2 を出力するアーカイブに追加します。

ディスク上の既存のデータと異なっている、任意の所有権、パーミッション、または名前で出力アーカイブを作成するために mtree(5) 形式の入力ファイルを使用することができます:

$ cat input.mtree

#mtree

usr/bin uid=0 gid=0 mode=0755 type=dir

usr/bin/ls uid=0 gid=0 mode=0755 type=file content=myls

$ tar -cvf output.tar @input.mtree

--newer と --newer-mtime スイッチは、“12 Mar 2005 7:14:29pm”, “2005-03-12 19:14”, “5 minutes ago”, “19:14 PST May 1”を含む、さまざまな一般的な日付及び時間指定法を受け付けます。

アーカイブの様々な詳細を生成するか、または読み込みを制御するために --options 引数を使用することできます。例えば、利用者は、 type, time と uid キーワードだけを含む mtree 出力を生成することができます:

tar -cf file.tar --format=mtree --options='!all,type,time,uid' dir

または、利用者は、gzip または xz 圧縮で使用される圧縮レベルを設定することができます:

tar -czf file.tar --options='compression-level=9'.

その他の詳細については、 archive_read(3) と archive_write(3) で説明される archive_read_set_options() と archive_write_set_options() API 呼び出しの説明を参照してください。

互換性

まとめオプション形式は、これまでの実装との互換性のためにサポートされています。これには、各文字がオプションである頭文字 (- 文字で始まらない) が存在します。引数は、別々の単語として続きます。この引数の順序は、まとめオプション文字内の、対応する文字の順序と一致している必要があります。例えば

tar tbf 32 file.tar

では、三つのフラグ t, b, と f を指定しています。 b と f フラグは、共に引数が必要ですので、二つの追加アイテムがコマンドラインに必要です。 32 は、 b フラグに対する引数であり、また file.tar は、 f フラグに対する引数です。

モードオプションの c, r, t, u, x、およびオプションの b, f, l, m, o, v, w は、SUSv2 に適合しています。

移植性を最大限にするために、 tar を実行するスクリプトは、上記のまとめオプション形式を使うべきであり、モードオプションは、 c, t, x に、またオプションは、 b, f, m, v, w に限定するべきです。

追加のロングオプションは、他の tar 実装との互換性を強化するために提供されています。

セキュリティ

確実なセキュリティは、 tar を含む沢山のアーカイブプログラムに共通の課題です。特に、注意深く細工されたアーカイブは、 tar に対して、対象とするディレクトリ以外の場所にファイルを展開するように要求することができます。これは、不注意なユーザに対し、上書きするつもりのないファイルを上書きさせられる可能性があります。アーカイブをスーパユーザが展開している場合は、システム上のあらゆるファイルが上書きさせられる可能性があります。これを引き起こす、三つの手段があります。 tar は、それぞれに対する防御機構を備えていますが、情報通のユーザならば、それらの意味するところを知っておくべきでしょう:

アーカイブのエントリは、絶対パス名を持つことができます。デフォルトでは、 tar は、この問題に対する防御策として、これらをリストアする前にファイル名の先頭にある / 文字を取り除きます。
アーカイブのエントリは、 .. を含むパス名を持つことができます。デフォルトでは、 tar は、パス名に .. を含んでいるファイルを展開しません。
アーカイブのエントリでは、ファイルを別のディレクトリにリストアするように、シンボリックリンクを悪用することができます。アーカイブは、別のディレクトリを指すシンボリックリンクをリストアすることができ、このリンクを使ってファイルをそのディレクトリにリストアします。これを防ぐため、 tar では毎回、展開されるパスにシンボリックリンクが含まれるかどうかを調べます。もしパスの最後の要素がシンボリックリンクであれば、そのシンボリックリンクは、削除され、アーカイブの内容に置き換えられます。 -U が指定されていれば、展開されるパスの中間に存在するシンボリックリンクも、すべて無条件に削除されます。もし -U も -P も指定しなければ、 tar は、このようなエントリを展開するのを拒否します。

あなた自身を守るため、信用できない出処からのアーカイブには、気をつけるべきです。アーカイブを展開する前に、

tar -tf filename

としてアーカイブの内容を調べるべきです。 tar に -k オプションをつけて既存のファイルを上書きしないことを保証させるか、 -U オプションをつけて既存のファイルを削除させるべきです。一般に、スーパユーザ権限にある時は、アーカイブを展開するべきではありません。なお -P オプションにより、 tar は、上に述べたセキュリティチェックを行わないようになり、絶対パスや .. を含むファイル、及び他のディレクトリへのシンボリックリンクを展開できるようになることに注意してください。

規格

現在、tar コマンドに対する POSIX 標準はありません。 ISO/IEC 9945-1:1996 (“POSIX.1”) には、ありましたが、 IEEE Std 1003.1-2001 (“POSIX.1”) ではなくなりました。この実装でサポートされているオプションは、現存するいくつかの tar 実装と同様、 tar の古い POSIX 仕様、pax の現在の POSIX 仕様を調査して開発されました。

ustar と pax 間のファイルフォーマット変換については、pax コマンドの IEEE Std 1003.1-2001 (“POSIX.1”) にて定義されています。

歴史

tar コマンドは、1979 年 1 月にリリースされた Seventh Edition Unix で登場しました。他に多数の実装があり、その多くは、ファイルフォーマットを拡張しています。 John Gilmore によるパブリックドメイン実装の pdtar (1987 年 11 月頃) は、多大な影響を及ぼし、GNU tar の元になりました。 GNU tar は、 FreeBSD 1.0 で始まった FreeBSD の基本システムの tar として取り込まれました。

本ソフトウェアは、 libarchive(3) ライブラリをベースにした、完全な再実装です。それは、2005 年 5 月に FreeBSD 5.4 ではじめてリリースされました。

バグ

このプログラムは、 -l オプションの定義で ISO/IEC 9945-1:1996 (“POSIX.1”) に従います。バージョン 1.15 より前の GNU tar は、 - -one-file-system オプションの同義語として -l を扱ったことに注意してください。

-C dir オプションは、歴史的な実装とは異なっているでしょう。

全てのアーカイブ出力は、出力を圧縮していても、正しいサイズのブロックで書き込まれます。最後の出力ブロックがブロックサイズの大きさにパディングされるかどうかは、フォーマットと出力デバイスによって変わります。 tar と cpio フォーマットにおいて、出力が標準出力、キャラクタ型デバイス、もしくはテープドライブのようなブロック型デバイスの場合、出力の最後のブロックは、ブロックサイズの大きさにパディングされます。出力を通常ファイルに書き込む場合、最後のブロックは、パディングされません。 gzip(1) や bzip2(1) を含む多数の圧縮ソフトウェアは、 tar で作成されたアーカイブを復元する時、このヌルパディングについて文句を言いますが展開は、正常に行えます。

圧縮と復元機能は、内部で実装されているので、

tar -czf - file

により作成した圧縮出力と、

tar -cf - file | gzip

により作成した圧縮出力には、些細な違いがあるかもしれません。

デフォルトでは、標準の I/O パスでアーカイブを読み書きするべきですが、伝統的に (と POSIX では) 他のものを規定しています。

r と u モードでは、アーカイブは、非圧縮でディスク上に通常ファイルとして存在する必要があります。そうではないアーカイブは、 c モードと @archive-file 拡張を用いて更新できます。

@foo や -foo といった名前のファイルをアーカイブするには、それぞれ ./@foo や ./-foo という形式で指定する必要があります。

作成モードにおいて、先頭にある ./ は、常に削除されます。先頭にある / は、 -P オプションが指定されない限り、取り除かれます。

作成及び展開における、ファイル選択のよりよいサポートが必要です。

マルチボリュームアーカイブ、および疎なファイルに対するサポートは、まだありません。

似ていないアーカイブフォーマット間 (tar と cpio など) で @- により変換すると、ハードリンク情報が失われます (これは、異なるアーカイブフォーマットでハードリンク情報を互換性のない形で格納していることからくる当然の結果です)。

November 1, 2012

FreeBSD

YOS OPENSONAR

名称

書式

解説

オプション

環境変数

終了ステータス

使用例

互換性

セキュリティ

関連項目

規格

歴史

バグ