UNSHAR(1) |
FreeBSD General Commands Manual |
UNSHAR(1) |
名前
unshar - shar ファイルからファイルを取り出す
書式
unshar [ options ] [ file ... ]
説明
unshar は、メールメッセージをスキャンしてシェルアーカイブのはじまりを探し、アーカイブの部分を (内部で起動した) シェルにかけて、ファイルを取り出す。複数のファイルも受け付ける。ファイルが指定されない場合、標準入力が使われる。
オプション
オプションには、-で始まる 1 文字のバージョンと、--で始まる長いバージョンがある。
--help,
--version は例外で、短いバージョンがない。
-
--version
-
プログラムのバージョン番号を標準出力に表示し、すぐに終了する。
-
--help
-
ヘルプを標準出力に表示し、すぐに終了する。
-
-d DIRECTORY
--directory=DIRECTORY
-
ファイルを取り出す前に、DIRECTORY に移動する。
-
-c
--overwrite
-
shar ファイルへのオプションとして渡される。 (3.40 以降の shar で作られたような) 多くのシェルアーカイブスクリプトは、既存のファイルを上書きするための引き数
-c を受け付ける。
-
-e
--exit-0
-
このオプションは、多くのシェルアーカイブを 1 つのメールフォルダに集める人を主な対象として存在する。このオプションを使うと、`unshar' は同じフォルダファイルに入れられた各シェルアーカイブを分離し、フォルダファイルの始めから終りへ順に、各シェルアーカイブからファイルを取り出していく。これらの作業が正しく行われるのは、多くの shar ファイルの最終行の先頭が `exit 0' で終っているからである。
オプション
-e は内部的には
-E "exit 0"と同じである。
-
-E STRING
--split-at=STRING
-
このオプションは
-e と同じように動作するが、アーカイブの間を隔てる文字列が `exit 0' では不適切な場合に、文字列を指定できる。
たとえば、多くの (署名ファイル) `.signature' では署名のすぐ前に `--' があるので、 `exit 0' という行が最後にないシェルアーカイブを分割するために、 `
--split-at=--' がよく使われる。そうすると、署名は次のメッセージのヘッダーとまとめて読み飛ばされる。
-
-f
--force
-
-c と同じ。
関連項目
shar(1)
返り値
シェルからのすべてのメッセージが表示される。
著者
shar と unshar プログラムは多くの著者の協同作品である。多くの人々が、問題の報告・いろいろな改良の示唆・実際のコードの提供に貢献してくれた。これらの人々は sharutils ディストリビューションの THANKS というファイルにリストされている。