Manpages

名 前

shar − シ ェ ル ア ー カ イ ブ を 作 成 す る

書 式

shar [ options ] file ...
shar −S [ options ]

説 明

shar は 「 シ ェ ル ア ー カ イ ブ (shar フ ァ イ ル )」 を 作 成 す る 。 こ れ は テ キ ス ト 形 式 な の で 、 メ ー ル で 送 る こ と が で き る 。 こ れ ら の フ ァ イ ル を ほ ど く に は 、 /bin/sh を 使 っ て 実 行 す れ ば よ い 。 作 成 さ れ た ア ー カ イ ブ は 、 −o オ プ シ ョ ン で 指 示 さ れ な い 限 り 、 標 準 出 力 に 送 ら れ る 。 shar に は 様 々 な 機 能 が あ る の で 、 shar フ ァ イ ル の 作 成 や shar の 「 賢 さ (smartness)」 の 指 定 は 、 非 常 に 柔 軟 に 行 う こ と が で き る 。 ア ー カ イ ブ は 、 「 簡 潔 (vanilla)」 に も 詳 細 に も で き る 。

オ プ シ ョ ン

オ プ シ ョ ン に は 、 − で 始 ま る 1 文 字 の バ ー ジ ョ ン と 、 −− で 始 ま る 長 い バ ー ジ ョ ン が あ る 。 −−help, −−version, −−no-i18n, −−print-text-domain-dir は 例 外 で 、 短 い バ ー ジ ョ ン が な い 。 長 い オ プ シ ョ ン に 必 須 の 引 き 数 は 、 短 い オ プ シ ョ ン で も 必 須 で あ る 。 オ プ シ ョ ン は ど の よ う な 順 番 で も 与 え る こ と が で き る 。 互 い に 依 存 し て い る オ プ シ ョ ン も あ る 。 た と え ば 、

−−version プ ロ グ ラ ム の バ ー ジ ョ ン 番 号 を 標 準 出 力 に 表 示 し 、 す ぐ に 終 了 す る 。
−q −−quiet −−silent ア ー カ イ ブ を 作 成 す る と き 、 詳 細 な メ ッ セ ー ジ を 出 力 し な い 。 フ ァ イ ル の 選 択 ：
−p −−intermix-type 指 定 位 置 に 依 存 す る パ ラ メ ー タ ー オ プ シ ョ ン の 使 用 を 許 す 。 −B, −T, -z, −Z オ プ シ ョ ン を (フ ァ イ ル リ ス ト に ) 入 れ て よ い 。 こ の オ プ シ ョ ン の 後 ろ の フ ァ イ ル は す べ て 、 指 示 さ れ た モ ー ド で 処 理 さ れ る 。
−S −−stdin-file-list コ マ ン ド ラ イ ン か ら で は な く 、 標 準 入 力 か ら パ ッ ク す る フ ァ イ ル の 一 覧 を 読 み 込 む 。 入 力 は find コ マ ン ド で 生 成 さ れ る 形 式 と 同 じ く 、 1 行 に 1 つ の フ ァ イ ル 名 で な け れ ば な ら な い 。 パ ッ ク す る フ ァ イ ル の 一 覧 を コ マ ン ド ラ イ ン に 書 け な い 場 合 に 、 こ の オ プ シ ョ ン は 非 常 に 役 立 つ 。 た と え ば 、

find . −type f −print | sort | shar −S −Z −L50 −o /tmp/big

−p が 指 定 さ れ た 場 合 、 −B, −T, −z, −Z オ プ シ ョ ン を 標 準 入 力 に 入 れ る こ と が で き る (行 は フ ァ イ ル 名 で 区 切 ら れ る )。 標 準 入 力 の 行 数 、 フ ァ イ ル 名 、 オ プ シ ョ ン は 最 大 1024 を 越 え て は な ら な い 。 出 力 の 分 割 ：

−o XXX −−output-prefix=XXX ア ー カ イ ブ を 標 準 出 力 に 送 ら ず 、 フ ァ イ ル XXX.01 か ら XXX.nn に 保 存 す る 。 −l ま た は −L オ プ シ ョ ン を 使 う 場 合 、 こ の オ プ シ ョ ン を 使 う こ と 。
−l XX −−whole-size-limit=XX 出 力 フ ァ イ ル の サ イ ズ を XX キ ロ バ イ ト に 制 限 し よ う と す る (こ の サ イ ズ よ り 小 さ く な る 場 合 は 、 複 数 の 入 力 フ ァ イ ル を ま と め た 出 力 フ ァ イ ル を 作 成 す る )。 し か し 、 (1 つ の 入 力 フ ァ イ ル を ア ー カ イ ブ し た サ イ ズ が こ れ よ り 大 き く な る 場 合 で も ) 入 力 フ ァ イ ル を 途 中 で 分 割 し な い 。
−L XX −−split-size-limit=XX 出 力 フ ァ イ ル の サ イ ズ を XX キ ロ バ イ ト に 制 限 し 、 必 要 な ら ば 分 割 す る 。 こ の オ プ シ ョ ン で 作 ら れ た 、 分 割 形 式 の ア ー カ イ ブ フ ァ イ ル は 、 正 し い 順 番 で フ ァ イ ル を 取 り 出 さ な け れ ば な ら な い 。

shar ヘ ッ ダ ー の 制 御 ：
−n name −−archive-name=name

shar フ ァ イ ル の ヘ ッ ダ ー に ア ー カ イ ブ 名 を 入 れ る 。 −a オ プ シ ョ ン を 参 照 す る こ と 。

−s who@where −−submitter=who@where 自 動 的 に 決 定 さ れ る 作 成 者 名 を 上 書 き す る 。
−a −−net-headers 次 の よ う な ヘ ッ ダ ー を 自 動 生 成 す る 。

Submitted-by: who@where

<name> は −n オ プ シ ョ ン で 指 示 し な け れ ば な ら な い 。 name に ’/’ が 含 ま れ て い る 場 合 、 "/part" は 使 わ れ な い 。 つ ま り 、

−c −−cut-mark

shar フ ァ イ ル を cut line で 始 め る 。 ’Cut here’ と 書 か れ た 行 が 、 各 出 力 フ ァ イ ル の 先 頭 に 置 か れ る 。 フ ァ イ ル の 格 納 法 の 選 択 ：

−M −−mixed-uuencode 混 合 モ ー ド 。 フ ァ イ ル が テ キ ス ト な の か バ イ ナ リ な の か を 決 定 し 、 正 し く ア ー カ イ ブ を 作 る (デ フ ォ ル ト で あ る )。 バ イ ナ リ で あ る と わ か っ た フ ァ イ ル は 、 パ ッ ク す る 前 に uuencode さ れ る (ネ ッ ト ワ ー ク 上 の 多 く の 人 に 、 uuencode の 使 用 は 煙 た が ら れ る )。
−T −−text-files す べ て の フ ァ イ ル を テ キ ス ト と し て 扱 う 。
−B −−uuencode す べ て の フ ァ イ ル を バ イ ナ リ と し て 扱 い 、 パ ッ ク す る 前 に uuencode す る 。 こ の オ プ シ ョ ン は 、 ア ー カ イ ブ の サ イ ズ を 増 大 さ せ る 。 受 信 者 は 、 フ ァ イ ル を 取 り 出 す た め に uudecode を 持 っ て い な け れ ば な ら な い (ネ ッ ト ワ ー ク 上 の 多 く の 人 に 、 uuencode の 使 用 は 煙 た が ら れ る )。
−z −−gzip パ ッ ク す る 前 に 、 す べ て の フ ァ イ ル を gzip し て uuencode す る 。 受 信 者 は 、 フ ァ イ ル を 取 り 出 す た め に uudecode と gzip を 持 っ て い な け れ ば な ら な い (ネ ッ ト ワ ー ク 上 の 多 く の 人 に 、 uuencode と gzip の 使 用 は 煙 た が ら れ る )。
−g LEVEL −−level-for-gzip=LEVEL 圧 縮 す る と き 、 ’−LEVEL’ を gzip の パ ラ メ ー タ ー と し て 使 う 。 デ フ ォ ル ト は 9 で あ る 。 −g オ プ シ ョ ン は 、 デ フ ォ ル ト で −z オ プ シ ョ ン を オ ン に す る 。
−Z −−compress パ ッ ク す る 前 に 、 す べ て の フ ァ イ ル を compress し て uuencode す る 。 受 信 者 は 、 フ ァ イ ル を 取 り 出 す た め に uudecode と compress を 持 っ て い な け れ ば な ら な い (ネ ッ ト ワ ー ク 上 の 多 く の 人 に 、 uuencode と compress の 使 用 は 煙 た が ら れ る )。 −C オ プ シ ョ ン は 、 −Z と 同 義 で あ る が 、 推 奨 さ れ な い 。
−b BITS −−bits-per-code=BITS 圧 縮 す る と き 、 ’−bBITS’ を compress の パ ラ メ ー タ ー と し て 使 う 。 −B オ プ シ ョ ン は 、 デ フ ォ ル ト で −Z オ プ シ ョ ン を オ ン に す る 。 デ フ ォ ル ト の 値 は 12 で あ る 。 転 送 エ ラ ー に 対 す る 保 護 ：
−w −−no-character-count フ ァ イ ル を 取 り 出 す し た 後 、 ’wc −c’ を 使 っ て 各 フ ァ イ ル を チ ェ ッ ク し な い 。 デ フ ォ ル ト で は チ ェ ッ ク す る 。
−D −−no-md5-digest 取 り 出 し た フ ァ イ ル を 検 査 す る た め に ’md5sum’ ダ イ ジ ェ ス ト を 使 わ な い 。 デ フ ォ ル ト で は 、 チ ェ ッ ク す る 。
−F −−force-prefix 必 要 が な い 場 合 で も 、 強 制 的 に プ レ フ ィ ッ ク ス 文 字 (−d オ プ シ ョ ン の 引 き 数 が ’X’ で 始 ま っ て い な い 限 り 、 通 常 は ’X’) を す べ て の 行 の 行 頭 に お く 。 特 に −B や −Z が 使 わ れ る 場 合 、 こ の オ プ シ ョ ン は ア ー カ イ ブ の サ イ ズ を 少 し 増 加 さ せ る 。
−d XXX −−here-delimiter=XXX

SHAR_EOF の か わ り に XXX を shar ア ー カ イ ブ の 中 の フ ァ イ ル の 境 界 に 使 う 。 こ の オ プ シ ョ ン は 、 shar フ ァ イ ル を そ の 人 独 自 の も の に し た い 人 の た め に あ る 。 何 種 類 か の shar フ ァ イ ル の 作 成 ：

−V −−vanilla-operation

unshar を す る 環 境 に sed と echo だ け が あ れ ば 良 い よ う な 、 「 簡 潔 な (vanilla)」 shar フ ァ イ ル を 生 成 す る 。 さ ら に 、 −x オ プ シ ョ ン を 使 わ な い と き は 、 "if test" を サ ポ ー ト し な け れ ば な ら な い 。 −V オ プ シ ョ ン は 、 "network cop" (ま た は 、 "brown shirt" (訳 註 ： や た ら と 検 閲 し た が る 人 )) が 不 快 に 感 じ る オ プ シ ョ ン を 暗 黙 の う ち に 不 可 に す る 。 し か し 、 −B, -z, −Z, −p, −M オ プ シ ョ ン と 同 時 に 指 定 さ れ る と 、 警 告 を 発 す る (こ れ ら の オ プ シ ョ ン は 、 unshar を す る 環 境 に uudecode, gzip, compress を 必 要 と す る )。

−P −−no-piping

shar フ ァ イ ル (の 展 開 ) に パ イ プ で は な く 一 時 フ ァ イ ル を 使 う 。

−x −−no-check-existing チ ェ ッ ク せ ず に 、 既 に 存 在 す る フ ァ イ ル を 上 書 き す る 。 −x も −X も 指 定 さ れ な い 場 合 は 、 ア ー カ イ ブ か ら フ ァ イ ル を 取 り 出 す と き に 、 既 に 存 在 す る フ ァ イ ル を チ ェ ッ ク し て 上 書 き し な い 。 フ ァ イ ル を 取 り 出 す と き 、

sh archive -c

在 す る フ ァ イ ル が 無 条 件 に 上 書 き さ れ る 。

−X −−query-user フ ァ イ ル を 取 り 出 す と き 、 フ ァ イ ル の 上 書 き を ユ ー ザ ー に 対 話 的 に 尋 ね る 。 (ネ ッ ト ワ ー ク 上 に 送 信 す る shar フ ァ イ ル に 使 っ て は な ら な い )。
−m −−no-timestamp ア ー カ イ ブ か ら フ ァ イ ル を 取 り 出 す と き に ’touch’ コ マ ン ド を 生 成 し な い 。 フ ァ イ ル 修 正 日 時 は 復 元 さ れ な い 。
−Q −−quiet-unshar 詳 細 出 力 を し な い 。 フ ァ イ ル を 取 り 出 す と き に 出 力 さ れ る コ メ ン ト を ア ー カ イ ブ に 含 め な い 。
−f −−basename パ ス を 考 慮 せ ず 、 フ ァ イ ル 名 だ け で 復 元 を す る 。 こ の オ プ シ ョ ン は フ ァ イ ル 名 だ け が 使 わ れ る よ う に す る 。 shar フ ァ イ ル が 複 数 の デ ィ レ ク ト リ か ら 作 ら れ る 場 合 に 役 立 つ 。 デ ィ レ ク ト リ 名 が shar に 渡 さ れ る 場 合 、 −f オ プ シ ョ ン が 指 定 さ れ て い る か ど う か に 関 係 な く 、 そ の デ ィ レ ク ト リ 以 下 の 階 層 は 復 元 さ れ る こ と に 注 意 す る こ と 。 国 際 化 ：
−−no-i18n 国 際 化 さ れ た シ ェ ル ア ー カ イ ブ を 作 ら ず 、 デ フ ォ ル ト の 英 語 メ ッ セ ー ジ を 使 う 。 shar は 通 常 、 ア ー カ イ ブ か ら フ ァ イ ル を 取 り 出 す と き に (環 境 変 数 LANG/LC_MESSAGES で 決 定 さ れ る ) そ の 人 の 好 み の 言 語 で メ ッ セ ー ジ を 出 力 す る こ と が で き る ア ー カ イ ブ を 作 る 。 フ ァ イ ル を 取 り 出 す と き 、 そ の 人 の 言 語 の メ ッ セ ー ジ フ ァ イ ル が な い 場 合 は 、 メ ッ セ ー ジ は 英 語 に な る 。
−−print-text-domain-dir

shar が い ろ い ろ な 言 語 の メ ッ セ ー ジ フ ァ イ ル を 見 つ け る た め の デ ィ レ ク ト リ を 表 示 し 、 す ぐ に 終 了 す る 。

例

shar *.c > cprog.shar # す べ て の C プ ロ グ ラ ム ソ ー ス

警 告

フ ァ イ ル を 取 り 出 す と き 作 ら れ る デ ィ レ ク ト リ に 対 し て 、 chmod と touch が 起 動 さ れ る こ と は な い 。 よ っ て 、 デ ィ レ ク ト リ を shar で パ ッ ク す る と 、 取 り 出 さ れ た デ ィ レ ク ト リ の ア ク セ ス 権 ・ 修 正 日 時 は 、 元 の デ ィ レ ク ト リ の も の と 一 致 し な い 。

shar に デ ィ レ ク ト リ を 渡 す と 、 デ ィ レ ク ト リ は 2 回 以 上 ス キ ャ ン さ れ る 。 よ っ て 、 shar が 動 作 し て い る 間 に デ ィ レ ク ト リ を 変 更 し な い よ う に 注 意 し な け れ ば な ら な い 。 出 力 フ ァ イ ル が 入 力 フ ァ イ ル に 含 ま れ な い よ う に 注 意 す る こ と 。 さ も な い と 、 shar は デ ィ ス ク が 溢 れ る ま で ル ー プ す る 。 特 に 、 shar に デ ィ レ ク ト リ を 渡 す と き は 、 出 力 フ ァ イ ル を そ の デ ィ レ ク ト リ (も し く は そ の サ ブ デ ィ レ ク ト リ ) に 置 か な い よ う に 注 意 す る こ と 。

−B, −z, −Z, 特 に −M を 使 う と 、 フ ァ イ ル 数 に 応 じ て ア ー カ イ ブ プ ロ セ ス が 非 常 に 遅 く な る 。

−X オ プ シ ョ ン を 使 う と 、 多 く の unshar プ ロ セ ス で \[u9593]違 い な く 問 題 を 引 き 起 こ す shar フ ァ イ ル が 作 ら れ る 。 こ の 機 能 を 使 う の は 、 合 意 の 取 れ た 集 団 内 で 受 け 渡 さ れ る ア ー カ イ ブ の み に す る こ と 。 も ち ろ ん 、 −X は Usenet に 発 信 さ れ る シ ェ ル ア ー カ イ ブ の た め の も の で は な い 。 −B, −z, −Z を ネ ッ ト ワ ー ク 上 の shar フ ァ イ ル に 使 う と 、 非 常 に 非 難 さ れ る だ ろ う 。 −m と −F を 使 わ な い 場 合 も 、 時 々 苦 情 を 言 わ れ る だ ろ う 。

関 連 項 目

unshar(1)

返 り 値

不 正 な オ プ シ ョ ン ・ 矛 盾 す る オ プ シ ョ ン 、 一 般 で な い フ ァ イ ル ・ 見 つ か ら な い フ ァ イ ル ・ ア ク セ ス で き な い フ ァ イ ル 、 (有 り 得 な い ) メ モ リ 割 り 当 て の 失 敗 、 に 対 す る エ ラ ー メ ッ セ ー ジ 。

著 者

shar と unshar プ ロ グ ラ ム は 多 く の 著 者 の 協 同 作 品 で あ る 。 多 く の 人 々 が 、 問 題 の 報 告 ・ い ろ い ろ な 改 良 の 示 唆 ・ 実 際 の コ ー ド の 提 供 に 貢 献 し て く れ た 。 こ れ ら の 人 々 は sharutils デ ィ ス ト リ ビ ュ ー シ ョ ン の THANKS と い う フ ァ イ ル に リ ス ト さ れ て い る 。