Blame doc/ja/cd-paranoia.1.in

Packit cb6d3d
.TH @CDPARANOIA_NAME@ 1
Packit cb6d3d
.\" Translated Sun Aug 22 18:02:41 JST 1999
Packit cb6d3d
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
Packit cb6d3d
.SH 名前
Packit cb6d3d
@CDPARANOIA_NAME@ (Paranoia release III libcdio) \- オーディオ CD 読み取りユーティリティ。特別なデータ照合機能を持つ。
Packit cb6d3d
.SH 日付
Packit cb6d3d
バージョンIII リリースα9.6 (17 Aug 1999)
Packit cb6d3d
.SH 書式
Packit cb6d3d
.B @CDPARANOIA_NAME@
Packit cb6d3d
.RB [ options ]
Packit cb6d3d
.B span 
Packit cb6d3d
.RB [ outfile ]
Packit cb6d3d
.SH 説明
Packit cb6d3d
.B @CDPARANOIA_NAME@
Packit cb6d3d
は CD-DA 機能を持つ CD-ROM ドライブからオーディオトラックを取り出しま
Packit cb6d3d
す。このデータは WAV, AIFF, AIFF-C, raw 形式でファイルにセーブすること
Packit cb6d3d
や、標準出力に送ることができます。ほとんどの ATAPI, SCSI, メーカー独自
Packit cb6d3d
の CD-ROM ドライブがサポートされています。
Packit cb6d3d
.B @CDPARANOIA_NAME@
Packit cb6d3d
は対象のドライブが CD-DA 機能を持っているかどうかを判別できます。
Packit cb6d3d
.P
Packit cb6d3d
単純な読み取りだけでなく、
Packit cb6d3d
.B @CDPARANOIA_NAME@
Packit cb6d3d
は特別に頑健なデータ照合機能、同期機能、エラー処理機能、破損データの再
Packit cb6d3d
構成機能を持っています。
Packit cb6d3d
.SH オプション
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-v --verbose
Packit cb6d3d
自動検出と読み取りの処理について、ばかばかしいほど冗長な表示を行います。
Packit cb6d3d
設定やデバッグの際に便利です。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-q --quiet
Packit cb6d3d
読み取り処理の途中に、進行状況やエラー情報を全く表示しません。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-e --stderr-progress
Packit cb6d3d
進行状況を(ラッパスクリプトのために)標準エラー出力に出力します。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-V --version
Packit cb6d3d
プログラムのバージョンを表示して終了します。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-Q --query
Packit cb6d3d
CD-ROM ドライブの自動検出を行い、CD-ROM の TOC の問い合わせと表示を行
Packit cb6d3d
い、終了します。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-s --search-for-drive
Packit cb6d3d
たとえ /dev/cdrom のリンクが存在していても、CD-ROM ドライブの完全な
Packit cb6d3d
検索を行います。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-h --help
Packit cb6d3d
.B @CDPARANOIA_NAME@ 
Packit cb6d3d
の使い方とオプションを簡単な説明を出力します。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-p --output-raw
Packit cb6d3d
ヘッダ無しのデータをホストのバイト順で、インタリーブ処理を施した
Packit cb6d3d
サンプル音声を含む raw 形式の 16 ビット PCM データとして出力します。
Packit cb6d3d
バイト順としてリトルエンディアンあるいはビッグエンディアンを指定するに
Packit cb6d3d
は、後述の
Packit cb6d3d
.B \-r 
Packit cb6d3d
または
Packit cb6d3d
.B \-R
Packit cb6d3d
オプションを使ってください。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-r --output-raw-little-endian
Packit cb6d3d
ヘッダ無しのデータを LSB first のバイト順で、インタリーブ処理を施した
Packit cb6d3d
サンプル音声を含む raw 形式の 16 ビット PCM データとして出力します。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-R --output-raw-big-endian
Packit cb6d3d
ヘッダ無しのデータを MSB first のバイト順で、インタリーブ処理を施した
Packit cb6d3d
サンプル音声を含む raw 形式の 16 ビット PCM データとして出力します。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-w --output-wav
Packit cb6d3d
データを Micro$oft の RIFF WAV 形式で出力します(WAV データのバイト順は
Packit cb6d3d
必ず LSB first である点に注意)。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-f --output-aiff
Packit cb6d3d
データを Apple の AIFF 形式で出力します(AIFC データのバイト順は必ず 
Packit cb6d3d
MSB first である点に注意)。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-a --output-aifc
Packit cb6d3d
データを無圧縮 の Apple AIFF-C 形式で出力します(AIFF-C データのバイト
Packit cb6d3d
順は必ず MSB first である点に注意)。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.BI "\-B --batch "
Packit cb6d3d
cdda2wav 形式のバッチ出力を行います。@CDPARANOIA_NAME@ は出力をトラック境界で
Packit cb6d3d
複数ファイルに分割します。出力ファイルのファイル名の先頭部分は、'track(番号)' 
Packit cb6d3d
となります。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-c --force-cdrom-little-endian
Packit cb6d3d
一部の CD-ROM は間違ったエンディアンを報告します(あるいはエンディアン
Packit cb6d3d
に関する情報を全く報告しません)。そのため、@CDPARANOIA_NAME@ がエンディアンを
Packit cb6d3d
間違えることがあります。ドライブをリトルエンディアンのデバイスとして
Packit cb6d3d
@CDPARANOIA_NAME@ に扱わせるには、
Packit cb6d3d
.B \-c
Packit cb6d3d
オプションを使います。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-C --force-cdrom-big-endian
Packit cb6d3d
前のオプションの逆で、デバイスをビッグエンディアンのデバイスとして
Packit cb6d3d
@CDPARANOIA_NAME@ に扱わせます。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.BI "\-n --force-default-sectors " n
Packit cb6d3d
インタフェースのバックエンドが行う最小単位の読み取りを、
Packit cb6d3d
1 回の読み取りごとに
Packit cb6d3d
.B n
Packit cb6d3d
セクタとします。この数は問題を起こすおそれがあります。カーネルは多くの
Packit cb6d3d
場合、読み取り要求を最小単位の読み取り(@CDPARANOIA_NAME@ による自動処理はこれ
Packit cb6d3d
に対応しています)複数個に分割するか、制限された大きさの範囲でしか
Packit cb6d3d
読み取りを許可しません。
Packit cb6d3d
.B 普通はこのオプションを使うべきではありません。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.BI "\-d --force-cdrom-device " device
Packit cb6d3d
インタフェースのバックエンドによる読み取りを、最初に見つけた読み取り可
Packit cb6d3d
能な CD-ROM ドライブではなく、指定した
Packit cb6d3d
.B device
Packit cb6d3d
から行うようにします。このオプションでは、利用可能である任意の
Packit cb6d3d
インタフェース(ATAPI, SCSI, メーカー独自)を持つデバイスを指定すること
Packit cb6d3d
ができます。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.BI "\-g --force-generic-device " device
Packit cb6d3d
このオプションは、SCSI CD-ROM と汎用デバイスの設定を明示的に別々に制御
Packit cb6d3d
したい時に
Packit cb6d3d
.B \-d
Packit cb6d3d
オプションと組み合わせて使います。このオプションが役立つのは、SCSI の
Packit cb6d3d
設定が標準と異なる場合だけです。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.BI "\-S --force-read-speed " number
Packit cb6d3d
CD ドライブからの読み込み速度を設定するには、このオプションを明示的に
Packit cb6d3d
使ってください(ドライブが対応している場合)。このオプションを用いると、
Packit cb6d3d
ディスクが遅い場合やメモリが少ない場合に起こるアンダーランを減らすこと
Packit cb6d3d
ができます。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-Z --disable-paranoia
Packit cb6d3d
データ照合と訂正機能を
Packit cb6d3d
.b 全て
Packit cb6d3d
無効にします。-Z オプションを用いると、@CDPARANOIA_NAME@ は
Packit cb6d3d
オーバーラップの設定が 0 である cdda2wav と全く同じようにデータの
Packit cb6d3d
読み取りを行います。
Packit cb6d3d
このオプションを指定すると
Packit cb6d3d
.B \-W ,
Packit cb6d3d
.B \-X ,
Packit cb6d3d
.B \-Y
Packit cb6d3d
オプションも有効になりますが、
Packit cb6d3d
.B \-Z \-W \-X \-Y
Packit cb6d3d
と全く同じでは
Packit cb6d3d
.B ありません。
Packit cb6d3d
なぜなら、
Packit cb6d3d
.B \-W
Packit cb6d3d
から
Packit cb6d3d
.B \-Z
Packit cb6d3d
までのオプションにより照合のレベルが階層的に変わるからです。実際に有効
Packit cb6d3d
になるのは最後に指定したオプションだけです。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-Y --disable-extra-paranoia
Packit cb6d3d
読み取ったデータの中間におけるデータ照合を行いません。つまり、
Packit cb6d3d
データの読み取り境界におけるオーバーラップ部分のチェックしか行いません。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-X --disable-scratch-detection
Packit cb6d3d
照合の途中では傷の探査も行わず、傷に対して頑健な同期処理も行いません。
Packit cb6d3d
.B \-X
Packit cb6d3d
オプションを指定した場合、傷ついた CD を与えると @CDPARANOIA_NAME@ は読み取り
Packit cb6d3d
の失敗を起こします。
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B \-W --disable-scratch-repair
Packit cb6d3d
傷を検出し、同期を保つ処理を行います。ただし壊れたデータの修復は行いま
Packit cb6d3d
せん。ログファイルの出力を行うと(
Packit cb6d3d
.RB \-i
Packit cb6d3d
オプション)、全ての傷のフレーム位置がログファイルに出力されます。
Packit cb6d3d
Packit cb6d3d
.SH 出力される顔文字
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :-)   
Packit cb6d3d
正常動作。ジッタは少ないか、全くない
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :-|   
Packit cb6d3d
正常動作。ジッタは許容範囲
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :-/   
Packit cb6d3d
読み取りでドリフトが発生
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :-P   
Packit cb6d3d
最小単位の読み取り操作において、報告されていない損失がストリーミングにある
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  8-|   
Packit cb6d3d
繰り返して読み取りを行ったが、同じ位置で問題が起きた。修正は困難である
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :-0   
Packit cb6d3d
SCSI/ATAPI のデータ転送エラー
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :-(   
Packit cb6d3d
傷が検出された
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  ;-(   
Packit cb6d3d
データの訂正をあきらめた
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
  :^D   
Packit cb6d3d
読み取り終了
Packit cb6d3d
Packit cb6d3d
.SH 進行表示の意味
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
<スペース> 
Packit cb6d3d
訂正は不要
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
   -    
Packit cb6d3d
ジッタの訂正が必要
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
   +    
Packit cb6d3d
報告されていない損失がストリーミングにある。あるいは別のエラーが読み取り
Packit cb6d3d
時に発生した
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
   !  
Packit cb6d3d
ステージ 1 訂正の後にエラーが見つかった。読み取りを複数回繰り返しても
Packit cb6d3d
同じエラーが発生し、@CDPARANOIA_NAME@ はそのエラーをうまく検出できない。
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
   e    
Packit cb6d3d
SCSI/ATAPI のデータ転送エラー(訂正済み)
Packit cb6d3d
.TP
Packit cb6d3d
.B
Packit cb6d3d
   V    
Packit cb6d3d
訂正できないエラー/データのスキップ
Packit cb6d3d
Packit cb6d3d
.SH 引き数 'span' 
Packit cb6d3d
Packit cb6d3d
引き数 span は、読み取りを行うトラックまたはトラックの一部を指定します。
Packit cb6d3d
この引き数は必ず必要です。
Packit cb6d3d
.B 注意:
Packit cb6d3d
span が単なる数字でなければ、シェルが引き数 span を展開してしまわない
Packit cb6d3d
ようにクォートするのが普通でしょう。
Packit cb6d3d
.P
Packit cb6d3d
引き数 span は、単なるトラック番号か、オフセットとスパンの組合せの指定
Packit cb6d3d
となります。オフセットとスパンの組合せを指定する方法は、だいたい以下の
Packit cb6d3d
ようになります:
Packit cb6d3d
.P
Packit cb6d3d
1[ww:xx:yy.zz]-2[aa:bb:cc.dd] 
Packit cb6d3d
.P
Packit cb6d3d
ここで 1 と 2 はトラック番号です。角括弧の中の数値は、指定されたトラック
Packit cb6d3d
における、より細かいオフセット指定です。[aa:bb:cc.dd] は
Packit cb6d3d
「時間/分/秒/セクタ」の形式です。値が 0 であるフィールドは指定しなくて
Packit cb6d3d
も構いません。つまり [::20], [:20], [20], [20.] 等は 20 秒と解釈され、
Packit cb6d3d
[10:] は 10 秒と解釈され、[.30] は 30 セクタと解釈されます(75 セクタで 
Packit cb6d3d
1 秒です)。
Packit cb6d3d
.P
Packit cb6d3d
オフセットを 1 つしか指定しなければ、これは開始位置のオフセットを表し、
Packit cb6d3d
吸い出しはそのトラックの終わりまで行われます。オフセットが 1 つだけあ
Packit cb6d3d
り、その前後にハイフン(-)がある場合には、省略されているオフセットは
Packit cb6d3d
ディスクの先頭あるいは末尾として解釈されます。例を以下に示します:
Packit cb6d3d
Packit cb6d3d
.TP
Packit cb6d3d
.B  1:[20.35]    
Packit cb6d3d
トラック 1 の 20 秒、35 セクタの位置から、トラック 1 の末尾までを吸い
Packit cb6d3d
出します。
Packit cb6d3d
.TP
Packit cb6d3d
.B 1:[20.35]-   
Packit cb6d3d
1[20.35] の位置からディスクの末尾までを吸い出します。
Packit cb6d3d
.TP
Packit cb6d3d
.B \-2           
Packit cb6d3d
ディスクの先頭からトラック 2 まで(トラック 2 も含みます)を吸い出します。
Packit cb6d3d
.TP
Packit cb6d3d
.B \-2:[30.35]   
Packit cb6d3d
ディスクの先頭から 2:[30.35] の位置まで吸い出します。
Packit cb6d3d
.TP
Packit cb6d3d
.B 2-4          
Packit cb6d3d
トラック 2 の先頭からトラック 4 の末尾までを吸い出します。
Packit cb6d3d
.P
Packit cb6d3d
繰り返しになりますが、角括弧および単語の先頭にあるハイフンは必ずクォート
Packit cb6d3d
して、シェルに展開されないようにしてください。
Packit cb6d3d
Packit cb6d3d
.SH 指定例
Packit cb6d3d
Packit cb6d3d
クォートも含めた指定例をいくつか示します:
Packit cb6d3d
.TP
Packit cb6d3d
ドライブの調査だけを徹底的に行い、自動検出の結果を全て報告します:
Packit cb6d3d
.P
Packit cb6d3d
       @CDPARANOIA_NAME@ -vsQ
Packit cb6d3d
.TP
Packit cb6d3d
ディスク全体を吸い出します。それぞれのトラックは別々のファイルにします:
Packit cb6d3d
.P
Packit cb6d3d
       @CDPARANOIA_NAME@ -B "1-"
Packit cb6d3d
.TP
Packit cb6d3d
トラック 1 の時刻 0:30.12 から時刻 1:10.00 までを吸い出します:
Packit cb6d3d
.P
Packit cb6d3d
       @CDPARANOIA_NAME@ "1[:30.12]-1[1:10]"
Packit cb6d3d
.TP
Packit cb6d3d
トラック 1 の時刻 0:30.12 から 1 分間のデータを吸い出します:
Packit cb6d3d
.P
Packit cb6d3d
       @CDPARANOIA_NAME@ "1[:30.12]-[1:00]"
Packit cb6d3d
Packit cb6d3d
.SH 出力
Packit cb6d3d
Packit cb6d3d
出力ファイルを指定する引き数は省略可能です。指定されていなければ、
Packit cb6d3d
@CDPARANOIA_NAME@ はサンプル音声を
Packit cb6d3d
.BR cdda.wav ", " cdda.aifc ", " cdda.raw
Packit cb6d3d
のいずれかに出力します。どのファイルに出力されるのかは、オプション
Packit cb6d3d
.BR \-w ", " \-a ", " \-r "," \-R
Packit cb6d3d
のうちいずれを使うかによって決まります(何も指定しなければ
Packit cb6d3d
.BR \-w 
Packit cb6d3d
がデフォルト値です)。出力ファイルを指定する引き数が
Packit cb6d3d
.B \-
Packit cb6d3d
ならば、出力は標準出力に対して行われます。どのデータ形式でもパイプに送
Packit cb6d3d
ることができます。
Packit cb6d3d
Packit cb6d3d
.SH 謝辞
Packit cb6d3d
@CDPARANOIA_NAME@ の基となったのは Heiko Eissfeldt さん
Packit cb6d3d
(heiko@colossus.escape.de)が作成した 'cdda2wav' パッケージであり、
Packit cb6d3d
以前は @CDPARANOIA_NAME@ のインタフェースの大部分は cdda2wav からもらってきた
Packit cb6d3d
ものでした。cdda2wav がなければ、@CDPARANOIA_NAME@ が作られることはなかったで
Packit cb6d3d
しょう。
Packit cb6d3d
.P
Packit cb6d3d
Joerg Schilling さんが作成した汎用 SCSI データ転送ライブラリから、SCSI 
Packit cb6d3d
の専門知識を多く学ばせていただきました。
Packit cb6d3d
.P
Packit cb6d3d
.SH 作者
Packit cb6d3d
Monty <monty@xiph.org>
Packit cb6d3d
.P
Packit cb6d3d
cdparanoia のホームページは以下の場所にあります:
Packit cb6d3d
.P
Packit cb6d3d
.ce 
Packit cb6d3d
http://www.xiph.org/paranoia/
Packit cb6d3d
.P
Packit cb6d3d
libcdio のホームページは以下の場所にあります:
Packit cb6d3d
.P
Packit cb6d3d
.ce 
Packit cb6d3d
http://www.gnu.org/libcdio/