manページ  — UUENCODE

uuencode, uudecode, b64encode, b64decode – バイナリファイルのエンコード、デコード

書式 解説 使用例 関連項目 バグ 歴史

uuencode [-m] [-o output_file] [file] name
uudecode [-cimprs] [file ...]
uudecode [-i] -o output_file
b64encode [-o output_file] [file] name
b64decode [-cimprs] [file ...]
b64decode [-i] -o output_file [file]

uuencode および uudecode のユーティリティは、 ASCII データ以外のデータ転送をサポートしてない伝送路を用いてバイナリファイル を送る場合に用いられます。 b64encode ユーティリティは、 -m フラグが指定された uuencode の同義語です。 b64decode ユーティリティは、 -m フラグが指定された uudecode の同義語です。

uuencode ユーティリティは、 file (無指定時には標準入力) よりデータを読み込み、符号化されたデータを標準 出力または output_file が指定された場合にはそこに書き込みます。 出力データには、 ASCII キャラクタしか含まれません。また、このデータには、 uudecode を用いて元のファイルを復元する時に必要となるファイルのモードと name が含まれます。

uudecode ユーティリティは、 uuencode によって生成されたファイル (もしくは、標準入力からのデータ) を元の形式 に変換します。生成されるファイルは、 uudecode 時に指定された名前 ( name ) または ( uudecode に指定されたオプションに依存して) output_file になり、ファイルモードなどは変換前のものが採用されますが、 setuid ビットと実行ビットは引き継がれません。 uudecode ユーティリティは、前後の行をすべて無視します。

以下のオプションを uuencode で使用可能です:

-m
	伝統的な uuencode アルゴリズムの代りに Base64 方式でエンコードします。
-o output_file
	標準出力にではなく output_file に出力します。

以下のオプションを uudecode で使用可能です:

-c
	file から、可能であるならば複数の uuencode されたファイルをデコードします。
-i
	ファイルの上書きをしません。
-m
	-r フラグと共に使用された場合、伝統的な uuencode 入力の代りに Base64 入力をデコードします。 -r が無い場合には、このフラグは無効です。
-o output_file
	入力データに含まれるパス名のファイルにではなく、 output_file に出力します。
-p
	file をデコードし、標準出力に出力します。
-r
	最初や最後のフレーミング行が無い、生の (または壊れた) 入力をデコードします。 入力は、伝統的な uuencode エンコードが仮定されます。 -m フラグ使用時や、 b64decode として起動された場合、入力は Base64 形式が仮定されます。
-s
	出力パス名をベース名に縮めません。 セキュリティのために、デフォルトでは uuencode は最後のスラッシュ '/' より前のプレフィックスを除去します。

ソースツリーを compress し、uuencode し、別のシステムにメールで送る例を 以下に示します。 uudecode が転送される側のシステムで実行されると、 ``src_tree.tar.Z'' が生成されます。 このファイルはその後 uncompress され、元のツリーが展開されるでしょう。

tar cf - src_tree amp;| compress amp;|
uuencode src_tree.tar.Z amp;| mail sys1!sys2!user

以下の例では、すべての uuencode されたファイルを、 あなたのメールボックスから現在の作業ディレクトリへ展開します。

uudecode -c < $MAIL

以下の例では、compress された tar アーカイブをあなたのメールボックスから 展開します。

uudecode -o /dev/stdout < $MAIL | zcat | tar xfv -

符号化されたファイルの大きさは、元のファイルの大きさに比較して 35% ほ ど大きくなります。これは、3byte のデータを 4byte + 制御符号に変換する ためです。

uuencode および uudecode は BSD 4.0 から登場しました。