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

名前

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

書式

       xdeview [Xt options] [-- [-f] [-b] [-o] [-d] [-v] [-s]
               [-t]] [file(s) or directories]

説明

       xdeview  は強力なエンコード/デコードエンジンへのグラフィカルインタフェースであ る。 このプ
       ログラムは電子メールや  usenet  経由で受け取ったエンコードされた  ファイルを処理するものだ
       が、標準の    uudecode(1)   コマンドよりも高機能である。また、逆の動作を行うことも可能であ
       り、ユー ザが持つバイナリファイルをエンコードして自動的にメールで送信することや ニュースへ
       投稿することができる。  xdeview  がサポートしているデコード方法は  uuencoding, xxencoding,
       Base64, BinHex であり、分割ファイルを処理することや複数ファイルを同時に処理することが でき
       る。これにより、デコード作業が非常に簡単になる。ユーザは普通、デコー  ドの準備をするために
       ファイルを手で編集する必要はない。  このような作業にはグラフィカルなフロントエンドを特に必
       要としないなら、 uudeview(1) と uuenview(1) を参照すること。

       このプログラムは起動されると、与えられた全てのファイルをスキャンしてエ  ンコードされたデー
       タを探す。与えたファイルのいずれかがディレクトリなら  ば、再帰的なディレクトリ移動が行われ
       る。 ファイルをコマンドラインで指定する必要はない。後でプログラム中でファイ ルを選択するこ
       ともできる。最初のスキャンが終わった後、うまくデコードで  きそうなファイルリストがユーザに
       示される。ユーザはこの一覧からデコード するファイルを個別に選ぶ。

オプション

       オプションをコマンドラインで設定する必要は特にない。オプションはプログ  ラム中でも設定でき
       るからである。オプションの前には  '--'  を置かなければ  ならず、そうでない場合には表示オプ
       ションと間違われるかもしれないので注 意すること。

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

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

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

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

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

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

       -s     「賢さを取り除く(minus smartness)」と読むこと。このオプションは、サブ  ジェクト行か
              らのパート番号の自動検出を無効にする。 xdeview がサブジェクト行の正しい展開に失敗し
              てパート番号の推定時にエラーを出力 し、パートの順番が狂う場合にはこのオプションを試
              すとよい。このオプショ  ンを使うと、パートは必ず順番通りに繋げられる(したがって、入
              力ファイル ではパートを正しい順番に並べなければならない)。 注意: この場合でも、きち
              んとした MIME ファイルに含まれている正しいパート番号は評価される。

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

メインメニュー

       xdeview  のメインウィンドウは 6 つの主な要素からなる。この一番上にあるのは メニューバー で
       ある。  真ん中にあるのは   ファイルリスト   である。これはエンコードされたデータ内で検出さ
       れ、デコードしようとして  いるファイル全てのリストである。ファイルリストの左にあるのが  
       テータスリスト である。これは各ファイルの状態を示す。このリストは普通、全てのファイル につ
       いて "OK" となる。というのも、普通はエラーとなったファイルは表示さ れないからである。 右側
       にあるのは、良く使われる機能を呼び出すショートカットボタンを集めた  ものである。ウィンドウ
       の一番下にあるのは  Save Path エントリのフィールドとステータスバーである。これらの要素につ
       いては後で 個別に説明する。

メニューバー

       File メニュー

              Load ...
                     エンコードされたファイルをロードする。これらのファイルはスキャンされ、  エン
                     コードされたデータとファイルが検索される。これらのファイルはファイ  ルリスト
                     に追加される。ディレクトリを検索することもでき、この場合にはそ  のディレクト
                     リへの再帰的な移動が行われる。

              Encode ファイル(複数可)をエンコードする。エンコードしたファイルはディスクに格  納す
                     ることや電子メールで送ること、ニュースグループに投稿することができ  る。これ
                     らについては後述する。

              Helpers
                     xdeview は、Execute" ボタンが押されたときに適切なデフォルト動作を行う ために
                     .mailcap と  .mime.types  から情報を読み込む。このダイアログでは、  これらの
                     ファイルの位置を設定することができる。

              Save Setup
                     現在のオプションやファイルの入出力の対象パスをホームディレクトリの
                     .xdeviewrc  ファイルに保存する。このファイルは起動時に自動的に読み込まれるの
                     で、保    存された設定は次回以降のセクションでデフォルトで設定される。このリ
                     ソー スファイルは実際には  Tcl  のスクリプトであり、好きなエディタで編集する
                     ことができる。

              Quit   プログラムを終了する。

       Options
              プログラムの動作を変えるための各種オプションを設定する。ほとんどのオプ ションは設定
              後に読み込んだファイルにしか適用されない点に注意すること。

              Fast Scanning
                     高速スキャンモードを設定する。このプログラムは、各入力ファイルに多くと も  1
                     ファイルしか含まれていないものと想定する(普通、ニューススプール内 にあるファ
                     イルでは正しい)。各ファイルについて内容を全部読む必要がない のでスキャニング
                     エンジンの動作は高速になるが、エンコードされたデータが    見つかった後にはス
                     キャンが終了する。

              高速モードでは、デコーダは安全のためのオプションをいくつか無効にしなけ   ればならな
              い。したがって、ファイルに何らかの問題がある場合でも、これを 検出できるのは最終的に
              デコードを行う時だけとなる。

              Automatic Overwrite
                     出力先ディレクトリに既に存在する名前のファイルをデコードするとき、ファ  イル
                     を上書きするかどうかユーザに問い合わせが行われる。このオプションを  有効にす
                     ると、出力ファイルは問い合わせなしで上書きされる。

              Desperate Mode
                     ユーザに示されるファイルは通常、全てのパートを検出できたものだけである。
                     desparate  モードを有効にすると、ユーザは他のファイルも見ることができる。 こ
                     の際には問題点の適切な説明がステータスリストに表示される。desparate モードで
                     は、デコーダは  MIME メッセージ外部にある短い Base64 形式ファイ ルも検出しよ
                     うとする。この機能は通常は無効である。というのも、無理に Base64 エンコーディ
                     ングを見つけようとすると、エンコードされたデータを  誤って検出し、不正なファ
                     イルができてしまうかもしれないからである。

              Verbose Mode
                     入力ファイルのスキャン時に追加メッセージが表示されるテキストボックスを    別
                     ウィンドウで開く。このようなメッセージは、ファイルがうまくデコードで  きない
                     場合に問題点を見つける際に非常に役立つ。

              Alternate Bracket Policy
                     デコーダがサブジェクト行からパート番号を取り出そうとする際に使うヒュー  リス
                     ティクスを変える。このアルゴリズムでは通常、ブレース  () 内の数字を ブラケッ
                     ト [] 内の数字より優先させる。両方の種類の括弧があり、衝突する  ような使い方
                     をされている場合(例えば、パート番号とシリーズ番号が両方と      もある場合)に
                     は、括弧の使い方を明示的に決めなければならないかもしれな  い。このオプション
                     が   false  (デフォルト値)ならば「パート番号」はブレー  ス  ()  から取り出さ
                     れ、true ならばブラケット [] から取り出される。

              Dumb Mode
                     サブジェクト行の展開によるパート番号の自動検出を無効にする。 xdeview  が正し
                     いパート番号の取得に失敗した場合に用いること。このオプションを設      定する
                     と、パートを正しい順番で並べて入力ファイルにしなければならない。  また、この
                     方法では欠けているパートは検出されない。

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

              Auto Info
                     ファイルリスト中のファイルをクリックすると情報ウィンドウを開くようにす る。

       Actions

              Decode 選択されたファイル(複数可)をデコードする。

              Rename 選択されたファイル(複数可)の名前を変える。これは例えば、ファイル名が既  存の
                     ファイルと重なる場合や、名前がシステムの制限に合わない場合に使う。

              Decode All
                     現在ファイルリストに表示されているファイルを全てデコードする。

              Info   現在選択されているファイルの利用可能な情報を表示する(複数のファイルが 選択さ
                     れている場合には、最初のファイルの情報だけが表示される)。表示さ     れる情報
                     は、ファイルの 0 番目のパート(利用可能ならば)またはエンコード されたデータの
                     開始部分までにある最初のパートのヘッダである。

              Execute
                     外部プログラムを実行nし、現在選択されているファイルを与える。外部プロ グラム
                     は、まずメッセージの Content-Type を(可能ならば)参照し、次にファイルの拡張子
                     をチェックして決める。ユーザの  .mailcap または .mime.types ファイルから適切
                     な情報が読み込まれる(ただし、.mailcap ファイル内の情報  の扱いは現在のところ
                     不十分である)。マッチする MIME 型が見つからない場 合には、ユーザが任意のコマ
                     ンドを入力できるダイアログボックスが表示され る。

              List Text File
                     これは、テキストファイルがネット上をエンコードされた形で送られるという  滅多
                     にない場合のためのものである。これを使うのは、ユーザが対象のファイ  ルが確か
                     にテキストファイルであることが分かっている場合だけである。それ  以外の場合に
                     は、画面上にゴミが読み込まれることになる。

       Help

              About  作者からの簡単なメッセージである。

              License
                     xdeview  を配布する際のライセンスである  GPL  を表示する。ちゃんと読まな  い
                     と、作者の弁護士を相手にすることになるだろう。

ファイルリスト

       ファイルリストは、エンコードされたデータのスキャンの際に見つかったファ  イルが全て表示され
       るリストボックスである。これらのファイルはいつでもデ  コード、プレビュー等の好きな処理をす
       ることができる。このリストはリスト  の右のスクロールバーを使ってスクロールさせることができ
       る。

       ファイルを 1 つずつ選ぶなら単にクリックすればよい。複数のファイルを選 ぶには、 CTRL キーを
       押しながらファイルをクリックする。

ステータスリスト

       ステータスリストは ファイルリスト 中の対応するファイルの状態を示す。通常はここには "OK" が
       表示される。そ れ以外の場合には、ファイルがうまくデコードできなかった理由を説明するエ ラー
       メッセージが表示される。状態としては以下のものがある:

       OK     ファイル中の全てのパートが見つかり、簡単に調べた限りではエンコードされ たデータは正
              しいと思われる。ファイルのデコード時にだけ起こる何らかの問     題があるかもしれない
              が、普通は全く問題ない。

       Incomplete
              このファイルには欠けているパートが 1 つ以上ある。このファイルをデコー  ドしても出力
              データは壊れており、普通は使用できない。

       No Begin
              ファイルの開始部分がない。デコードされたファイルはほぼ確実に壊れており、 利用できな
              い。

       No End ファイルの終了部分が見つからない。これは普通、ファイルの末尾のパートが 欠けているこ
              とを示す。デコードされたファイルがどの程度使えるかは、ファ イルの種類による。

       Error  以前にファイルをデコードしようとして失敗した。

ショートカットボタン

       ウィンドウの右側にあるボタンはメニュー要素へのショートカットである。内  容については、前述
       のメインメニューの要素の説明を読むこと。

保存パス

       これはデコードされたファイルが書き出されるパスである。

ステータス

       プログラムの現在の処理内容やユーザに求めている入力に関する簡単なメッセー ジ。

エンコーディングメニュー

       ファイルをエンコードする時("File" メニューの "Encode")には、大きなダイ  アログボックスが開
       き、そのファイルに対してオプションを色々設定すること  ができる。複数のファイルをエンコード
       対象として選んだ場合には、一番上の  ステータス行に残りのファイル数が表示される。ダイアログ
       そのものは全ての ファイルが処理されるまで消えない。

       Filename
              現在のエンコード対象ファイル。このフィールドを編集することはできない。

       Send As
              ファイルを送る時に使う名前。デフォルトではファイル名からディレクトリ情 報を全て取り
              除いたものになる。

       Use Subject
              メール送信やニュース投稿のとき、このテキストをサブジェクトとして使う。 ファイル名と
              パート番号は自動的に追加されるので、この行は空にしても良い。

       Lines per File
              エンコードしたデータのパートごとの行数を設定する。大きいファイルは自動   的に複数の
              パートに分割される。ニュースグループにファイルを投稿する場合 や、メール受信者のメー
              ラが大きなファイルを処理できない場合に使用するこ と。分割のサイズとしては 1000 行が
              良いだろう。"0" 行はファイル分割を行 わないという指定である。

       ... Encoding
              使用するエンコーディング方法を選択する。どれが最も良いか分からなければ、 筆者が書い
              た "デコーディング入門(Introduction to Decoding)" という記事 を見れば手がかりが得ら
              れるかもしれない。

       File In (Path)
              エンコードしたファイルを置く場所を設定する。エンコードしたものは元のファ イルとベー
              ス名は同じであるが、拡張子 .001, .002 が付けられる(拡張子は "Lines per File" の設定
              から決まる必要なパート数によって決まる)。

       Email To
              コンマで区切った電子メールアドレスのリストを与える。お使いのシステムで 電子メール送
              信が許可されていない場合には、このオプションは無効になって いるかもしれない。

       Post To
              ファイルを投稿するニュースグループをコンマで区切ったリストを入力するこ     とができ
              る。お使いのシステムでニュース投稿がサポートされていない場合に は、このオプションは
              無効になっているかもしれない。

       NNTP Server
              このフィールドは一部のシステムでしか現われない。つまり、ニュースのホス トが必要であ
              るが、コンパイル時に何も設定されていない場合である。この         フィールドがある場
              合、ニュース投稿を行うためには正しいホスト名を入力し なければならない。ニュースを投
              稿するつもりが特になければ、この設定は気 にしなくてもよい。

       OK     選択されたアクションをこのファイルに対して実行し、次のファイルに移動す る。

       OK to All
              対象となっているそれぞれのファイルに対して現在の設定を使用する(別のファ  イルについ
              ての問い合わせを行わない)。したがって、全てのファイルが一度 に処理される。

       Next   ファイルをエンコードせず、次のファイルに移動する(申し訳ないが、前に戻  るためのボタ
              ンはない)。

       Cancel エンコードをキャンセルし、メインメニューに戻る。

設定ファイル

       ホームディレクトリに .xdeviewrc ファイルがあれば、これはプログラムの初期化時に Tcl  インタ
       プリタに読み  込まれる。このファイルは正しい  Tcl  プログラムでなければならないが、こ れを
       使ってオプションをデフォルトで設定することができる。Tcl を知らない  人のために変数設定の文
       法を以下に示す:
       set 変数名 
       以下の変数(オプション)を設定することができる(オプションの動作について は、前の説明を参照す
       ること):

       OptionFast
              1 を設定すると高速スキャンモードが使われる。

       OptionBracket
              1 を設定すると、ブラケットの処理方法が変わる。

       OptionOverwrite
              1 を設定すると、問い合わせなしでもファイルの上書きが許可されたことにな る。

       OptionDesperate
              1 を設定すると、desperate モードに切り替わる。

       OptionVerbose
              1 を設定すると、進行状況メッセージが出力される。

       SaveFilePath
              これはデフォルトの保存パス(ファイルがデコードさせる先)を示す文字列変数 である。

       EncodeMaxLines
              エンコードの際のファイルごとの最大の行数。"0" を指定すると無制限になる。

       EncodeEncoding
              デフォルトで使うエンコード方法。"0" が uuencode エンコーディング、"1"  が  xxencode
              エンコーディング、"2" が Base64 エンコーディングである。

       NNTPServer
              使用する  NNTP サーバのアドレス(一部のシステムだけで必要)。環境変数 NNTPSERVER で設
              定することもできる(こちらの方が好ましい)。

実行時のメッセージ

       詳細表示モードを有効にしてあれば、進行状況メッセージが Runtime Messages という名前の独立し
       たウィンドウが現われる。スキャニングの段階で生成され  たメッセージを理解できれば、これはプ
       ログラムの進行を追跡する時には非常  に役立つし、ファイルのデコードに失敗した理由を調べるた
       めに使うことがで きる。プログラムを動かすだけならこのセクションを理解する必要はない。

       最初に「読み込み中」のメッセージが表示される。これは文字列  "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     ファイルがうまくデコードできた

注意

       xdeview が実行できず "command not found" といった表示がされるが、ファイルその ものは確かに
       ある場合には、 xdeview の最初の部分を見て、メインファイル uuwish  への参照が正しいかどうか
       を確認すること。

関連項目

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

バグ

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

                                            June 1996                                  XDEVIEW(1)