Man page - tar(1)

Packages contains this manual

Package:  tar
apt-get install tar

Manuals in package:
• rmt-tar(8)
• tar(1)
• tarcat(1)
Documentations in package:
• tar

Available languages:

en fr es pl nl da tr ja uk ro zh_TW zh_CN de

Manual

TAR

名 前
書 式
伝 統 的 な 使 用 法
UNIX ス タ イ ル の 使 用 法
GNU ス タ イ ル の 使 用 法
注 記
説 明
オ プ シ ョ ン 形 式
操 作 モ ー ド
オ プ シ ョ ン
操 作 の 調 節
上 書 き の 制 御
出 力 ス ト リ ー ム に 関 す る 選 択
フ ァ イ ル 属 性 の 操 作
拡 張 フ ァ イ ル 属 性
デ バ イ ス の 選 択 と 交 換
レ コ ー ド と ブ ロ ッ ク (Device blocking)
ア ー カ イ ブ 形 式 の 選 択
圧 縮 オ プ シ ョ ン
ロ ー カ ル フ ァ イ ル の 選 択
フ ァ イ ル 名 の 変 更
フ ァ イ ル 名 の マ ッ チ ン グ に 関 す る オ プ シ ョ ン
情 報 出 力
互 換 オ プ シ ョ ン
サ イ ズ 接 尾 辞
返 り 値
関 連 項 目
バ グ 報 告
著 作 権

---

名 前

tar - ア ー カ イ ブ ユ ー テ ィ リ テ ィ

書 式

伝 統 的 な 使 用 法

tar { A | c | d | r | t | u | x }[ GnSkUWOmpsMBiajJzZhPlRvwo ] [ ARG ...]

UNIX ス タ イ ル の 使 用 法

tar -A [ OPTIONS ] ARCHIVE ARCHIVE

tar -c [ -f ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar -d [ -f ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar -t [ -f ARCHIVE ] [ OPTIONS ] [ MEMBER ...]

tar -r [ -f ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar -u [ -f ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar -x [ -f ARCHIVE ] [ OPTIONS ] [ MEMBER ...]

GNU ス タ イ ル の 使 用 法

tar { --catenate | --concatenate } [ OPTIONS ] ARCHIVE ARCHIVE

tar --create [ --file ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar { --diff | --compare } [ --file ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar --delete [ --file ARCHIVE ] [ OPTIONS ] [ MEMBER ...]

tar --append [ -f ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar --list [ -f ARCHIVE ] [ OPTIONS ] [ MEMBER ...]

tar --test-label [ --file ARCHIVE ] [ OPTIONS ] [ LABEL ...]

tar --update [ --file ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar --update [ -f ARCHIVE ] [ OPTIONS ] [ FILE ...]

tar { --extract | --get } [ -f ARCHIVE ] [ OPTIONS ] [ MEMBER ...]

注 記

こ の マ ニ ュ ア ル ペ ー ジ は GNU tar の 簡 単 な 説 明 で す 。 使 用 例 や 推 奨 さ れ る 使 い 方 を 含 む 詳 し い 議 論 に つ い て は 、 texinfo 形 式 の GNU Tar Manual を 見 て く だ さ い 。 info リ ー ダ ー と tar 関 連 文 書 が 御 使 用 の シ ス テ ム に 正 し く イ ン ス ト ー ル さ れ て い る な ら 、 コ マ ン ド

info tar

で 詳 細 な マ ニ ュ ア ル が 読 め る は ず で す 。

詳 細 な マ ニ ュ ア ル は 、 emacs (1) の info モ ー ド で も 閲 覧 す る こ と が で き ま す 。 ま た 、 下 記 の サ イ ト に 行 け ば 、 様 々 な 形 式 に し た 詳 細 マ ニ ュ ア ル の オ ン ラ イ ン 版 を 見 つ け る こ と が で き ま す 。

http://www.gnu.org/software/tar/manual

こ の マ ニ ュ ア ル ペ ー ジ と GNU Tar Manual の 内 容 に 食 い 違 い が あ る 場 合 は 、 後 者 の 方 が 信 頼 で き る 情 報 源 で す 。

説 明

GNU tar は 、 ア ー カ イ ブ プ ロ グ ラ ム で す 。 ア ー カ イ ブ プ ロ グ ラ ム と は 、 複 数 の フ ァ イ ル を 1 個 の フ ァ イ ル ( ア ー カ イ ブ ) に 格 納 し た り 、 そ う し た ア ー カ イ ブ を 操 作 し た り す る た め の プ ロ グ ラ ム で す 。 ア ー カ イ ブ は 、 通 常 フ ァ イ ル で あ っ て も よ く 、 デ バ イ ス で も か ま い ま せ ん (後 者 の 一 例 が テ ー プ ド ラ イ ブ で あ り 、 こ の プ ロ グ ラ ム の 名 前 は 、 そ こ か ら 来 て い ま す 。 す な わ ち 、 t ape ar chiver と い う こ と で す )。 そ う し た フ ァ イ ル や デ バ イ ス は 、 ロ ー カ ル マ シ ン に あ っ て も よ く 、 リ モ ー ト マ シ ン に あ っ て も か ま い ま せ ん 。

オ プ シ ョ ン 形 式

GNU tar の オ プ シ ョ ン は 、 3 つ の 異 な る 形 式 で 指 定 で き ま す 。 伝 統 的 な ス タ イ ル で は 、 最 初 の 引 数 は 、 オ プ シ ョ ン 文 字 の 集 ま り で あ り 、 そ れ に 続 く す べ て の 引 数 は 、 そ う し た オ プ シ ョ ン が 引 数 を 要 求 す る 場 合 に 、 そ の 引 数 に な り ま す 。 な お 、 そ う し た 引 数 は 、 オ プ シ ョ ン 文 字 と 同 じ 順 番 で 読 み 込 ま れ ま す 。 す べ て の オ プ シ ョ ン の 処 理 が 終 わ っ た 後 で 、 コ マ ン ド ラ イ ン に 残 っ て い る 単 語 が あ れ ば 、 そ れ は 、 オ プ シ ョ ン と は 関 係 の な い 引 数 と し て 扱 わ れ ま す 。 す な わ ち 、 フ ァ イ ル や ア ー カ イ ブ メ ン バ ー の 名 前 で す 。

た と え ば 、 c オ プ シ ョ ン は 、 ア ー カ イ ブ の 作 成 を 指 示 し 、 v オ プ シ ョ ン は 、 や っ て い る こ と を 表 示 す る よ う に 要 求 し 、 f オ プ シ ョ ン は 、 操 作 対 象 の ア ー カ イ ブ 名 を 引 数 に 取 り ま す 。 伝 統 的 な ス タ イ ル で 書 か れ た 次 の コ マ ン ド は 、 デ ィ レ ク ト リ /etc の す べ て の フ ァ イ ル を ア ー カ イ ブ フ ァ イ ル etc.tar に 格 納 し 、 ど ん な フ ァ イ ル を ア ー カ イ ブ に 入 れ た か 、 詳 し い リ ス ト を 表 示 す る よ う に tar に 指 示 し て い ま す 。

tar cfv etc.tar /etc

UNIX ス タ イ ル 、 す な わ ち 短 い オ プ シ ョ ン 形 式 で は 、 他 の コ マ ン ド ラ イ ン ユ ー テ ィ リ テ ィ と 同 様 に 、 各 オ プ シ ョ ン 文 字 に は 、 1 個 の ダ ッ シ ュ が そ の 前 に 付 き ま す 。 オ プ シ ョ ン が 引 数 を 取 る 場 合 は 、 引 数 は そ の 後 に 続 き ま す 。 引 数 は 、 コ マ ン ド ラ イ ン 上 の 独 立 し た 単 語 と し て オ プ シ ョ ン と の 間 に ス ペ ー ス を 置 い て 指 定 し て も よ く 、 ス ペ ー ス を 挟 ま ず オ プ シ ョ ン に 直 接 続 け て も か ま い ま せ ん 。 た だ し 、 オ プ シ ョ ン の 引 数 が 任 意 で あ る (訳 注 : あ る こ と も 、 な い こ と も あ る ) 場 合 は 、 そ の 引 数 は -g/tmp/snar.db の よ う に 、 オ プ シ ョ ン 文 字 の 後 に ス ペ ー ス な し で 続 け な け れ ば な り ま せ ん 。

引 数 を と ら な い オ プ シ ョ ン は 、 1 個 の ダ ッ シ ュ の 後 に 何 個 で も ま と め て 指 定 で き ま す 。 た と え ば 、 -vkp の よ う に で す 。 引 数 を (必 須 で あ れ 任 意 で あ れ ) 取 る オ プ シ ョ ン が あ っ た ら 、 ひ と つ に ま と め た オ プ シ ョ ン の 最 後 に 置 き ま す 。 -vkpf a.tar が そ の 一 例 で す 。

上 で 例 示 し た コ マ ン ド は 、 短 い オ プ シ ョ ン 形 式 で 書 け ば 、 以 下 の よ う に な り ま す 。

tar -cvf etc.tar /etc
ま た は
tar -c -v -f etc.tar /etc

GNU ス タ イ ル 、 す な わ ち 長 い オ プ シ ョ ン 形 式 で は 、 各 オ プ シ ョ ン は 、 2 個 の ダ ッ シ ュ に 続 く 意 味 を 持 っ た 名 前 で あ り 、 小 文 字 と ダ ッ シ ュ か ら 構 成 さ れ て い ま す 。 使 用 に 当 た っ て 、 長 い オ プ シ ョ ン は 、 曖 昧 さ を 生 じ な い か ぎ り 、 最 初 の 数 文 字 に 短 縮 で き ま す 。 長 い オ プ シ ョ ン に 対 す る 引 数 は 、 そ の オ プ シ ョ ン の 直 後 に コ マ ン ド ラ イ ン 上 の 独 立 し た 単 語 と し て (訳 注 : す な わ ち 、 間 に ス ペ ー ス を 置 い て ) 指 定 す る か 、 あ る い は 、 オ プ シ ョ ン と の 間 を 等 号 (=) で 区 切 り 、 等 号 の 前 後 に は ス ペ ー ス を 入 れ ず に 指 定 し ま す 。 指 定 す る か し な い か が 任 意 の 引 数 で は 、 必 ず 後 者 の 書 式 を 使 わ な け れ ば な り ま せ ん 。

上 記 の コ マ ン ド 例 を こ の 形 式 で 書 く に は 、 次 の よ う な い く つ か の 方 法 が あ り ま す 。

tar --create --file etc.tar --verbose /etc
ま た は (オ プ シ ョ ン を い く つ か 短 縮 し て )、
tar --cre --file=etc.tar --verb /etc

オ プ シ ョ ン は 、 3 種 の 形 式 す べ て を 混 ぜ て 使 う こ と が で き ま す が 、 伝 統 的 な オ プ シ ョ ン を 混 ぜ て 使 う の は お 勧 め で き ま せ ん 。

操 作 モ ー ド

以 下 に 列 挙 し た オ プ シ ョ ン は 、 GNU tar に か く か く し か じ か の 操 作 を せ よ と 指 定 す る も の で す 。 指 定 す る の は 、 こ の 内 の た だ 1 つ で な け れ ば な り ま せ ん 。 オ プ シ ョ ン の 引 数 で は な い 引 数 が ど ん な 意 味 に な る か は 、 要 求 し た 操 作 モ ー ド 次 第 で す 。
-A , --catenate , --concatenate

ア ー カ イ ブ を 別 の ア ー カ イ ブ の 末 尾 に 追 加 し ま す 。 引 数 は 追 加 す る ア ー カ イ ブ の 名 前 と 見 な さ れ ま す 。 す べ て の 追 加 す る ア ー カ イ ブ は 、 追 加 さ れ る 側 の ア ー カ イ ブ (訳 注 : こ れ は -f オ プ シ ョ ン の 引 数 で 指 定 し ま す ) と 同 じ 形 式 で な け れ ば な り ま せ ん 。 そ う で な い と 、 作 成 さ れ た ア ー カ イ ブ が 、 GNU 以 外 の tar の 実 装 で 使 え な く な る 可 能 性 が あ り ま す 。 な お 、 注 意 す べ き 点 と し て 、 2 個 以 上 の ア ー カ イ ブ を 引 数 と し て 指 定 し た 場 合 に 、 1 番 目 の ア ー カ イ ブ 以 外 の ア ー カ イ ブ の メ ン バ ー が 、 作 成 さ れ た ア ー カ イ ブ で ア ク セ ス で き る の は 、 -i ( --ignore-zeros ) オ プ シ ョ ン を 使 用 し た 場 合 だ け で す 。

圧 縮 し た ア ー カ イ ブ の 結 合 は で き ま せ ん 。

-c , --create

新 し い ア ー カ イ ブ を 作 成 し ま す 。 引 数 は ア ー カ イ ブ に 入 れ る フ ァ イ ル の 名 前 で す (訳 注 : 作 成 す る ア ー カ イ ブ フ ァ イ ル の 名 前 は 、 -f オ プ シ ョ ン の 引 数 で 指 定 し ま す )。 --no-recursion オ プ シ ョ ン が 指 定 さ れ な い か ぎ り 、 デ ィ レ ク ト リ は 再 帰 的 に ア ー カ イ ブ さ れ ま す 。

-d , --diff , --compare

ア ー カ イ ブ と フ ァ イ ル シ ス テ ム の 間 に 相 違 が あ る か ど う か を 調 べ ま す 。 引 数 は 任 意 だ が 、 指 定 す る な ら 、 比 較 し た い ア ー カ イ ブ の メ ン バ ー で す 。 指 定 し な い 場 合 は 、 カ レ ン ト ワ ー キ ン グ デ ィ レ ク ト リ を 指 定 し た も の と 見 な さ れ ま す 。 (訳 注 : info マ ニ ュ ア ル の 説 明 は 少 し 違 い 、 「 メ ン バ ー を 1 つ も 指 定 し な い 場 合 、 tar は 全 ア ー カ イ ブ を 比 較 す る 」 と な っ て い ま す 。 )

--delete

ア ー カ イ ブ か ら 削 除 し ま す 。 引 数 は ア ー カ イ ブ か ら 削 除 す る メ ン バ ー の 名 前 で す 。 少 な く と も 1 つ は 引 数 を 指 定 し な け れ ば な り ま せ ん 。

こ の オ プ シ ョ ン は 圧 縮 し た ア ー カ イ ブ に は 使 え ま せ ん 。 こ れ と 等 価 な 短 い オ プ シ ョ ン は あ り ま せ ん 。

-r , --append

ア ー カ イ ブ の 最 後 に フ ァ イ ル を 追 加 し ま す 。 引 数 の 意 味 は 、 -c ( --create ) と 同 じ で す 。

-t , --list

ア ー カ イ ブ の 内 容 一 覧 を 表 示 し ま す 。 引 数 は 任 意 で す 。 引 数 が 指 定 さ れ た 場 合 は 、 表 示 す べ き メ ン バ ー の 名 前 と な り ま す 。

--test-label

ア ー カ イ ブ の ボ リ ュ ー ム ラ ベ ル を テ ス ト し て 終 了 し ま す 。 引 数 を 指 定 せ ず に 使 用 す る と 、 ボ リ ュ ー ム ラ ベ ル を (も し あ れ ば ) 表 示 し 、 ス テ ー タ ス 0 で 終 了 し ま す 。 1 つ 以 上 の コ マ ン ド ラ イ ン 引 数 を 指 定 す る と 、 tar は ボ リ ュ ー ム ラ ベ ル を 各 引 数 と 比 較 し ま す 。 引 数 に マ ッ チ す る ラ ベ ル が あ っ た 場 合 は 、 コ ー ド 0 で 終 了 し 、 な か っ た 場 合 は 、 コ ー ド 1 で 終 了 し ま す 。 そ の 際 、 -v ( --verbose ) オ プ シ ョ ン が 一 緒 に 指 定 さ れ な い か ぎ り 、 出 力 に は 何 も 表 示 さ れ ま せ ん 。

こ れ と 等 価 な 短 い オ プ シ ョ ン は あ り ま せ ん 。

-u , --update

ア ー カ イ ブ 内 の 同 名 の コ ピ ー よ り 新 し い フ ァ イ ル だ け を 追 加 し ま す 。 引 数 の 意 味 は 、 -c や -r オ プ シ ョ ン と 同 じ で す 。 気 を 付 け て ほ し い の で す が 、 新 し い フ ァ イ ル が 、 古 い ア ー カ イ ブ コ ピ ー に 置 き 換 わ る わ け で は あ り ま せ ん 。 そ う で は な く て 、 ア ー カ イ ブ の 末 尾 に 追 加 さ れ る の で す 。 従 っ て 、 作 成 さ れ た ア ー カ イ ブ に は 、 同 じ フ ァ イ ル の 様 々 な バ ー ジ ョ ン に 当 た る 、 同 じ 名 前 の 複 数 の メ ン バ ー が 含 ま れ る こ と が あ り ま す 。

-x , --extract , --get

ア ー カ イ ブ か ら フ ァ イ ル を 抽 出 し ま す 。 引 数 は 任 意 で す 。 引 数 が 指 定 さ れ た 場 合 、 抽 出 す る ア ー カ イ ブ メ ン バ ー の 名 前 と な り ま す 。

--show-defaults

tar の い く つ か の オ プ シ ョ ン に つ い て 組 み 込 み の デ フ ォ ル ト を 表 示 し て 、 終 了 し ま す 。 引 数 は 指 定 で き ま せ ん 。

-? , --help

簡 単 な オ プ シ ョ ン の サ マ リ ー を 表 示 し て 、 終 了 し ま す 。 引 数 は 指 定 で き ま せ ん 。

--usage

指 定 可 能 な オ プ シ ョ ン の リ ス ト を 表 示 し て 、 終 了 し ま す 。 引 数 は 指 定 で き ま せ ん 。

--version

プ ロ グ ラ ム の バ ー ジ ョ ン と 著 作 権 情 報 を 表 示 し て 終 了 し ま す 。

オ プ シ ョ ン

操 作 の 調 節

--check-device

イ ン ク リ メ ン タ ル ア ー カ イ ブ を 作 成 す る 際 に 、 デ バ イ ス 番 号 を チ ェ ッ ク し ま す (デ フ ォ ル ト )。

-g , --listed-incremental = FILE

新 GNU 形 式 の イ ン ク リ メ ン タ ル バ ッ ク ア ッ プ を 取 り 扱 い ま す 。 FILE は ス ナ ッ プ シ ョ ッ ト フ ァ イ ル の 名 前 で す (訳 注 : こ の オ プ シ ョ ン の 引 数 FILE の 指 定 は 必 須 で す )。 tar は そ こ に 補 助 情 報 を 記 録 し て お き 、 そ の 情 報 を 使 っ て 、 前 回 の イ ン ク リ メ ン タ ル ダ ン プ の 後 で 、 ど の フ ァ イ ル が 変 更 さ れ 、 従 っ て 、 再 度 ダ ン プ し な け れ ば な ら な い か を 判 断 し ま す 。 ア ー カ イ ブ の 作 成 時 に FILE が 存 在 し な い 場 合 は 、 FILE が 作 ら れ 、 す べ て の フ ァ イ ル が 作 成 さ れ る ア ー カ イ ブ に 格 納 さ れ る こ と に な り ま す (こ れ が level 0 の ダ ン プ で あ る )。 N が 0 で は な い level N の イ ン ク リ メ ン タ ル ア ー カ イ ブ を 作 成 す る に は 、 level N-1 の ア ー カ イ ブ を 作 成 し た と き に 出 来 た ス ナ ッ プ シ ョ ッ ト フ ァ イ ル の コ ピ ー を 作 っ て 、 そ れ を FILE と し て 使 用 し ま す 。

ア ー カ イ ブ の 内 容 表 示 や メ ン バ ー の 抽 出 の 際 に は 、 FILE の 中 身 が 実 際 に 調 べ ら れ る わ け で は あ り ま せ ん 。 tar の 文 法 上 --listed-incremental は 引 数 を 取 る こ と に な っ て い る の で 、 FILE の 指 定 が 必 要 な だ け な の で す 。 そ れ 故 、 FILE と し て /dev/null を 使 う の は 、 常 套 手 段 で す 。

--hole-detection = METHOD

ス パ ー ス フ ァ イ ル (sparse file) の 穴 (hole) の 検 出 に METHOD を 使 い ま す 。 こ の オ プ シ ョ ン は 、 --sparse を 暗 黙 裡 に 設 定 し ま す 。 METHOD に 指 定 で き る 値 は 、 seek と raw で す 。 デ フ ォ ル ト は seek で あ り 、 使 用 で き な い 場 合 は raw を 使 い ま す 。

-G , --incremental

旧 GNU 形 式 の イ ン ク リ メ ン タ ル バ ッ ク ア ッ プ を 取 り 扱 い ま す 。

--ignore-failed-read

読 み 込 み 不 能 な フ ァ イ ル が あ っ て も 、 ゼ ロ 以 外 の 返 り 値 で 終 了 し ま せ ん 。

--level = NUMBER

作 成 す る リ ス ト 化 イ ン ク リ メ ン タ ル ア ー カ イ ブ (訳 注 : す な わ ち 、 新 GNU 形 式 の イ ン ク リ メ ン タ ル ア ー カ イ ブ ) の ダ ン プ レ ベ ル を 設 定 し ま す 。 現 在 の と こ ろ 、 --level=0 の み が 意 味 を 持 ち ま す 。 こ れ を 指 定 す る と 、 tar は ダ ン プ す る 前 に ス ナ ッ プ シ ョ ッ ト フ ァ イ ル を サ イ ズ 0 に 短 縮 し 、 強 制 的 に レ ベ ル 0 の ダ ン プ に し ま す 。

-n , --seek

ア ー カ イ ブ が シ ー ク (seek) 可 能 で あ る と 見 な し ま す 。 通 常 、 tar は 、 ア ー カ イ ブ が シ ー ク 可 能 で あ る か 否 か を 自 動 的 に 判 断 し ま す 。 こ の オ プ シ ョ ン は 、 そ う し た 判 断 が う ま く 行 か な い 場 合 に 使 う た め の も の で す 。 こ の オ プ シ ョ ン は 、 ア ー カ イ ブ を 読 み 込 む た め に オ ー プ ン し て い る 場 合 に の み 効 果 が あ り ま す (た と え ば 、 --list ま た は --extract オ プ シ ョ ン が 指 定 さ れ て い る 場 合 )。

--no-check-device

イ ン ク リ メ ン タ ル ア ー カ イ ブ を 作 成 す る 際 に 、 デ バ イ ス 番 号 を チ ェ ッ ク し ま せ ん 。

--no-seek

ア ー カ イ ブ が シ ー ク 可 能 で な い と 見 な し ま す 。

--occurrence [= N ]

ア ー カ イ ブ 中 の 各 フ ァ イ ル に つ い て 、 N 番 目 に 現 れ る も の だ け を 処 理 の 対 象 に し ま す 。 こ の オ プ シ ョ ン は 、 サ ブ コ マ ン ド --delete , --diff , --extract , --list の 1 つ と と も に 使 用 し 、 し か も 、 フ ァ イ ル の リ ス ト を 、 コ マ ン ド ラ イ ン 上 、 ま た は -T オ プ シ ョ ン で 指 定 し て い る 場 合 に の み 、 有 効 で す 。 オ プ シ ョ ン 引 き 数 N の 指 定 は 任 意 で す が 、 デ フ ォ ル ト で は 1 に な っ て い ま す 。 (訳 注 : -r や -u オ プ シ ョ ン を 使 っ た 場 合 、 ア ー カ イ ブ 中 に 同 名 の メ ン バ ー が 複 数 存 在 す る こ と が り ま す 。 そ う し た 場 合 に 、 何 番 目 の メ ン バ ー を 抽 出 な ど の 対 象 に す る か を 指 名 す る の で す 。 )

--restrict

有 害 か も し れ な い い く つ か の オ プ シ ョ ン を 無 効 化 し ま す 。

--sparse-version = MAJOR [. MINOR ]

ス パ ー ス フ ァ イ ル で 使 用 す る ス パ ー ス フ ォ ー マ ッ ト の バ ー ジ ョ ン を 指 定 し ま す 。 こ の オ プ シ ョ ン は --sparse を 暗 黙 裡 に 設 定 し ま す 。 引 数 に 指 定 で き る 値 は 、 0.0 , 0.1 , 1.0 の い ず れ か で す 。 ス パ ー ス フ ォ ー マ ッ ト に つ い て の 詳 し い 議 論 に つ い て は 、 GNU Tar Manual , appendix D , " Sparse Formats " を 見 て く だ さ い 。 info リ ー ダ ー を 使 用 す る 場 合 は 、 コ マ ン ド info tar ’Sparse Formats’ で 読 む こ と が で き ま す 。

-S , --sparse

ス パ ー ス フ ァ イ ル を 効 率 的 に 取 り 扱 い ま す 。 フ ァ イ ル シ ス テ ム 上 の フ ァ イ ル の 中 に は 、 実 際 の 書 き 込 み が 一 度 も 行 わ れ て い な い セ グ メ ン ト を 含 む も の が あ り ま す (そ う し た も の が DBM の よ う な シ ス テ ム で 作 ら れ た デ ー タ ベ ー ス フ ァ イ ル だ っ た り す る の は 、 よ く あ る こ と で す )。 こ の オ プ シ ョ ン を 指 定 す る と 、 tar は 、 フ ァ イ ル を ア ー カ イ ブ に 入 れ る 前 に 、 そ れ が ス パ ー ス フ ァ イ ル か ど う か を 判 断 し よ う と し ま す 。 そ し て 、 も し そ う な ら 、 フ ァ イ ル 中 の 空 っ ぽ の 部 分 を ダ ン プ し な い こ と に よ っ て 、 生 成 す る ア ー カ イ ブ の サ イ ズ を 小 さ く し ま す 。

上 書 き の 制 御

以 下 の オ プ シ ョ ン は 、 ア ー カ イ ブ か ら フ ァ イ ル を 抽 出 す る こ と に よ っ て 、 デ ィ ス ク 上 に あ る 同 名 フ ァ イ ル の 上 書 き が 生 じ る 場 合 の tar の 挙 動 を 制 御 し ま す 。
-k , --keep-old-files

抽 出 時 に 、 既 存 の フ ァ イ ル を 置 き 換 え ま せ ん 。

--keep-newer-files

既 存 の フ ァ イ ル が ア ー カ イ ブ コ ピ ー よ り 新 し い 場 合 、 そ れ を 置 き 換 え ま せ ん 。

--keep-directory-symlink

抽 出 す る 際 に 、 デ ィ レ ク ト リ を 指 す 同 名 の シ ン ボ リ ッ ク リ ン ク が す で に 存 在 し て い る 場 合 は 、 そ れ を ア ー カ イ ブ 中 の 実 デ ィ レ ク ト リ で 置 き 換 え ま せ ん 。 (訳 注 : そ の 場 合 は 、 そ の シ ン ボ リ ッ ク の 参 照 先 に ア ー カ イ ブ 中 の デ ィ レ ク ト リ の 中 身 を 展 開 し ま す 。 こ の オ プ シ ョ ン を 指 定 し な い デ フ ォ ル ト で は 、 ま ず シ ン ボ リ ッ ク リ ン ク を 消 去 し 、 そ れ か ら デ ィ レ ク ト リ の 抽 出 を 行 う こ と に な り ま す 。 )

--no-overwrite-dir

既 存 の デ ィ レ ク ト リ の メ タ デ ー タ を 変 更 し ま せ ん 。

--one-top-level [ = DIR ]

す べ て の フ ァ イ ル を DIR に 抽 出 し ま す 。 引 数 な し で 使 用 す る と 、 ア ー カ イ ブ の ベ ー ス ネ ー ム に ち な ん だ 名 前 の サ ブ デ ィ レ ク ト リ に 抽 出 す る こ と に な り ま す (詳 し く 言 う と 、 ア ー カ イ ブ の ベ ー ス ネ ー ム か ら --auto-compress で 認 識 さ れ る 標 準 的 な 圧 縮 フ ァ イ ル の 拡 張 子 を 取 り 去 っ た も の )。

--overwrite

抽 出 時 に 、 既 存 フ ァ イ ル を 上 書 き し ま す 。

--overwrite-dir

抽 出 時 に 、 既 存 デ ィ レ ク ト リ の メ タ デ ー タ を 上 書 き し ま す (デ フ ォ ル ト )。

--recursive-unlink

デ ィ レ ク ト リ を 抽 出 す る 前 に 、 同 名 の デ ィ レ ク ト リ に あ る す べ て の フ ァ イ ル を 再 帰 的 に 削 除 し ま す 。

--remove-files

フ ァ イ ル を ア ー カ イ ブ に 追 加 し た 後 で 、 デ ィ ス ク か ら フ ァ イ ル を 削 除 し ま す 。

--skip-old-files

抽 出 時 に 、 既 存 の フ ァ イ ル を 上 書 き せ ず 、 何 の メ ッ セ ー ジ も 出 さ ず に ス キ ッ プ し ま す (訳 注 : な お 、 --keep-old-files と 違 い 、 こ ち ら は 返 り 値 が エ ラ ー に な り ま せ ん )。

-U , --unlink-first

抽 出 す る 際 に 、 上 書 き す る フ ァ イ ル を ま ず 削 除 し ま す 。

-W , --verify

ア ー カ イ ブ を 書 き 込 ん だ 後 で 照 合 し ま す 。

出 力 ス ト リ ー ム に 関 す る 選 択

--ignore-command-error
サ ブ プ ロ セ ス の 終 了 コ ー ド を 無 視 し ま す 。
--no-ignore-command-error

子 プ ロ セ ス の 0 以 外 の 終 了 コ ー ド を エ ラ ー と し て 扱 い ま す (デ フ ォ ル ト )。

-O , --to-stdout

フ ァ イ ル を 標 準 出 力 に 抽 出 し ま す 。

--to-command = COMMAND

抽 出 し た フ ァ イ ル を パ イ プ で COMMAND に 渡 し ま す 。 こ の オ プ シ ョ ン の 引 数 は 、 外 部 プ ロ グ ラ ム の パ ス 名 で あ り 、 コ マ ン ド ラ イ ン 引 数 を 付 け て 指 定 す る こ と も で き ま す 。 外 部 プ ロ グ ラ ム が 起 動 さ れ る と 、 抽 出 さ れ た フ ァ イ ル の 内 容 が 、 そ の プ ロ グ ラ ム の 標 準 入 力 に 渡 さ れ ま す 。 ま た 、 追 加 的 な デ ー タ が 、 以 下 の 環 境 変 数 を 通 し て 外 部 プ ロ グ ラ ム に 渡 さ れ る こ と に な り ま す 。
TAR_FILETYPE

フ ァ イ ル の タ イ プ 。 1 文 字 か ら な り 、 以 下 の 意 味 が あ り ま す 。

		f
		通 常 フ ァ イ ル
		d
		デ ィ レ ク ト リ
		l
		シ ン ボ リ ッ ク リ ン ク
		h
		ハ ー ド リ ン ク
		b
		ブ ロ ッ ク デ バ イ ス
		c
		キ ャ ラ ク タ デ バ イ ス

現 在 の と こ ろ サ ポ ー ト さ れ て い る の は 、 通 常 フ ァ イ ル だ け で す 。

TAR_MODE

フ ァ イ ル の 許 可 属 性 。 8 進 数 。

TAR_FILENAME

フ ァ イ ル 名 。

TAR_REALNAME

ア ー カ イ ブ に 格 納 さ れ て い る フ ァ イ ル 名 。

TAR_UNAME

フ ァ イ ル の 所 有 者 名 。

TAR_GNAME

フ ァ イ ル の 所 有 グ ル ー プ 名 。

TAR_ATIME

最 終 ア ク セ ス 日 時 。 こ れ は 、 the Epoch か ら の 秒 数 を 表 す 10 進 数 で す 。 ア ー カ イ ブ の 日 時 が ナ ノ 秒 の 精 度 の 場 合 、 タ イ ム ス タ ン プ の 小 数 点 の 後 ろ に ナ ノ 秒 の 部 分 が 付 き ま す 。

TAR_MTIME

最 終 更 新 日 時 。

TAR_CTIME

最 終 ス テ ー タ ス 変 更 日 時 。

TAR_SIZE

フ ァ イ ル の サ イ ズ 。

TAR_UID

フ ァ イ ル の 所 有 者 の UID。

TAR_GID

フ ァ イ ル の 所 有 グ ル ー プ の GID。

さ ら に 、 以 下 の 環 境 変 数 に tar の 操 作 モ ー ド や 処 理 対 象 の ア ー カ イ ブ に つ い て の 情 報 が 含 ま れ て い ま す 。
TAR_VERSION

GNU tar の バ ー ジ ョ ン 番 号 。

TAR_ARCHIVE

tar が 処 理 中 の ア ー カ イ ブ の 名 前 。

TAR_BLOCKING_FACTOR

現 在 の ブ ロ ッ キ ン グ 係 数 。 す な わ ち 、 1 レ コ ー ド を 構 成 す る 512 バ イ ト の ブ ロ ッ ク 数 。

TAR_VOLUME

tar が 処 理 中 の ボ リ ュ ー ム 番 号 (複 数 ボ リ ュ ー ム の ア ー カ イ ブ を 読 み 込 ん で い る 場 合 に 設 定 さ れ ま す )。

TAR_FORMAT

処 理 し て い る ア ー カ イ ブ の フ ォ ー マ ッ ト 。 gnu , oldgnu , posix , ustar , v7 の 内 の 1 つ 。

TAR_SUBCOMMAND

tar が 実 行 中 の 操 作 を 表 す 短 い オ プ シ ョ ン (前 に 1 個 の ダ ッ シ ュ が 付 い た も の )。

フ ァ イ ル 属 性 の 操 作

--atime-preserve [= METHOD ]

ダ ン プ の 対 象 に し た 元 フ ァ イ ル の ア ク セ ス 日 時 を 変 更 し ま せ ん 。 そ の 方 法 に は 、 フ ァ イ ル を 読 み 込 ん だ 後 で ア ク セ ス 日 時 を 元 に 戻 す や り 方 ( METHOD = replace 、 デ フ ォ ル ト ) と 、 最 初 か ら ア ク セ ス 日 時 を 変 更 し な い や り 方 ( METHOD = system ) の 二 つ が あ り ま す 。

--delay-directory-restore

抽 出 し た デ ィ レ ク ト リ の 更 新 日 時 や 許 可 属 性 の 決 定 を 、 抽 出 の 最 後 ま で 遅 ら せ ま す 。 メ ン バ ー の 順 番 が 通 常 と は 違 っ て い る ア ー カ イ ブ か ら 抽 出 す る 際 に は 、 こ の オ プ シ ョ ン を 使 用 す る と よ い で し ょ う 。 (訳 注 : info tar の "Directory Modification Times and Permissions" を 参 照 。 )

--group = NAME [: GID ]

ア ー カ イ ブ に 入 れ る フ ァ イ ル の 所 有 グ ル ー プ を NAME に し ま す 。 GID ま で 指 定 し な い 場 合 、 NAME は グ ル ー プ 名 で も 、 GID 番 号 で も か ま い ま せ ん 。 そ の 場 合 、 指 定 し な い 方 (GID、 ま た は グ ル ー プ 名 ) は 、 使 用 中 の ホ ス ト の グ ル ー プ デ ー タ ベ ー ス か ら 推 測 さ れ る こ と に な り ま す 。

--group-map = FILE と 一 緒 に 使 わ れ た と き は 、 所 有 グ ル ー プ が FILE の リ ス ト に 載 っ て い な い フ ァ イ ル に 対 し て の み 効 果 が あ り ま す 。

--group-map = FILE

グ ル ー プ 変 換 マ ッ プ を FILE か ら 読 み 込 み ま す 。 空 行 は 無 視 し ま す 。 コ メ ン ト は # で 始 ま り 、 行 末 ま で 続 く 。 FILE の 空 行 以 外 の 各 行 で は 、 1 つ の グ ル ー プ 変 換 を 定 義 し ま す 。 各 行 は 、 任 意 の 数 の ホ ワ イ ト ス ペ ー ス (訳 注 : 空 白 や タ ブ ) で 区 切 ら れ た 2 つ の フ ィ ー ル ド か ら 構 成 さ れ て い な け れ ば な り ま せ ん 。 す な わ ち 、 次 の よ う な 形 で す :

OLDGRP NEWGRP [ : NEWGID ]

OLDGRP は 有 効 な グ ル ー プ 名 か 、 + を 前 に 付 け た GID で す 。 NEWGID を 指 定 し な い 場 合 は 、 NEWGRP の 方 も 、 や は り 有 効 な グ ル ー プ 名 か 、 + GID で な け れ ば な り ま せ ん 。 NEWGID ま で 指 定 し た 場 合 は 、 NEWGRP と NEWGID の ど ち ら も 、 シ ス テ ム の グ ル ー プ デ ー タ ベ ー ス に 載 っ て い る 必 要 は あ り ま せ ん 。

つ ま る と こ ろ 、 所 有 グ ル ー プ OLDGRP の 各 入 力 フ ァ イ ル が 、 所 有 グ ル ー プ を NEWGRP 、 GID を NEWGID と し て ア ー カ イ ブ に 格 納 さ れ る こ と に な り ま す 。

--mode = CHANGES

ア ー カ イ ブ に 入 れ る フ ァ イ ル の 許 可 属 性 を 、 シ ン ボ ル に よ る 指 定 で CHANGES に し ま す (訳 注 : 実 際 に は 8 進 数 に よ る 指 定 も 可 能 )。

--mtime = DATE-OR-FILE

ア ー カ イ ブ に 入 れ る フ ァ イ ル の mtime を 設 定 し ま す 。 DATE-OR-FILE は 、 ほ ぼ 任 意 の フ ォ ー マ ッ ト の 日 付 /時 刻 、 ま た は 既 存 フ ァ イ ル の 名 前 で す 。 後 者 の 場 合 、 そ の フ ァ イ ル の mtime が 使 わ れ ま す 。

-m , --touch

フ ァ イ ル の 更 新 日 時 (mtime) を 抽 出 し ま せ ん 。

--no-delay-directory-restore

前 に 指 定 し た --delay-directory-restore オ プ シ ョ ン の 効 果 を 取 り 消 し ま す 。

--no-same-owner

実 行 ユ ー ザ 自 身 の 資 格 で フ ァ イ ル を 抽 出 し ま す (一 般 ユ ー ザ の デ フ ォ ル ト )。

--no-same-permissions

ア ー カ イ ブ か ら 許 可 属 性 を 抽 出 す る 際 、 実 行 ユ ー ザ の umask を 適 用 し ま す (一 般 ユ ー ザ の デ フ ォ ル ト )。

--numeric-owner

ユ ー ザ /グ ル ー プ 名 に 常 に 番 号 を 使 い ま す 。

--owner = NAME [: UID ]

ア ー カ イ ブ に 入 れ る フ ァ イ ル の 所 有 者 を NAME に し ま す 。 UID ま で 指 定 し な い 場 合 、 NAME は ユ ー ザ 名 で も 、 UID 番 号 で も か ま い ま せ ん 。 そ の 場 合 、 指 定 し な い 方 (UID、 ま た は ユ ー ザ 名 ) は 、 使 用 中 の ホ ス ト の ユ ー ザ デ ー タ ベ ー ス か ら 推 測 さ れ る こ と に な り ま す 。

--owner-map = FILE と 一 緒 に 使 わ れ た と き は 、 所 有 者 が FILE の リ ス ト に 載 っ て い な い フ ァ イ ル に 対 し て の み 効 果 が あ り ま す 。

--owner-map = FILE

所 有 者 変 換 マ ッ プ を FILE か ら 読 み 込 み ま す 。 空 行 は 無 視 し ま す 。 コ メ ン ト は # で 始 ま り 、 行 末 ま で 続 き ま す 。 FILE の 空 行 以 外 の 各 行 で は 、 1 つ の UID 変 換 を 定 義 す る 。 各 行 は 、 任 意 の 数 の ホ ワ イ ト ス ペ ー ス (訳 注 : 空 白 や タ ブ ) で 区 切 ら れ た 2 つ の フ ィ ー ル ド か ら 構 成 さ れ て い な け れ ば な り ま せ ん 。 す な わ ち 、 次 の よ う な 形 で す :

OLDUSR NEWUSR [ : NEWUID ]

OLDUSR は 有 効 な ユ ー ザ 名 か 、 + を 前 に 付 け た UID で す 。 NEWUID を 指 定 し な い 場 合 は 、 NEWUSR の 方 も 、 や は り 有 効 な ユ ー ザ 名 か 、 + UID で な け れ ば な り ま せ ん 。 NEWUID ま で 指 定 し た 場 合 は 、 NEWUSR と NEWUID の ど ち ら も 、 シ ス テ ム の ユ ー ザ デ ー タ ベ ー ス に 載 っ て い る 必 要 は あ り ま せ ん 。

つ ま る と こ ろ 、 所 有 者 OLDUSR の 各 入 力 フ ァ イ ル が 、 所 有 者 名 を NEWUSR 、 UID を NEWUID と し て ア ー カ イ ブ に 格 納 さ れ る こ と に な り ま す 。

-p , --preserve-permissions , --same-permissions

フ ァ イ ル の 許 可 属 性 に 関 す る 情 報 を 抽 出 し ま す (ス ー パ ー ユ ー ザ の デ フ ォ ル ト )。

--same-owner

ア ー カ イ ブ 中 の も の と 同 じ 所 有 者 属 性 を 付 け て 、 フ ァ イ ル を 抽 出 し よ う と 試 み ま す (ス ー パ ー ユ ー ザ の デ フ ォ ル ト )。

-s , --preserve-order , --same-order

引 数 で あ る 抽 出 す べ き フ ァ イ ル の 名 前 が 、 ア ー カ イ ブ 中 と 同 じ 順 番 で ソ ー ト さ れ て い る と tar に 知 ら せ ま す 。 (訳 注 : info tar の "Same Order" と "Option Summary" に 詳 し い 説 明 が あ り ま す 。 そ れ が わ か り や す い 。 )

--sort= ORDER

ア ー カ イ ブ を 作 成 す る 際 に 、 デ ィ レ ク ト リ エ ン ト リ を ORDER に 基 づ い て ソ ー ト し ま す 。 ORDER は none , name , inode の い ず れ か で す 。

デ フ ォ ル ト は --sort=none で あ り 、 オ ペ レ ー テ ィ ン グ シ ス テ ム が 返 す の と 同 じ 順 番 で メ ン バ ー を ア ー カ イ ブ し ま す 。

--sort=name は 、 作 成 さ れ る ア ー カ イ ブ の メ ン バ ー の 並 び 順 を 一 定 で 、 再 現 可 能 な も の に し ま す 。

--sort=inode を 使 う と 、 ア ー カ イ ブ を 作 成 す る 際 の デ ィ ス ク シ ー ク の 回 数 を 減 ら し 、 そ う す る こ と で 、 実 行 時 間 を か な り ス ピ ー ド ア ッ プ す る こ と が で き ま す 。 こ の ソ ー ト 順 は 、 下 層 で 動 い て い る シ ス テ ム が 必 要 な 情 報 を 提 供 す る 場 合 に の み 使 用 で き ま す 。

拡 張 フ ァ イ ル 属 性

--acls

POSIX ACL の サ ポ ー ト を 有 効 に し ま す 。

--no-acls

POSIX ACL の サ ポ ー ト を 無 効 に し ま す 。

--selinux

SELinux コ ン テ キ ス ト の サ ポ ー ト を 有 効 に し ま す 。

--no-selinux

SELinux コ ン テ キ ス ト の サ ポ ー ト を 無 効 に し ま す 。

--xattrs

拡 張 属 性 の サ ポ ー ト を 有 効 に し ま す 。

--no-xattrs

拡 張 属 性 の サ ポ ー ト を 無 効 に し ま す 。

--xattrs-exclude= PATTERN

xattr の キ ー (訳 注 : 拡 張 属 性 の 名 前 ) に つ い て 、 格 納 や 抽 出 か ら 除 外 す る パ タ ー ン を 指 定 し ま す 。 PATTERN は POSIX の 正 規 表 現 で す 。 た と え ば 、 --xattrs-exclude=’ˆuser.’ と 指 定 す れ ば 、 名 前 空 間 user の 属 性 を 除 外 す る こ と に な り ま す 。

--xattrs-include= PATTERN

xattr の キ ー に つ い て 、 格 納 や 抽 出 時 に イ ン ク ル ー ド す る パ タ ー ン を 指 定 し ま す 。 PATTERN は POSIX の 正 規 表 現 で す 。

デ バ イ ス の 選 択 と 交 換

-f , --file = ARCHIVE

ア ー カ イ ブ フ ァ イ ル ま た は ア ー カ イ ブ デ バ イ ス と し て ARCHIVE を 使 用 し ま す 。 こ の オ プ シ ョ ン を 指 定 し な い 場 合 、 tar は 、 ま ず 環 境 変 数 ‘TAPE’ を 調 べ 、 設 定 さ れ て い れ ば 、 そ の 値 を ア ー カ イ ブ 名 と し て 使 用 し ま す 。 設 定 さ れ て い な い 場 合 は 、 コ ン パ イ ル 時 に 埋 め 込 ま れ た デ フ ォ ル ト を 使 い ま す 。 デ フ ォ ル ト の 値 は --show-defaults オ プ シ ョ ン を 使 っ て 調 べ る こ と が で き ま す 。 ま た 、 tar --help の 出 力 の 末 尾 を 見 て も わ か り ま す 。

ア ー カ イ ブ 名 に コ ロ ン が 含 ま れ て い る 場 合 、 そ れ は 、 リ モ ー ト マ シ ン の フ ァ イ ル か デ バ イ ス で す 。 コ ロ ン の 前 の 部 分 は マ シ ン 名 ま た は IP ア ド レ ス と 見 な さ れ 、 コ ロ ン の 後 の 部 分 は フ ァ イ ル ま た は デ バ イ ス の パ ス 名 と 見 な さ れ ま す 。 例 は 以 下 の と お り で す :

--file=remotehost:/dev/sr0

そ う し た け れ ば 、 ホ ス ト 名 の 前 に ユ ー ザ 名 を 付 け る こ と も で き ま す 。 そ の 場 合 は 、 両 者 の 間 に @ 記 号 を 置 き ま す 。

デ フ ォ ル ト で は 、 リ モ ー ト ホ ス ト は rsh (1) コ マ ン ド を 使 っ て ア ク セ ス さ れ ま す 。 最 近 で は 、 代 わ り に ssh (1) を 使 う の が 一 般 的 で す 。 そ う し た い 場 合 は 、 以 下 の コ マ ン ド ラ イ ン オ プ シ ョ ン を 指 定 し ま す :

--rsh-command=/usr/bin/ssh

リ モ ー ト マ シ ン に は rmt (8) コ マ ン ド が イ ン ス ト ー ル さ れ て い な け れ ば な り ま せ ん 。 そ の パ ス 名 が tar の デ フ ォ ル ト と 一 致 し な い 場 合 は 、 --rmt-command オ プ シ ョ ン を 使 っ て 正 し い パ ス 名 を tar に 知 ら せ る こ と が で き ま す 。

--force-local

ア ー カ イ ブ フ ァ イ ル 名 に コ ロ ン が 含 ま れ て い て も ロ ー カ ル フ ァ イ ル と し て 扱 い ま す 。

-F , --info-script = COMMAND , --new-volume-script = COMMAND

各 テ ー プ の 終 わ り に COMMAND を 実 行 し ま す ( -M が 暗 黙 裡 に 設 定 さ れ ま す )。 コ マ ン ド に は 引 数 を 含 め る こ と が で き ま す 。 コ マ ン ド は 起 動 さ れ る と き 、 tar の 環 境 変 数 に 加 え て 、 以 下 の 環 境 変 数 を 継 承 し ま す 。
TAR_VERSION

GNU tar の バ ー ジ ョ ン 番 号 。

TAR_ARCHIVE

tar が 処 理 中 の ア ー カ イ ブ の 名 前 。

TAR_BLOCKING_FACTOR

現 在 の ブ ロ ッ キ ン グ 係 数 。 す な わ ち 、 1 レ コ ー ド を 構 成 す る 512 バ イ ト の ブ ロ ッ ク 数 。

TAR_VOLUME

tar が 処 理 中 の ボ リ ュ ー ム 番 号 (複 数 ボ リ ュ ー ム の ア ー カ イ ブ を 読 み 込 ん で い る 場 合 に 設 定 さ れ ま す )。

TAR_FORMAT

処 理 し て い る ア ー カ イ ブ の フ ォ ー マ ッ ト 。 gnu , oldgnu , posix , ustar , v7 の 内 の 1 つ 。

TAR_SUBCOMMAND

tar が 実 行 中 の 操 作 を 表 す 短 い オ プ シ ョ ン (前 に 1 個 の ダ ッ シ ュ が 付 い た も の )。

TAR_FD

新 し い ボ リ ュ ー ム 名 を tar に 伝 え る た め に 使 う こ と が で き る フ ァ イ ル デ ィ ス ク リ プ タ 。

指 定 さ れ た info script が 失 敗 し た 場 合 、 tar は 終 了 し ま す 。 成 功 し た 場 合 は 、 次 の ボ リ ュ ー ム の 書 き 込 み を 始 め ま す 。

-L , --tape-length = N

N x1024 バ イ ト を 書 き 込 ん だ 後 、 テ ー プ を 入 れ 替 え ま す 。 N に は サ イ ズ を 表 す 接 尾 辞 (下 記 の 「 サ イ ズ 接 尾 辞 」 を 参 照 ) を 付 け る こ と が で き ま す 。 そ う し た 接 尾 辞 は 1024 の 代 わ り に 使 う 乗 数 を 指 定 し て い ま す 。

こ の オ プ シ ョ ン は -M を 暗 黙 裡 に 設 定 し ま す 。

-M , --multi-volume

マ ル チ ボ リ ュ ー ム ア ー カ イ ブ の 作 成 /内 容 表 示 /抽 出 を 行 い ま す 。

--rmt-command = COMMAND

リ モ ー ト ア ー カ イ ブ に ア ク セ ス す る 際 に 、 rmt の 代 わ り に COMMAND を 使 い ま す 。 上 記 の -f オ プ シ ョ ン の 説 明 を 参 照 し て く だ さ い 。

--rsh-command = COMMAND

リ モ ー ト ア ー カ イ ブ に ア ク セ ス す る 際 に 、 rsh の 代 わ り に COMMAND を 使 い ま す 。 上 記 の -f オ プ シ ョ ン の 説 明 を 参 照 し て く だ さ い 。

--volno-file = FILE

こ の オ プ シ ョ ン を --multi-volume と と も に 使 う と 、 tar は 、 今 マ ル チ ボ リ ュ ー ム ア ー カ イ ブ の ど の ボ リ ュ ー ム を 処 理 し て い る か を 、 FILE に 記 録 す る こ と に な り ま す 。

レ コ ー ド と ブ ロ ッ ク (Device blocking)

-b , --blocking-factor = BLOCKS

レ コ ー ド サ イ ズ を BLOCKS x 512 バ イ ト に し ま す (訳 注 : BLOCKS は 1 レ コ ー ド を 構 成 す る 512 バ イ ト の ブ ロ ッ ク の 数 、 す な わ ち 、 ブ ロ ッ キ ン グ 係 数 。 た い て い の 場 合 、 デ フ ォ ル ト は 20 に な っ て い ま す )。

-B , --read-full-records

内 容 表 示 や 抽 出 を す る 際 、 フ ァ イ ル の 末 尾 を 示 す マ ー カ ー を 含 む レ コ ー ド が 、 1 レ コ ー ド の 大 き さ に 満 た な い 不 完 全 な 入 力 レ コ ー ド で あ っ て も 許 容 し ま す 。 (訳 注 : tar は ア ー カ イ ブ の 読 み 書 き を レ コ ー ド 単 位 で 行 い ま す 。 こ の オ プ シ ョ ン は 、 1 レ コ ー ド の 大 き さ に 達 し な い 入 力 に 対 す る 処 理 を 指 定 し て い ま す 。 info tar Reading を 参 照 し て く だ さ い )。

-i , --ignore-zeros

ア ー カ イ ブ 中 の 0 ば か り か ら な る ブ ロ ッ ク を 無 視 し ま す 。 通 常 、 0 で 埋 め ら れ た 512 バ イ ト ブ ロ ッ ク が 2 個 連 続 す る と 、 そ れ は フ ァ イ ル の 末 尾 (EOF) を 意 味 し 、 こ れ に 出 会 う と tar は 読 み 込 み を 止 め ま す 。 こ の オ プ シ ョ ン を 指 定 す る と 、 0 の ブ ロ ッ ク に 出 会 っ て も 読 み 込 み を 続 け る の で 、 -A オ プ シ ョ ン を 付 け て 作 成 し た ア ー カ イ ブ を 読 み 込 む と き 役 に 立 ち ま す 。

--record-size = NUMBER

レ コ ー ド サ イ ズ を 設 定 し ま す 。 NUMBER は 1 レ コ ー ド あ た り の バ イ ト 数 で あ り 、 512 の 倍 数 で な け れ ば な り ま せ ん 。 サ イ ズ 接 尾 辞 を 付 け る こ と も で き 、 た と え ば 、 --record-size=10K は 10 キ ロ バ イ ト で す 。 有 効 な 接 尾 辞 の リ ス ト に つ い て は 、 サ ブ セ ク シ ョ ン 「 サ イ ズ 接 尾 辞 」 を 見 て く だ さ い 。

ア ー カ イ ブ 形 式 の 選 択

-H , --format = FORMAT

指 定 し た 形 式 の ア ー カ イ ブ を 作 成 し ま す 。 有 効 な フ ォ ー マ ッ ト は 以 下 の と お り で す :

	gnu		GNU tar 1.13.x 形 式
	oldgnu		GNU tar 1.12 以 前 の GNU 形 式

pax , posix

POSIX 1003.1-2001 (pax) 形 式

	ustar		POSIX 1003.1-1988 (ustar) 形 式
	v7		古 い V7 tar 形 式

--old-archive , --portability

--format=v7 と 同 じ 。

--pax-option = keyword [[:]= value ][, keyword [[:]= value ]]...

( -H pax で ) PAX ア ー カ イ ブ を 作 成 す る 際 の pax の キ ー ワ ー ド を 調 整 す る 。 こ の オ プ シ ョ ン は pax (1) ユ ー テ ィ リ テ ィ の -o オ プ シ ョ ン と 等 価 で す 。

--posix

--format=posix と 同 じ 。

-V , --label = TEXT

TEXT と い う ボ リ ュ ー ム 名 (訳 注 : ボ リ ュ ー ム ラ ベ ル と も 言 う ) を 付 け て 、 ア ー カ イ ブ を 作 成 す る 。 内 容 表 示 や 抽 出 を す る 際 に こ の オ プ シ ョ ン を 指 定 し た 場 合 は 、 TEXT を ボ リ ュ ー ム 名 の glob パ タ ー ン と し て 使 用 し ま す 。

圧 縮 オ プ シ ョ ン

-a , --auto-compress

圧 縮 プ ロ グ ラ ム を 決 定 す る た め に ア ー カ イ ブ 拡 張 子 を 使 用 し ま す 。

-I , --use-compress-program =COMMAND

デ ー タ を COMMAND で フ ィ ル タ す る 。 コ マ ン ド は 、 伸 長 す る た め の -d オ プ シ ョ ン を 解 す る も の で な け れ ば な り ま せ ん 。 引 数 に は コ マ ン ド ラ イ ン オ プ シ ョ ン も 含 め る こ と が で き ま す 。

-j , --bzip2

ア ー カ イ ブ を bzip2 (1) で フ ィ ル タ し ま す 。

-J , --xz

ア ー カ イ ブ を xz (1) で フ ィ ル タ し ま す 。

	--lzip		ア ー カ イ ブ を lzip (1) で フ ィ ル タ し ま す 。
	--lzma		ア ー カ イ ブ を lzma (1) で フ ィ ル タ し ま す 。
	--lzop		ア ー カ イ ブ を lzop (1) で フ ィ ル タ し ま す 。

--no-auto-compress

圧 縮 プ ロ グ ラ ム を 決 定 す る た め に ア ー カ イ ブ 拡 張 子 を 使 用 し ま せ ん 。

-z , --gzip , --gunzip , --ungzip

ア ー カ イ ブ を gzip (1) で フ ィ ル タ し ま す 。

-Z , --compress , --uncompress

ア ー カ イ ブ を compress (1) で フ ィ ル タ し ま す 。

--zstd

ア ー カ イ ブ を zstd (1) で フ ィ ル タ し ま す 。

ロ ー カ ル フ ァ イ ル の 選 択

--add-file = FILE

FILE を ア ー カ イ ブ に 追 加 し ま す (フ ァ イ ル 名 が ダ ッ シ ュ で 始 ま る 場 合 に 便 利 で す )。

--backup [= CONTROL ]

上 書 き や 削 除 を す る 前 に バ ッ ク ア ッ プ を 行 い ま す 。 引 数 CONTROL を 指 定 す れ ば 、 そ れ が バ ッ ク ア ッ プ の や り 方 を 決 め ま す 。 有 効 な 値 は 以 下 の と お り で す 。 (訳 注 : こ の オ プ シ ョ ン は 、 ア ー カ イ ブ の 作 成 ( -c )、 抽 出 ( -x )、 ど ち ら で も 使 え る が 、 -A , -r , -u , --delete で は 無 効 の よ う で す 。 )
none , off

バ ッ ク ア ッ プ を 全 く 作 成 し ま せ ん 。

t , numbered

番 号 付 き の バ ッ ク ア ッ プ を 作 成 し ま す 。

nil , existing

番 号 付 き の バ ッ ク ア ッ プ が 存 在 す れ ば 、 番 号 付 き の バ ッ ク ア ッ プ を 、 存 在 し な け れ ば 、 単 純 形 式 の バ ッ ク ア ッ プ を 作 成 し ま す 。

never , simple

常 に 単 純 形 式 の バ ッ ク ア ッ プ を 行 い ま す 。

CONTROL が 指 定 さ れ な い 場 合 、 環 境 変 数 VERSION_CONTROL か ら 値 を 取 得 し ま す 。 そ れ も 指 定 さ れ て い な い 場 合 は 、 existing が 指 定 さ れ て い る も の と 見 な さ れ ま す 。

-C , --directory = DIR

何 ら か の 操 作 を 行 う 前 に 、 デ ィ レ ク ト リ DIR に 移 動 し ま す 。 こ の オ プ シ ョ ン は 順 番 を 意 識 し ま す 。 す な わ ち 、 そ の 後 に 続 く す べ て の オ プ シ ョ ン に 影 響 を 及 ぼ し ま す 。

--exclude = PATTERN

glob (3) ス タ イ ル の ワ イ ル ド カ ー ド パ タ ー ン PATTERN に マ ッ チ す る フ ァ イ ル を 除 外 し ま す (訳 注 : つ ま り 、 PATTERN の 指 定 に シ ェ ル 式 の ワ イ ル ド ー カ ー ド が 使 え る と い う こ と で す )。

--exclude-backups

バ ッ ク ア ッ プ フ ァ イ ル と ロ ッ ク フ ァ イ ル を 除 外 し ま す 。

--exclude-caches

CACHEDIR.TAG と い う 名 前 の フ ァ イ ル を 含 む デ ィ レ ク ト リ の 中 身 を 除 外 し ま す 。 た だ し 、 タ グ フ ァ イ ル 自 体 は 除 外 し ま せ ん 。 (訳 注 : CACHEDIR.TAG と そ れ が 含 む べ き 内 容 に つ い て は 、 <http://www.brynosaurus.com/cachedir/spec.html>、 ま た は <http://bford.info/cachedir/spec.html> を 見 て く だ さ い 。 )

--exclude-caches-all

CACHEDIR.TAG と い う 名 前 の フ ァ イ ル を 含 む デ ィ レ ク ト リ と タ グ フ ァ イ ル 自 体 を 除 外 し ま す 。

--exclude-caches-under

CACHEDIR.TAG と い う 名 前 の フ ァ イ ル を 含 む デ ィ レ ク ト リ 以 下 の す べ て を 除 外 し ま す (訳 注 : た だ し 、 そ の デ ィ レ ク ト リ 自 体 は 除 外 し ま せ ん )。

--exclude-ignore= FILE

デ ィ レ ク ト リ を ダ ン プ す る 前 に 、 FILE と い う フ ァ イ ル が そ こ に 含 ま れ て い る か を 調 べ ま す 。 含 ま れ て い る 場 合 は 、 そ の フ ァ イ ル か ら 除 外 パ タ ー ン を 読 み 込 み ま す 。 こ の パ タ ー ン は 、 そ の デ ィ レ ク ト リ に の み 影 響 し ま す 。

--exclude-ignore-recursive= FILE

--exclude-ignore と 同 様 で す が 、 FILE か ら 読 み 込 ん だ パ タ ー ン は 、 そ の デ ィ レ ク ト リ と す べ て の サ ブ デ ィ レ ク ト リ に 影 響 を 及 ぼ し ま す 。

--exclude-tag = FILE

FILE と い う フ ァ イ ル を 含 む デ ィ レ ク ト リ の 中 身 を 除 外 し ま す 。 た だ し 、 FILE 自 体 は 除 外 し ま せ ん 。

--exclude-tag-all = FILE

FILE と い う フ ァ イ ル を 含 む デ ィ レ ク ト リ を 除 外 し ま す 。

--exclude-tag-under = FILE

FILE と い う フ ァ イ ル を 含 む デ ィ レ ク ト リ 以 下 の す べ て を 除 外 し ま す (訳 注 : た だ し 、 そ の デ ィ レ ク ト リ 自 体 は 除 外 し ま せ ん )。

--exclude-vcs

バ ー ジ ョ ン 管 理 シ ス テ ム の デ ィ レ ク ト リ を 除 外 し ま す 。

--exclude-vcs-ignores

VCS 独 自 の 除 外 フ ァ イ ル か ら パ タ ー ン を 読 み 込 み 、 そ れ に マ ッ チ す る フ ァ イ ル を 除 外 し ま す 。 サ ポ ー ト さ れ て い る フ ァ イ ル は 、 .cvsignore , .gitignore , .bzrignore , .hgignore で す 。

-h , --dereference

シ ン ボ リ ッ ク リ ン ク を 辿 り 、 そ れ が 指 し て い る フ ァ イ ル を ア ー カ イ ブ に 入 れ ま す (訳 注 : シ ン ボ リ ッ ク リ ン ク が 指 し て い る 実 フ ァ イ ル が 、 同 一 ア ー カ イ ブ に 収 録 さ れ る と き は 、 そ の ハ ー ド リ ン ク を 、 収 録 さ れ な い と き は 実 フ ァ イ ル を 、 シ ン ボ リ ッ ク リ ン ク の フ ァ イ ル 名 で ア ー カ イ ブ に 入 れ る よ う で す )。

--hard-dereference

ハ ー ド リ ン ク を 辿 り 、 そ れ が 指 し て い る フ ァ イ ル を ア ー カ イ ブ に 入 れ ま す (訳 注 : ハ ー ド リ ン ク と し て で は な く 、 独 立 し た フ ァ イ ル と し て ア ー カ イ ブ に 入 れ ま す )。

-K , --starting-file = MEMBER

ア ー カ イ ブ 内 の 指 定 さ れ た メ ン バ ー か ら (抽 出 や 内 容 表 示 を ) 開 始 し ま す 。

--newer-mtime = DATE

DATE 以 降 に デ ー タ が 変 更 さ れ た フ ァ イ ル を 処 理 の 対 象 に し ま す 。 DATE が / ま た は . で 始 ま る 場 合 は 、 フ ァ イ ル 名 と 見 な さ れ 、 そ の フ ァ イ ル の mtime が 日 付 と し て 使 わ れ ま す 。

--no-null

こ れ よ り 前 に 指 定 さ れ た --null オ プ シ ョ ン の 効 果 を 無 効 に し ま す 。

--no-recursion

デ ィ レ ク ト リ に お い て 自 動 的 な 下 降 を し な い よ う に し ま す 。

--no-unquote

指 定 さ れ た 入 力 フ ァ イ ル 名 や メ ン バ ー 名 中 の 、 バ ッ ク ス ラ ッ シ ュ で ク ォ ー ト さ れ た シ ー ケ ン ス を 解 釈 ・ 変 換 し ま せ ん (訳 注 : す な わ ち 、 \t, \n, \b な ど を タ ブ 、 改 行 な ど と し て で は な く 、 文 字 通 り \t, \n, \b と し て 扱 う 。 な お 、 こ の オ プ シ ョ ン は コ マ ン ド ラ イ ン 上 の 位 置 が 意 味 を 持 ち ま す )。

--no-verbatim-files-from

フ ァ イ ル リ ス ト か ら 読 み 込 ん だ 各 行 を 、 あ た か も コ マ ン ド ラ イ ン か ら 打 ち 込 ま れ た か の よ う に 処 理 し ま す 。 す な わ ち 、 前 後 の 空 白 を 除 去 し た 後 の 文 字 列 が ダ ッ シ ュ で 始 ま る 場 合 は 、 tar の コ マ ン ド ラ イ ン オ プ シ ョ ン と 見 な し ま す 。

こ れ は デ フ ォ ル ト の 動 作 で す 。 こ の --no-verbatim-files-from オ プ シ ョ ン が あ る の は 、 --verbatim-files-from オ プ シ ョ ン を 指 定 し た 後 で 動 作 を 元 に 戻 す た め で す 。

こ の オ プ シ ョ ン は 指 定 す る 位 置 が 意 味 を 持 ち ま す 。 す な わ ち 、 コ マ ン ド ラ イ ン で こ の オ プ シ ョ ン よ り 後 に 指 定 さ れ る す べ て の --files-from オ プ シ ョ ン に 影 響 し 、 --verbatim-files-from オ プ シ ョ ン が 現 れ る か 、 コ マ ン ド ラ イ ン の 末 尾 に 達 す る ま で 効 果 が 続 き ま す 。

--no-null オ プ シ ョ ン を 指 定 す る と 、 こ の オ プ シ ョ ン が 暗 黙 裡 に 設 定 さ れ ま す 。

--null

後 に 続 く -T オ プ シ ョ ン に 対 し て 、 null で 終 端 さ れ た 名 前 を 文 字 通 り に 読 み 込 む よ う に 指 示 し ま す (つ ま り 、 -T オ プ シ ョ ン で ダ ッ シ ュ で 始 ま る 名 前 の 特 別 扱 い を し な く な り ま す )。

--verbatim-files-from も 参 照 し て く だ さ い 。

-N , --newer = DATE , --after-date = DATE

DATE よ り 新 し い フ ァ イ ル の み を 格 納 し ま す 。 DATE が / ま た は . で 始 ま っ て い る 場 合 は 、 フ ァ イ ル 名 と 見 な さ れ 、 そ の フ ァ イ ル の mtime が 日 付 と し て 使 わ れ ま す 。

--one-file-system

ア ー カ イ ブ を 作 成 す る 際 に 、 ロ ー カ ル フ ァ イ ル シ ス テ ム に 限 定 し ま す 。

-P , --absolute-names

ア ー カ イ ブ を 作 成 す る 際 に 、 フ ァ イ ル 名 の 先 頭 の ス ラ ッ シ ュ を 除 去 し ま せ ん 。

--recursion

デ ィ レ ク ト リ を 再 帰 的 に 辿 り ま す (デ フ ォ ル ト )。

--suffix = STRING

削 除 す る 前 に バ ッ ク ア ッ プ を 作 り 、 拡 張 子 を 通 常 の も の か ら 変 更 し ま す 。 環 境 変 数 SIMPLE_BACKUP_SUFFIX に よ っ て 変 更 さ れ て い な い か ぎ り 、 デ フ ォ ル ト の 拡 張 子 は ˜ で す 。

-T , --files-from = FILE

ア ー カ イ ブ か ら 抽 出 す る 名 前 や ア ー カ イ ブ に 格 納 す る 名 前 を FILE か ら 読 み 込 み ま す 。

別 の 指 定 が な い か ぎ り 、 FILE の 内 容 は 、 ASCII LF で 区 切 ら れ た 名 前 の リ ス ト で な け れ ば な り ま せ ん (つ ま り 、 1 行 に 1 個 の 名 前 で す )。 読 み 込 ま れ た 名 前 は 、 コ マ ン ド ラ イ ン の 引 数 と 同 じ や り 方 で 処 理 さ れ ま す 。 す な わ ち 、 引 用 符 が 除 去 さ れ 、 単 語 に 分 割 さ れ 、 そ し て 、 ダ ッ シ ュ ( - ) で 始 ま る 文 字 列 が あ れ ば 、 tar の コ マ ン ド ラ イ ン オ プ シ ョ ン と し て 処 理 さ れ ま す 。

こ の 動 作 が 望 ま し く な い 場 合 は 、 --verbatim-files-from オ プ シ ョ ン で や め さ せ る こ と が で き ま す 。

--null オ プ シ ョ ン を 指 定 す る と 、 tar は FILE 中 の 名 前 の 区 切 り を LF で は な く 、 ASCII NUL 文 字 に し ま す 。 こ れ は リ ス ト が find (1) の -print0 ア ク シ ョ ン で 生 成 さ れ て い る 場 合 に 役 に 立 ち ま す 。

--unquote

指 定 さ れ た 入 力 フ ァ イ ル 名 や メ ン バ ー 名 中 の 、 バ ッ ク ス ラ ッ シ ュ で ク ォ ー ト さ れ た シ ー ケ ン ス を 解 釈 ・ 変 換 し ま す (デ フ ォ ル ト )。 (訳 注 : す な わ ち 、 \t, \n, \b な ど を タ ブ 、 改 行 な ど と し て 扱 う と い う こ と で す 。 な お 、 こ の オ プ シ ョ ン は コ マ ン ド ラ イ ン 上 の 位 置 が 意 味 を 持 ち ま す 。 )

--verbatim-files-from

フ ァ イ ル リ ス ト か ら 読 み 込 ん だ 各 行 が ダ ッ シ ュ で 始 ま っ て い て も 、 フ ィ ル 名 と し て 扱 い ま す 。 フ ァ イ ル リ ス ト の 取 得 に は 、 --files-from ( -T ) オ プ シ ョ ン を 使 用 し ま す 。 tar の デ フ ォ ル ト の 動 作 は 、 フ ァ イ ル リ ス ト か ら 読 み 込 ん だ 名 前 を 、 あ た か も コ マ ン ド ラ イ ン か ら 打 ち 込 ま れ た か の よ う に 処 理 す る こ と で す 。 す な わ ち 、 ダ ッ シ ュ で 始 ま っ て い る 名 前 が あ れ ば 、 tar の オ プ シ ョ ン と 見 な し ま す 。 こ の --verbatim-files-from オ プ シ ョ ン は 、 そ う し た 動 作 を し な い よ う に し ま す 。

こ の オ プ シ ョ ン は 、 コ マ ン ド ラ イ ン で こ れ よ り 後 に 指 定 さ れ る す べ て の --files-from オ プ シ ョ ン に 影 響 を 与 え ま す 。 こ の オ プ シ ョ ン の 効 果 は 、 --no-verbatim-files-from オ プ シ ョ ン に よ っ て 元 に 戻 す こ と が で き ま す 。

--null オ プ シ ョ ン を 指 定 す る と 、 こ の オ プ シ ョ ン が 暗 黙 裡 に 設 定 さ れ ま す 。

--add-file も 参 照 し て く だ さ い 。

-X , --exclude-from = FILE

FILE に リ ス ト さ れ た パ タ ー ン に マ ッ チ す る フ ァ イ ル を 除 外 し ま す 。

フ ァ イ ル 名 の 変 更

--strip-components = NUMBER

抽 出 時 に フ ァ イ ル 名 の 先 頭 か ら NUMBER 個 の 構 成 要 素 (訳 注 : 要 す る に 、 NUMBER 個 の デ ィ レ ク ト リ 部 分 ) を 取 り 去 り ま す 。

--transform = EXPRESSION , --xform = EXPRESSION

sed の 置 換 表 現 EXPRESSION を フ ァ イ ル 名 の 変 更 に 使 い ま す 。

フ ァ イ ル 名 の マ ッ チ ン グ に 関 す る オ プ シ ョ ン

こ れ ら の オ プ シ ョ ン は 除 外 (exclude) パ タ ー ン と 包 摂 (include) パ タ ー ン の 両 方 に 影 響 し ま す 。
--anchored

パ タ ー ン は フ ァ イ ル 名 の 先 頭 に マ ッ チ し ま す 。

--ignore-case

大 文 字 小 文 字 を 区 別 し ま せ ん 。

--no-anchored

パ タ ー ン は ど の / の 後 に で も マ ッ チ し ま す (除 外 時 の デ フ ォ ル ト )。

--no-ignore-case

大 文 字 小 文 字 を 区 別 し て マ ッ チ ン グ を 行 い ま す (デ フ ォ ル ト )。

--no-wildcards

パ タ ー ン の 文 字 列 を 文 字 通 り に 解 し て マ ッ チ ン グ を 行 い ま す (訳 注 : こ れ は ワ イ ル ド カ ー ド 文 字 を た だ の 文 字 と し て 扱 う と い う こ と で す 。 \t, \n な ど を 文 字 通 り に 読 む 方 は 、 --no-unquote を 使 い ま す )。

--no-wildcards-match-slash

ワ イ ル ド カ ー ド は / に マ ッ チ し ま せ ん 。

--wildcards

ワ イ ル ド カ ー ド を 使 い ま す (除 外 時 の デ フ ォ ル ト )。

--wildcards-match-slash

ワ イ ル ド カ ー ド は / に マ ッ チ し ま す (除 外 時 の デ フ ォ ル ト )。

情 報 出 力

--checkpoint [= N ]

N レ コ ー ド (デ フ ォ ル ト は 10) ご と に 進 捗 メ ッ セ ー ジ を 表 示 し ま す 。

--checkpoint-action = ACTION

チ ェ ッ ク ポ イ ン ト ご と に ACTION を 実 行 し ま す 。

--clamp-mtime

--mtime で 指 定 さ れ た 日 時 よ り 新 し い フ ァ イ ル に 対 し て の み 、 日 時 を 設 定 し ま す 。

--full-time

高 精 度 で フ ァ イ ル の 日 時 を 表 示 し ま す (訳 注 : tar 1.32 で は 秒 ま で 。 -v オ プ シ ョ ン が 必 要 )。

--index-file = FILE

詳 細 出 力 を FILE に 書 き 出 し ま す 。

-l , --check-links

ハ ー ド リ ン ク の す べ て を ダ ン プ し て い な い 場 合 に 、 そ の 旨 メ ッ セ ー ジ を 出 し ま す 。

--no-quote-chars = STRING

STRING に 列 挙 さ れ た 文 字 を 、 表 示 す る と き に ク ォ ー ト す る 文 字 の リ ス ト か ら 外 し ま す (訳 注 : リ ス ト か ら 外 せ る の は 、 --quote-chars に よ っ て 追 加 さ れ た 文 字 だ け で あ り 、 デ フ ォ ル ト で ク ォ ー ト す る こ と に な っ て い る 文 字 を 外 せ る わ け で は あ り ま せ ん 。 次 の 項 目 と も ど も info tar を 参 照 し て く だ さ い )。

--quote-chars = STRING

STRING に 列 挙 さ れ た 文 字 を 、 表 示 す る と き に ク ォ ー ト す る 文 字 の リ ス ト に 追 加 し ま す 。

--quoting-style = STYLE

フ ァ イ ル 名 や メ ン バ ー 名 を 表 示 す る と き の ク ォ ー ト 形 式 を 設 定 し ま す 。 STYLE に 指 定 で き る 値 は 以 下 の と お り で す 。 literal , shell , shell-always , c , c-maybe , escape , locale , clocale .

-R , --block-number

各 メ ッ セ ー ジ に ア ー カ イ ブ 中 の ブ ロ ッ ク 番 号 を 付 け ま す 。

--show-omitted-dirs

内 容 表 示 や 抽 出 を す る 際 、 検 索 の 基 準 に マ ッ チ し な い デ ィ レ ク ト リ に 出 会 う ご と に 、 そ の 旨 表 示 し ま す (訳 注 : 要 す る に 、 何 ら か の 理 由 で 、 内 容 表 示 や 抽 出 を ス キ ッ プ す る デ ィ レ ク ト リ が あ れ ば 、 そ れ を 知 ら せ る と い う こ と で す 。 info tar verbose を 実 行 す る と 、 そ の セ ク シ ョ ン に こ の オ プ シ ョ ン の か な り 詳 し い 説 明 が あ り ま す )。

--show-transformed-names , --show-stored-names

フ ァ イ ル 名 や ア ー カ イ ブ 名 を 表 示 す る 際 、 --strip や --transform オ プ シ ョ ン で 変 更 し た 後 の 名 前 を 使 い ま す (訳 注 : デ フ ォ ル ト で は 変 更 前 の 名 前 が 使 わ れ ま す )。

--totals [= SIGNAL ]

ア ー カ イ ブ を 処 理 し た 後 で 総 バ イ ト 数 を 表 示 し ま す 。 SIGNAL を 指 定 す る と 、 そ の シ グ ナ ル が 送 ら れ た と き の 総 バ イ ト 数 を 表 示 し ま す 。 指 定 で き る シ グ ナ ル は 、 SIGHUP , SIGQUIT , SIGINT , SIGUSR1 , SIGUSR2 で す 。 接 頭 辞 の SIG は 省 略 で き ま す 。

--utc

フ ァ イ ル 更 新 日 時 を UTC で 表 示 し ま す 。

-v , --verbose

処 理 し た フ ァ イ ル の 詳 し い リ ス ト を 出 力 し ま す 。 こ の オ プ シ ョ ン を コ マ ン ド ラ イ ン で 指 定 し た 数 だ け 、 詳 細 レ ベ ル が 1 つ ず つ 上 が り ま す 。 最 大 の 詳 細 レ ベ ル は 3 で す 。 そ れ ぞ れ の 詳 細 レ ベ ル で tar の 出 力 が ど の よ う に な る か に つ い て は 、 GNU Tar Manual の サ ブ セ ク シ ョ ン 2.5.2 " The ’--verbose’ Option " に 詳 し い 説 明 が あ る の で 、 参 照 し て く だ さ い (訳 注 : info tar ’verbose tutorial’ で 見 る こ と が で き ま す )。

--warning = KEYWORD

KEYWORD で 特 定 さ れ る 警 告 メ ッ セ ー ジ を 有 効 、 ま た は 無 効 に し ま す 。 KEYWORD の 前 に no- を 付 け れ ば 、 そ の メ ッ セ ー ジ は 抑 制 さ れ 、 付 け な け れ ば 、 有 効 に な り ま す 。

--warning の メ ッ セ ー ジ を 複 数 指 定 す る と 、 前 の 指 定 に 後 の も の が 積 み 重 な っ て 行 き ま す 。

以 下 の キ ー ワ ー ド は tar の 操 作 全 般 を 制 御 す る も の で す :

	all		す べ て の 警 告 メ ッ セ ー ジ を 有 効 に し ま す 。 こ れ が デ フ ォ ル ト で す 。
	none		す べ て の 警 告 メ ッ セ ー ジ を 無 効 に し ま す 。

filename-with-nuls

"%s: 読 み 込 ん だ フ ァ イ ル 名 に ヌ ル 文 字 が 含 ま れ て い ま す "

alone-zero-block

"%s に 孤 立 し た ゼ ロ ブ ロ ッ ク が あ り ま す "

以 下 の キ ー ワ ー ド は tar --create に 対 し て 適 用 さ れ ま す :

cachedir

"%s: キ ャ ッ シ ュ デ ィ レ ク ト リ の タ グ %s が あ り ま す ; %s"

file-shrank

"%s: フ ァ イ ル が %s バ イ ト 小 さ く な っ た の で 、 ゼ ロ で 埋 め ま す "

xdev

"%s: フ ァ イ ル が 異 な る フ ァ イ ル シ ス テ ム 上 に あ る の で 、 ダ ン プ し ま せ ん "

file-ignored

"%s: 未 知 の フ ァ イ ル タ イ プ で す 。 こ の フ ァ イ ル は 無 視 し ま す "
"%s: ソ ケ ッ ト は 無 視 し ま す "
"%s: door は 無 視 し ま す "

file-unchanged

"%s: フ ァ イ ル が 変 更 さ れ て い な い の で 、 ダ ン プ し ま せ ん "

ignore-archive

"%s: フ ァ イ ル が こ の ア ー カ イ ブ そ の も の な の で 、 ダ ン プ し ま せ ん "

file-removed

"%s: フ ァ イ ル が 読 み 込 む 前 に 削 除 さ れ ま し た "

file-changed

"%s: フ ァ イ ル が 読 み 込 み 中 に 変 更 さ れ ま し た "

failed-read

読 み 込 み 不 能 な フ ァ イ ル や デ ィ レ ク ト リ に つ い て の 警 告 メ ッ セ ー ジ を 抑 止 し ま す 。 こ の キ ー ワ ー ド は --ignore-failed-read オ プ シ ョ ン と 一 緒 に 使 用 し た 場 合 に の み 適 用 さ れ ま す 。

以 下 の キ ー ワ ー ド は tar --extract に 対 し て 適 用 さ れ ま す :

existing-file

"%s: 既 存 フ ァ イ ル を ス キ ッ プ し ま す "

timestamp

"%s: あ ま り に も 古 い タ イ ム ス タ ン プ %s"
"%s: タ イ ム ス タ ン プ %s は %s 秒 後 の 日 時 を 示 し て い ま す "

contiguous-cast

"連 続 し た フ ァ イ ル (contiguous files) を 普 通 の フ ァ イ ル と し て 取 り 出 し ま す "

symlink-cast

"シ ン ボ リ ッ ク リ ン ク を ハ ー ド リ ン ク と し て 取 り 出 し て み ま す "

unknown-cast

"%s: 未 知 の フ ァ イ ル タ イ プ ’%c’。 通 常 の フ ァ イ ル と し て 抽 出 し ま す "

ignore-newer

"現 在 の %s の 方 が 新 し い か 同 じ で す "

unknown-keyword

"未 知 の 拡 張 ヘ ッ ダ キ ー ワ ー ド ’%s’ を 無 視 し ま す "

decompress-program

あ る 伸 長 プ ロ グ ラ ム の 実 行 に 失 敗 し て 、 別 の プ ロ グ ラ ム で 代 用 し よ う と し た と き に 出 る 詳 し い 説 明 を 制 御 し ま す 。 こ の 警 告 は 、 デ フ ォ ル ト で は 無 効 に な っ て い ま す ( --verbose 使 用 時 を 除 き ま す )。 こ の 警 告 を 有 効 に し た と き に 表 示 さ れ る よ く あ る 例 は 、 次 の よ う な も の で す ：

$ tar --warning=decompress-program -x -f archive.Z
tar (child): cannot run compress: No such file or directory
tar (child): trying gzip

こ の メ ッ セ ー ジ は 、 tar が 最 初 に compress を 使 っ て archive.Z を 伸 長 し よ う と し て 、 そ れ に 失 敗 し 、 gzip に 切 り 替 え た こ と を 示 し て い ま す 。

record-size

"レ コ ー ド サ イ ズ = %lu ブ ロ ッ ク "

イ ン ク リ メ ン タ ル な 抽 出 を 制 御 す る キ ー ワ ー ド :

rename-directory

"%s: デ ィ レ ク ト リ 名 が %s か ら 変 更 さ れ ま し た "
"%s: デ ィ レ ク ト リ 名 が 変 更 さ れ ま し た "

new-directory

"%s: デ ィ レ ク ト リ が 新 し く 作 ら れ ま し た "

xdev

"%s: デ ィ レ ク ト リ が 異 な る デ バ イ ス 上 に あ る の で 消 去 し ま せ ん "

bad-dumpdir

"不 正 形 式 の dumpdir: ’X’ が 未 使 用 "

-w , --interactive , --confirmation

す べ て の 動 作 に 対 し て 確 認 を 求 め ま す 。

互 換 オ プ シ ョ ン

-o

作 成 時 は --old-archive と 同 じ で あ り 、 抽 出 時 は --no-same-owner と 同 じ で す 。

サ イ ズ 接 尾 辞

接 尾 辞 単 位 バ イ ト サ イ ズ

	b	ブ ロ ッ ク	SIZE x 512
	B	キ ロ バ イ ト	SIZE x 1024
	c	バ イ ト	SIZE
	G	ギ ガ バ イ ト	SIZE x 1024ˆ3
	K	キ ロ バ イ ト	SIZE x 1024
	k	キ ロ バ イ ト	SIZE x 1024
	M	メ ガ バ イ ト	SIZE x 1024ˆ2
	P	ペ タ バ イ ト	SIZE x 1024ˆ5
	T	テ ラ バ イ ト	SIZE x 1024ˆ4
	w	ワ ー ド	SIZE x 2

返 り 値

tar の 終 了 コ ー ド は 、 要 求 さ れ た 操 作 の 遂 行 に 成 功 し た か ど う か 、 成 功 し な か っ た 場 合 は 、 ど の よ う な エ ラ ー が 起 き た か を 示 し て い ま す 。

	0		成 功 し て 終 了 し ま し た 。
	1		い く つ か の フ ァ イ ル に 相 違 が あ り ま す 。 tar が --compare ( --diff , -d ) コ マ ン ド ラ イ ン オ プ シ ョ ン と と も に 起 動 さ れ た 場 合 は 、 ア ー カ イ ブ 内 の フ ァ イ ル に デ ィ ス ク 上 の 同 名 フ ァ イ ル と 異 な っ て い る も の が あ る と い う こ と で す 。 --create , --append , --update オ プ シ ョ ン の い ず れ か が 指 定 さ れ た 場 合 は 、 ア ー カ イ ブ 処 理 の 最 中 に 変 更 さ れ た フ ァ イ ル が あ り 、 従 っ て 、 生 成 さ れ た ア ー カ イ ブ は フ ァ イ ル セ ッ ト の 正 確 な コ ピ ー を 保 持 し て い な い こ と を 示 し て い ま す 。
	2		致 命 的 な エ ラ ー 。 こ れ は 、 何 ら か の 致 命 的 で 回 復 不 能 な エ ラ ー が 起 き た こ と を 表 し て い ま す 。

tar に よ っ て 起 動 さ れ た サ ブ プ ロ セ ス が 、 0 以 外 の 終 了 コ ー ド で 終 了 し た 場 合 は 、 tar 自 身 も そ の 終 了 コ ー ド で 終 了 し ま す 。 た と え ば 、 圧 縮 オ プ シ ョ ン ( -z な ど ) を 使 用 し た と き 、 外 部 の 圧 縮 プ ロ グ ラ ム が 実 行 に 失 敗 す る と 、 そ う し た こ と が 起 こ り 得 ま す 。 他 の 例 と し て は 、 rmt が リ モ ー ト デ バ イ ス へ の バ ッ ク ア ッ プ 中 に 失 敗 し た 場 合 な ど が あ り ま す 。

関 連 項 目

bzip2 (1), compress (1), gzip (1), lzma (1), lzop (1), rmt (8), symlink (7), xz (1), zstd (1).

詳 細 な tar マ ニ ュ ア ル は 、 info tar を 実 行 す る か 、 emacs (1) の info モ ー ド を 使 用 す れ ば 、 読 む こ と が で き ま す 。

ま た 、 以 下 の サ イ ト に 行 け ば 、 様 々 な 形 式 に し た GNU tar マ ニ ュ ア ル の オ ン ラ イ ン 版 を 見 つ け る こ と が で き ま す 。

http://www.gnu.org/software/tar/manual

バ グ 報 告

バ グ は <bug-tar@gnu.org> に 報 告 し て く だ さ い 。

著 作 権

Copyright © 2013-2019 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

---