Provided by: manpages-ja_0.5.0.0.20210215+dfsg-1_all bug

名前

       uudeview - バイナリファイル用の高性能なデコーダ

書式

       uudeview [-i] [-d] [-f] [-o] [-b1] [-t] [(+e|-e) extlist]
                [-v] [-s] [-m] [-n] [-p path] [@file] file(s)

説明

       uudeview は、電子メールや Usenet から受け取ったエンコードされた形式のファイルを デコードす
       る。標準付属の uudecode(1)  に似ているが、これよりも快適かつ柔軟である。  uudeview  はエン
       コーディング方法として uuencoding, xxencoding, Base64, BinHex をサポートしており、分割ファ
       イル(複数の部分に分けて送られたもの)を扱う  ことができ、さらに複数のファイルを同時に扱うこ
       ともできる。したがって、  デコードの手間を大きく省くことができる。ユーザは普通、デコードの
       準備を するためにファイルを手で編集する必要はない。

       uudeview   は起動されると、与えられたファイルを全てスキャンしてデコードすべきデー   タを探
       し、そのデータとデータに含まれるパートをソートし、うまくデコード  できそうなファイルの一覧
       をユーザに示す。ユーザはこの一覧からデコードす るファイルを個別に選ぶ。

オプション

       -i     対話機能を無効にする。ファイルのスキャンとその結果のソートを行った後、 uudeview  は
              ファイルをデコードするかどうかをユーザに問い合わせず、デコード可能な   ものを即座に
              バッチ処理でデコードする。

       -d     uudeview を desperate モードにする。このモードでは、不完全なファイルもデコード の候
              補となる。この機能が有効なのは 50 個のパートに分かれた投稿の最後の 部分が欠けている
              ような場合であるが、大抵の場合は、無理にデコードしたファ イルは単に壊れているだけで
              利用はできないだろう。不完全なファイルがどの 程度使えるかはファイルの種類による。

       -f     高速モードでファイルをスキャンする。 uudeview は各入力ファイルに多くとも 1 ファイル
              しか含まれていないものと想定する。 これは普通、ニューススプール内にあるファイルにつ
              いては成り立つ。このオ   プションを指定すると、複数の記事に分かれた入力ファイルのデ
              コードは  中断される   。また、データが正しいかどうかのチェックも一部が無効になるの
              で、誤りが あるファイルもおそらくデコードの候補として示される。デコードの時にエラー
              メッセージを受け取ることもあるし、単に不正なファイルができることもある。 このような
              問題に遭いたくないなら -f オプションは使わないこと。

       -o     デコード時に既存のファイルを上書きすることを許可する。デフォルトでは、   上書きする
              か、別の名前を付けるか、そのファイルを飛ばすかの問い合わせが   ユーザに対して行われ
              る。

       -v     詳細表示を  無効に する。通常、このプログラムは入力ファイルを読み込む際に何らかのス
              テータ スメッセージを表示する。これは問題が起きたときには非常に役に立つ。この  よう
              なメッセージが鬱陶しい場合にこのオプションを使うこと。

       -p パス
              デコードしたファイルを書き込むディレクトリを設定する。これは有効なパス 名でなければ
              ならず、そうでない場合はファイルをデコードしようとした時に エラーとなる。デフォルト
              値は現在の作業ディレクトリである。

       +e 拡張子
              指定された拡張子を持つファイルだけを選択してデコードする。他のファイル   は無視され
              る。 +e  .gif.jpg  を指定すると、GIF  ファイルと  JPG  ファイルは全てデコードされる
              が、TIF 等はデコードされない。拡張子のリストでは大文字と小文字は区別されない。

       -e 拡張子
              上記のオプションの反対の意味を持つ。

       コマンドラインで +e と -e を混ぜて使っても、希望した結果は得られない だろう。

       -b1    このオプションは、サブジェクトからパート番号を取り出すという  uudeview のポリシーを
              変更する。このオプションが必要となるのは稀であるが、 例えば複数に分割して投稿が行わ
              れた時のように、パート番号が  括弧 () や ブラケット [] 内に書かれている場合だけは必
              要となる。デフォルトでは、 uudeview はまず 括弧 () 内にある数字を使う。しかし、この
              番号が全体のファイル数 を示しており、パート番号はブラケット [] に書かれている場合に
              は、このパ  ラメータを使って  uudeview   に他の数字を最初に読み込ませるようにするこ
              と。このオプションは、1 種類 のブラケットしか含まないファイルや、どちらの種類のブラ
              ケットも含まない     ファイルの展開には影響を与えない。必要ならば、このオプションは
              -b[] のように使うこともできる。

       -s     「賢くなくする(minus  smartness)」と読むこと。このオプションは、サブジェ クト行から
              パート番号を自動検出する機能を無効にする。 uudeview  がサブジェクト行の正しい展開に
              失敗してパート番号の推定時にエラーを出力 し、パートの順番が狂う場合にはこのオプショ
              ンを試すとよい。このオプショ  ンを使うと、パートは必ず順番通りに繋げられる(したがっ
              て、入力ファイル  ではパートを正しい順に並べなければならない)。また、このオプション
              を使 うと、プログラムは欠けているパートを検出することはできない。 注意:  この場合で
              も、きちんとした  MIME ファイルに含まれている正しいパート番号は評価される。このオプ
              ションを 2 回指定すると、サブジェクトそのものも無視され、パートのグループ付けに  は
              使われない。パートを配送する一連のメッセージのサブジェクト行がそれぞ れ異なる場合に
              は、このオプションを使用すること。

       -m     ファイルのモードを無視する。uuencode や xxencode されたファイルの begin  行には、元
              のファイルのパーミッションが書かれている。このオプショ ンが与えられなければ、デコー
              ダは元のパーミッションを復元しようとする。   このオプションを与えると、得られるパー
              ミッションは 0666 からユーザの umask を引いた値となる。

       -n     プログレスバーを表示しない。uudeview は通常、進行状況に合わせて 100% まで伸びてゆく
              横棒を  ASCII  文字で表示するが、端末がこれを表示できるか  どうかのチェックは行わな
              い。端末が表示できない場合や、プログレスバーを 目障りと感じた場合にはこのオプション
              を使うこと。

       -t     プレーンテキストのメッセージを使う。通常、uudeview はデコードの際には  エンコードさ
              れたデータだけを表示する。このオプションを設定すると、  MIME メッセージに入っている
              テキストパートやエンコードされていないデータもデ コード対象として示される。プレーン
              テキストのメッセージにはファイル名が  付けられていないことが多いので、これらには  4
              桁の通し番号を使ったユニー クな名前が付けられる。

       ファイル(複数可)
              エンコードされたファイルを探すためにスキャンするファイル。ハイフン  (´-´)を指定すれ
              ば、標準入力から読み込むこともできる。指定するファイ ルの数はいくつでも良いが、通常
              はシェルがオプションの数を 128 個までに  制限している。ワイルドカードを使ってファイ
              ルのリストを作った場合には、     間違ってバイナリファイルをプログラムに入力しないこ
              と。こうなった場合の 動作は未定義である。

       @ファイル
              追加のオプションをファイルから uudeview に読み込ませる。このファイルでは 1  行に  1
              つだけオプションを書かなけ  ればならない。このファイルはプログラムの終了時に 削除さ
              れる 。この機能を使うとファイルを何個でも指定することができる。 find(1)  の機能と組
              み合わせれば、ディレクトリツリー全体(ニューススプールのディ レクトリ等)を処理するこ
              とができる。

       環境変数 $UUDEVIEW にオプションを指定することもできる。この値はコマン ドラインのオプション
       を処理する前に読み込まれる。

デコード

       入力ファイルを全てスキャンした後、それぞれのファイルの扱いについてユー  ザに問い合わせが行
       われる。当然ながら普通はデコードの実行と答えるのだが、  選択肢は他にもある。以下のコマンド
       を使用することができる(各コマンドは 1 文字である):

       d      ファイルをデコードし、デコードしたファイルを指定された名前でディスクに 書き込む。

       y      (d) と同じ動作である。

       x      このコマンドもファイルをデコードする。

       n      このファイルをデコードしないで飛ばす。

       b      前のファイルに戻る。

       i      ファイルに関する情報があれば、それを表示する。マルチパートの投稿に 0 番目のパートが
              あればそれを表示する。0 番目のパートがなければ、エンコー ドされているデータまでにあ
              る最初のパートが表示される。

       e      コマンドを実行する。どんなコマンドでも入力することができるが、この際に は多分、現在
              のファイルが引き数として使われるだろう。コマンドライン中の ドル記号 '$'  は全て、現
              在のファイルのファイル名に置き換えられる(正確に は一時ファイルの名前)。この一時ファ
              イルを使ってバックグラウンドプロセ スを実行してはならない。なぜなら、入力ファイルが
              突然消えた場合にプログ ラムの処理が混乱するからである。

       l      ファイルをリスト表示する。このコマンドを使うのは、問い合わせ対象のファ イルがテキス
              トファイルの場合だけにすること。そうでない場合にはゴミが大 量にできるだけである。

       r      名前を変える。別の名前を選んで、そのファイルを新しい名前で保存すること ができる。

       p      デコードしたファイルを書き込むパスを設定する。このパスは、コマンドライ ンオプション
              の -p コマンドで設定することもできる。

       q      即座にプログラムを終了する。

       ?      以上のコマンド全ての簡単な説明を表示する。

       コマンドを入力しないで、プロンプトでリターンキーだけを叩いた場合には、  デフォルトのコマン
       ドであるファイルのデコードが実行される。

実行時のメッセージ

       詳細表示モード(つまり、-v  オプションで詳細表示を無効にしていない場合)  では、進行状況メッ
       セージが出力される。このメッセージはプログラムの実行  を追跡するのに非常に便利であり、これ
       を理解できればファイルのデコードに  失敗した原因の追求に使うことができる。このセクションで
       はメッセージの解 釈の仕方を説明する。プログラムを操作するだけならば、このセクションを理 解
       することはあまり重要でない。

       最初は「ロード中」のメッセージである。これは文字列 "Loaded" で始まる。  それぞれの行は以下
       の要素を示さなくてはならない:

       入力ファイル
              最初の要素はソースファイルであり、ここからパートがロードされる。 1 つのファイルから
              多くのパートが検出されることもある。

       サブジェクト行
              完全なサブジェクトがシングルクォートで括られた形で再現される。

       識別子 このプログラムは、同じファイルに属していると思われる記事をまとめるため、 サブジェク
              ト行を利用してこのスレッドをユニークに識別する。このアルゴリ ズムの結果はブレースで
              括って表示される。

       ファイル名
              サブジェクト行やデータ内でファイル名が検出されたかどうか(例えば、begin         行や
              Content-Type 情報の一部として検出される)。

       パート番号
              パート番号を表す。サブジェクト行から取り出されたり、きちんとした   MIME  形式のメッ
              セージの場合には「パート」情報から取り出されたりする。

       Begin/End
              "begin" トークンや "end" トークンが検出された場合、それがここで出力さ れる。

       エンコーディング型
              このパート内でエンコードされたデータが検出された場合、"UUdata", "Base64", "XXdata",
              "Binhex" のいずれかが出力される。

       スキャンが終わった後にはこれ以外のメッセージが出力される。記事のグルー  プそれぞれに対して
       1 つの行が出力される。この行の内容は例で見る方が分 かりやすいだろう。以下に例を示す:

       Found 'mailfile.gz' State 16 UUData Parts begin 1 2 3 4 5 end 6 OK

       この行はファイル   mailfile.gz   が見つかったことを示す。ファイルは   uuencode    されてお
       り("UUData")、6   つ   のパートからなる。また、"begin"  トークンが最初のパートで見つかり、
       "end" トークンが 6 番目のパートで見つかった。全て揃っているように見え るので、このファイル
       には "OK" のタグが付けられる。 State には以下に示す各種ビットが設定される。ビットの値は OR
       されることもあるだろう。

       1      欠けているパートがある

       2      Begin が無い

       4      End が無い

       8      エンコードされているデータが見つからない

       16     ファイルは問題なしと思われる

       32     ファイルのデコード時にエラーが起きた

       64     ファイルがうまくデコードできた

注意

       このプログラムは、標準入力から読み込みを行うときには端末の入力を受け取  ることができないの
       で、この場合には対話機能は自動的に無効にされる。

       MIME  形式のメッセージヘッダが検出されたときは、このプログラムはほぼ  MIME  準拠の動作を行
       う。 「 ほぼ 」というのは、規約ではファイルが複数のメッセージを含むことは認められて いない
       けれど、  uudeview  はこの制限なしで動作するからである。実際には、コマンドラインオプション
       -f を用いて必ずこの状態になるようにすれば、このプログラムは  RFC1521  に完  全に準拠する。
       (このオプションが設定されていても、正しい MIME マルチパートメッセージ に含まれるパートは全
       て処理される。)

       スキャンの処理部分は、MIME メッセージの外部にある短い Base64 データ(4  行以下)を無視するこ
       とがよくある。この状態に対するチェックがいくつか  desperate モードで行われるが、これを行う
       とエンコードされたデータを誤っ て検出し、不正なファイルができることがある。

       ファイルは最初は必ず一時ファイルにデコードされ、その後に最終的な場所に  コピーされる。これ
       は、後になってからデコードできないことが分かるような  データで既存のファイルを誤って上書き
       することを防ぐためである。したがっ て、必要なサイズの  2  倍の空きスペースを予め確保するこ
       と。また、標準入 力から読み込みを行う時には、全てのデータは一時ファイルに書き込まれ、そ の
       後にこのファイルに対して通常のスキャン処理が始められる。

       Subject 行があれば、 uudeview は必要な情報全てをこの行から取り出そうとする。Subject 行にゴ
       ミが入っ  ている場合や、プログラムがユニークな識別情報とパート番号を Subject 行 から見つけ
       られなかった場合でも、 uudeview は別のヒューリスティクスを用いてファイルをデコードすること
       ができるが、 この場合の結果は運任せである。
       ただし、これが関係あるのはファイルが分割されている場合だけである。エン  コードされたファイ
       ルが全て 1 つのパートだけからなる場合には何も心配す る必要はない。

       このプログラムの名前を変えたり、コピーしたり、リンクをすることによって  uudecode  にした場
       合、このプログラムは標準の uudecode の高性能な代用プログラムとして動作し、同じコマンドライ
       ンオプションを受 け付ける。ただし、テストはまだ十分でない。

関連項目

       uuenview(1), uudecode(1), uuencode(1),
       ウェブ上にある uudeview のホームページ:
       http://www.uni-frankfurt.de/~fp/uudeview/

バグ

       名前がハイフン('-')で始まるファイルを読み込むには、パス名(例えば './') を前に付けること。

       バグとして報告する前には、そのファイルが他の手段でデコードできることを  確かめること。作者
       は、全くのゴミのデコードに失敗したと後でわかるような バグ報告は受け取りたくない。

       バグを見つけたと思ったら、入力ファイル(できれば単に入れるだけでなく、 元のファイルに圧縮と
       エンコードを施すこと)とプログラムのメッセージのリ                   スト(詳細表示モード)を
       fp@informatik.uni-frankfurt.de 宛に送ること。

       現在は BinHex データに入っているチェックサムは無視される。

       このプログラムは、分割されたマルチパートメッセージ(複数のメールに分割 された MIME 形式のマ
       ルチパートメッセージ)を完全に処理することができな い。各パートが識別されて 1  つにまとめら
       れ、これに含まれているマルチパー  トメッセージがプレーンテキストファイルに「デコード」され
       るが、このファ イルを再び uudeview  に入力しなければならない。しかし、このようなメッセージ
       は滅多にないので 心配する必要はない。

                                          December 1996                               UUDEVIEW(1)