.TH CDPARANOIA 1
.\" Translated Sun Aug 22 18:02:41 JST 1999
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.SH 名前
cdparanoia (Paranoia release III) \- オーディオ CD 読み取りユーティリティ。特別なデータ照合機能を持つ。
.SH 日付
バージョンIII リリースα9.6 (17 Aug 1999)
.SH 書式
.B cdparanoia
.RB [ options ]
.B span 
.RB [ outfile ]
.SH 説明
.B cdparanoia
は CD-DA 機能を持つ CD-ROM ドライブからオーディオトラックを取り出しま
す。このデータは WAV, AIFF, AIFF-C, raw 形式でファイルにセーブすること
や、標準出力に送ることができます。ほとんどの ATAPI, SCSI, メーカー独自
の CD-ROM ドライブがサポートされています。
.B cdparanoia
は対象のドライブが CD-DA 機能を持っているかどうかを判別できます。
.P
単純な読み取りだけでなく、
.B cdparanoia
は特別に頑健なデータ照合機能、同期機能、エラー処理機能、破損データの再
構成機能を持っています。
.SH オプション

.TP
.B \-v --verbose
自動検出と読み取りの処理について、ばかばかしいほど冗長な表示を行います。
設定やデバッグの際に便利です。

.TP
.B \-q --quiet
読み取り処理の途中に、進行状況やエラー情報を全く表示しません。

.TP
.B \-e --stderr-progress
進行状況を(ラッパスクリプトのために)標準エラー出力に出力します。

.TP
.B \-V --version
プログラムのバージョンを表示して終了します。

.TP
.B \-Q --query
CD-ROM ドライブの自動検出を行い、CD-ROM の TOC の問い合わせと表示を行
い、終了します。

.TP
.B \-s --search-for-drive
たとえ /dev/cdrom のリンクが存在していても、CD-ROM ドライブの完全な
検索を行います。

.TP
.B \-h --help
.B cdparanoia 
の使い方とオプションを簡単な説明を出力します。

.TP
.B \-p --output-raw
ヘッダ無しのデータをホストのバイト順で、インタリーブ処理を施した
サンプル音声を含む raw 形式の 16 ビット PCM データとして出力します。
バイト順としてリトルエンディアンあるいはビッグエンディアンを指定するに
は、後述の
.B \-r 
または
.B \-R
オプションを使ってください。

.TP
.B \-r --output-raw-little-endian
ヘッダ無しのデータを LSB first のバイト順で、インタリーブ処理を施した
サンプル音声を含む raw 形式の 16 ビット PCM データとして出力します。

.TP
.B \-R --output-raw-big-endian
ヘッダ無しのデータを MSB first のバイト順で、インタリーブ処理を施した
サンプル音声を含む raw 形式の 16 ビット PCM データとして出力します。

.TP
.B \-w --output-wav
データを Micro$oft の RIFF WAV 形式で出力します(WAV データのバイト順は
必ず LSB first である点に注意)。

.TP
.B \-f --output-aiff
データを Apple の AIFF 形式で出力します(AIFC データのバイト順は必ず 
MSB first である点に注意)。

.TP
.B \-a --output-aifc
データを無圧縮 の Apple AIFF-C 形式で出力します(AIFF-C データのバイト
順は必ず MSB first である点に注意)。

.TP
.BI "\-B --batch "
cdda2wav 形式のバッチ出力を行います。cdparanoia は出力をトラック境界で
複数ファイルに分割します。出力ファイルのファイル名の先頭部分は、'track(番号)' 
となります。

.TP
.B \-c --force-cdrom-little-endian
一部の CD-ROM は間違ったエンディアンを報告します(あるいはエンディアン
に関する情報を全く報告しません)。そのため、cdparanoia がエンディアンを
間違えることがあります。ドライブをリトルエンディアンのデバイスとして
cdparanoia に扱わせるには、
.B \-c
オプションを使います。

.TP
.B \-C --force-cdrom-big-endian
前のオプションの逆で、デバイスをビッグエンディアンのデバイスとして
cdparanoia に扱わせます。

.TP
.BI "\-n --force-default-sectors " n
インタフェースのバックエンドが行う最小単位の読み取りを、
1 回の読み取りごとに
.B n
セクタとします。この数は問題を起こすおそれがあります。カーネルは多くの
場合、読み取り要求を最小単位の読み取り(cdparanoia による自動処理はこれ
に対応しています)複数個に分割するか、制限された大きさの範囲でしか
読み取りを許可しません。
.B 普通はこのオプションを使うべきではありません。

.TP
.BI "\-d --force-cdrom-device " device
インタフェースのバックエンドによる読み取りを、最初に見つけた読み取り可
能な CD-ROM ドライブではなく、指定した
.B device
から行うようにします。このオプションでは、利用可能である任意の
インタフェース(ATAPI, SCSI, メーカー独自)を持つデバイスを指定すること
ができます。

.TP
.BI "\-g --force-generic-device " device
このオプションは、SCSI CD-ROM と汎用デバイスの設定を明示的に別々に制御
したい時に
.B \-d
オプションと組み合わせて使います。このオプションが役立つのは、SCSI の
設定が標準と異なる場合だけです。

.TP
.BI "\-S --force-read-speed " number
CD ドライブからの読み込み速度を設定するには、このオプションを明示的に
使ってください(ドライブが対応している場合)。このオプションを用いると、
ディスクが遅い場合やメモリが少ない場合に起こるアンダーランを減らすこと
ができます。

.TP
.B \-Z --disable-paranoia
データ照合と訂正機能を
.b 全て
無効にします。-Z オプションを用いると、cdparanoia は
オーバーラップの設定が 0 である cdda2wav と全く同じようにデータの
読み取りを行います。
このオプションを指定すると
.B \-W ,
.B \-X ,
.B \-Y
オプションも有効になりますが、
.B \-Z \-W \-X \-Y
と全く同じでは
.B ありません。
なぜなら、
.B \-W
から
.B \-Z
までのオプションにより照合のレベルが階層的に変わるからです。実際に有効
になるのは最後に指定したオプションだけです。

.TP
.B \-Y --disable-extra-paranoia
読み取ったデータの中間におけるデータ照合を行いません。つまり、
データの読み取り境界におけるオーバーラップ部分のチェックしか行いません。

.TP
.B \-X --disable-scratch-detection
照合の途中では傷の探査も行わず、傷に対して頑健な同期処理も行いません。
.B \-X
オプションを指定した場合、傷ついた CD を与えると cdparanoia は読み取り
の失敗を起こします。

.TP
.B \-W --disable-scratch-repair
傷を検出し、同期を保つ処理を行います。ただし壊れたデータの修復は行いま
せん。ログファイルの出力を行うと(
.RB \-i
オプション)、全ての傷のフレーム位置がログファイルに出力されます。

.SH 出力される顔文字
.TP
.B
  :-)   
正常動作。ジッタは少ないか、全くない
.TP
.B
  :-|   
正常動作。ジッタは許容範囲
.TP
.B
  :-/   
読み取りでドリフトが発生
.TP
.B
  :-P   
最小単位の読み取り操作において、報告されていない損失がストリーミングにある
.TP
.B
  8-|   
繰り返して読み取りを行ったが、同じ位置で問題が起きた。修正は困難である
.TP
.B
  :-0   
SCSI/ATAPI のデータ転送エラー
.TP
.B
  :-(   
傷が検出された
.TP
.B
  ;-(   
データの訂正をあきらめた
.TP
.B
  :^D   
読み取り終了

.SH 進行表示の意味
.TP
.B
<スペース> 
訂正は不要
.TP
.B
   -    
ジッタの訂正が必要
.TP
.B
   +    
報告されていない損失がストリーミングにある。あるいは別のエラーが読み取り
時に発生した
.TP
.B
   !  
ステージ 1 訂正の後にエラーが見つかった。読み取りを複数回繰り返しても
同じエラーが発生し、cdparanoia はそのエラーをうまく検出できない。
.TP
.B
   e    
SCSI/ATAPI のデータ転送エラー(訂正済み)
.TP
.B
   V    
訂正できないエラー/データのスキップ

.SH 引き数 'span' 

引き数 span は、読み取りを行うトラックまたはトラックの一部を指定します。
この引き数は必ず必要です。
.B 注意:
span が単なる数字でなければ、シェルが引き数 span を展開してしまわない
ようにクォートするのが普通でしょう。
.P
引き数 span は、単なるトラック番号か、オフセットとスパンの組合せの指定
となります。オフセットとスパンの組合せを指定する方法は、だいたい以下の
ようになります:
.P
1[ww:xx:yy.zz]-2[aa:bb:cc.dd] 
.P
ここで 1 と 2 はトラック番号です。角括弧の中の数値は、指定されたトラック
における、より細かいオフセット指定です。[aa:bb:cc.dd] は
「時間/分/秒/セクタ」の形式です。値が 0 であるフィールドは指定しなくて
も構いません。つまり [::20], [:20], [20], [20.] 等は 20 秒と解釈され、
[10:] は 10 秒と解釈され、[.30] は 30 セクタと解釈されます(75 セクタで 
1 秒です)。
.P
オフセットを 1 つしか指定しなければ、これは開始位置のオフセットを表し、
吸い出しはそのトラックの終わりまで行われます。オフセットが 1 つだけあ
り、その前後にハイフン(-)がある場合には、省略されているオフセットは
ディスクの先頭あるいは末尾として解釈されます。例を以下に示します:

.TP
.B  1:[20.35]    
トラック 1 の 20 秒、35 セクタの位置から、トラック 1 の末尾までを吸い
出します。
.TP
.B 1:[20.35]-   
1[20.35] の位置からディスクの末尾までを吸い出します。
.TP
.B \-2           
ディスクの先頭からトラック 2 まで(トラック 2 も含みます)を吸い出します。
.TP
.B \-2:[30.35]   
ディスクの先頭から 2:[30.35] の位置まで吸い出します。
.TP
.B 2-4          
トラック 2 の先頭からトラック 4 の末尾までを吸い出します。
.P
繰り返しになりますが、角括弧および単語の先頭にあるハイフンは必ずクォート
して、シェルに展開されないようにしてください。

.SH 指定例

クォートも含めた指定例をいくつか示します:
.TP
ドライブの調査だけを徹底的に行い、自動検出の結果を全て報告します:
.P
       cdparanoia -vsQ
.TP
ディスク全体を吸い出します。それぞれのトラックは別々のファイルにします:
.P
       cdparanoia -B "1-"
.TP
トラック 1 の時刻 0:30.12 から時刻 1:10.00 までを吸い出します:
.P
       cdparanoia "1[:30.12]-1[1:10]"
.TP
トラック 1 の時刻 0:30.12 から 1 分間のデータを吸い出します:
.P
       cdparanoia "1[:30.12]-[1:00]"

.SH 出力

出力ファイルを指定する引き数は省略可能です。指定されていなければ、
cdparanoia はサンプル音声を
.BR cdda.wav ", " cdda.aifc ", " cdda.raw
のいずれかに出力します。どのファイルに出力されるのかは、オプション
.BR \-w ", " \-a ", " \-r "," \-R
のうちいずれを使うかによって決まります(何も指定しなければ
.BR \-w 
がデフォルト値です)。出力ファイルを指定する引き数が
.B \-
ならば、出力は標準出力に対して行われます。どのデータ形式でもパイプに送
ることができます。

.SH 謝辞
cdparanoia の基となったのは Heiko Eissfeldt さん
(heiko@colossus.escape.de)が作成した 'cdda2wav' パッケージであり、
以前は cdparanoia のインタフェースの大部分は cdda2wav からもらってきた
ものでした。cdda2wav がなければ、cdparanoia が作られることはなかったで
しょう。
.P
Joerg Schilling さんが作成した汎用 SCSI データ転送ライブラリから、SCSI 
の専門知識を多く学ばせていただきました。
.P
.SH 作者
Monty <monty@xiph.org>
.P
cdparanoia のホームページは以下の場所にあります:
.P
.ce 
http://www.xiph.org/paranoia/
