名前

書式

説明

device は CD レコーダの scsibus/ target/ lun を指す。 SunOS での通信は汎用 SCSI ドライバ scg を用いて行われる。他の OS では、このドライバをシミュレートするライブラリを使う。使用可能な書式は、 dev= scsibus, target, lun または dev= target, lun である。後者の場合、CD-R はマシンのデフォルトの SCSI バスに接続されていなければならない。 scsibus, target, lun は整数である。 OS や SCSI 転送の実装のなかには、これに加えてデバイスファイル名を指定しなければならないものもある。この場合の正しい書式は、 dev= devicename: scsibus, target, lun または dev= devicename: target, lun である。このようなシステムでは、指定されたデバイスノード名が 1 つの SCSI デバイスのみを参照している場合、 dev= devicename: scsibus, target, lun の代わりに、省略形の dev= devicename: @ または dev= devicename: @, lun を使うことができる。

リモートの SCSI デバイスにアクセスするためには、リモートのデバイスであることを示すインジケータを SCSI デバイス名の前に付ける必要がある。リモートデバイスのインジケータは REMOTE:user@host: または REMOTE:host: という形式である。

指定可能なリモート SCSI デバイス名は、 REMOTE:user@host: または REMOTE:user@host:1,0,0 という形式である。 1 つ目の形式では、リモートで SCSI デバイスのスキャンを行わせる。 2 つ目の形式では、 host の SCSI bus # 1,target 0 lun 0 に接続されている SCSI デバイスにアクセスする。

readcd を全ての UNIX 系プラットフォームで汎用的にするためには、 dev= devicename: scsibus, target, lun という書式が好ましい。これによりデバイスについての各 OS 特有の知識をユーザーに対して隠蔽することができる。またこれにより、実際のデバイスファイル名や scsibus, target, lun を指定する方法を、特定の OS 上でサポートする必要がなくなる。

scsibus 0 はマシンのデフォルトの SCSI バスである。マシンの SCSI 設定についてのより詳細な情報は、ブート時のメッセージや /var/adm/messages を参照すること。 scsibus, target, lun にどのような値を指定してよいか分らない場合は、 cdrecord の -scanbus オプションを使ってみること。

オプション

-version

バージョン情報を表示して、終了する。

dev= target

CD レコーダの SCSI target を設定する。上記を参照。一般的なデバイス指定では dev= 6,0 である。数値での target 指定の他に、ファイル名も指定しなければならない場合、そのファイル名は実装依存である。この場合の正確なファイル名は、対象とする OS の独自のマニュアルに書かれているだろう。 CAM をサポートしてない FreeBSD システムでは、 ( /dev/rcd0.ctl などの) 制御デバイスを使う必要がある。この場合の正確なデバイス指定は、 dev= /dev/rcd0.ctl:@ である。

 

Linux では、パラレルポートアダプタに接続されたデバイスは、仮想 SCSI bus に対応付けされる。別のパラレルポートアダプタは、この仮想 SCSI bus の別の target に対応付けされる。

 

dev オプションが指定されていない場合、 cdrecord は環境変数 CDR_DEVICE からデバイスを取得しようとする。

 

dev= オプションの引き数に文字 ',', '/', '@', ':' がない場合、ファイル /etc/default/cdrecord に書かれたラベル名として扱われる (「ファイル」セクションを参照すること)。

timeout= #

SCSI コマンドのデフォルトのタイムアウトを # 秒にする。 SCSI コマンドのデフォルトのタイムアウトは、 SCSI コマンドを送る際の最短タイムアウトとして使われる。 SCSI コマンドがタイムアウトにより失敗した場合、タイムアウトの値を失敗したコマンドのデフォルトのタイムアウトより長くすることができる。タイムアウトを長くしてコマンドが正常に動作した場合は、成功したときのタイムアウト時間とそのコマンドを、このプログラムの著者に知らせて下さい。 timeout オプションが指定されない場合、デフォルトのタイムアウト 40 秒が使われる。

debug= #, -d

(debug=# を使って) その他のデバッグレベルを # に設定する。または (-d を使って) デバッグレベルを 1 つ上げる。 -dd を指定した場合、 debug= 2 と等しくなる。 libscg でドライバをオープンする際の問題や、セクタサイズとセクタタイプの問題を発見するのに役立つ。 -debug を使うと、処理が遅くなりバッファアンダーランの原因になるかもしれない。

kdebug=#, kd=#

scg ドライバに対して、SCSI コマンドを動作させているときのカーネルデバッグレベルを変更させる。

-silent, -s

SCSI コマンドが失敗したときの状況報告を表示させない。

-v

一般的な表示の詳細度を 1 つ上げる。例えば、書き込み処理の進捗状況を表示するために使われる。

-V

SCSI コマンド転送に関する表示の詳細度を 1 つ上げる。 CD レコーダにおける書き込み処理での問題をデバックするのに役立つ。簡単なエラーメッセージしか表示されない場合は、このフラグを使って詳細な表示を行わせることができる。 -VV を指定すると、データバッファの内容も表示される。 -V や -VV を使うと、処理が遅くなりバッファアンダーランの原因になるかもしれない。

f= file

-w

書き込みモードに変更する。このオプションが指定されない場合、 readcd は指定されたデバイスから読み出しを行う。

sectors= range

読み出しを行うセクタの範囲を指定する。範囲は「開始セクタ番号-終了セクタ番号」という形式で指定する。

-notrunc

出力ファイルをオープンするときに切り詰めない。

 

例

CD-ROM のメディア全体を読み出して、ファイル cdimage.raw にデータを書き出す:

readcd dev=2,0 f=cdimage.raw

CD-ROM のセクタ範囲 150 〜 10000 を読み出して、ファイル cdimage.raw に書き出す:

readcd dev=2,0 sectors=150-10000 f=cdimage.raw

ファイル cdimage.raw のデータ (例えば、 mkisofs で作成したファイルシステムイメージ) を DVD-RAM に書き出す:

readcd dev=2,0 -w f=cdimage.raw

ファイル

関連項目

注意

chown root /usr/local/bin/readcd

chmod 4711 /usr/local/bin/readcd

特定のユーザーのグループに readcd を使う権限を与えたいならば以下を実行する:

chown root /usr/local/bin/readcd

chgrp cdburners /usr/local/bin/readcd

chmod 4710 /usr/local/bin/readcd

そして、システムの cdburners グループに追加する。

ディスクの読み込み・書き出し・フォーマットを全てのユーザーに許可したい場合を除き、 root 以外のユーザーに /dev/scg? への書き込みを許可してはならない。

CD レコーダや読み込み元のディスクが接続された SCSI バスに、切断や再接続に対応していない昔のディスクを接続するべきではない。

壊れた Linux SCSI generic driver で readcd を使う場合、 readcd は scg ドライバの機能をエミュレートを試みるという対処療法を使う。不幸なことに、 Linux の sg ドライバには以下のような酷いバグがある:

•

SCSI コマンドが全く送られていないかを調べることができない。

•

SCSI status バイトを取得できない。このため、 readcd は失敗した SCSI コマンドをある状況下では報告できない。

•

転送時の実際の DMA カウントを取得できない。 readcd は、DMA の残余カウントがあるかをユーザーに知らせることができない。

•

auto sense データのうち有効なバイト数を取得できない。 readcd は、認識したデータをデバイスが全く転送していないかをユーザーに知らせることができない。

•

auto request sense では非常に少ないデータしか取得できない (CCS/SCSI-2/SCSI-3 では 18 以上でなければならない)。

 

返り値

2 行目には失敗したコマンドの SCSI コマンドのディスクリプターブロックが表示される。

3 行目には、コマンドの転送が成功した場合に、コマンドによって返される SCSI status コードについての情報が表示される。これは SCSI デバイスからのエラー情報である。

4 行目はコマンドの auto request sense 情報の 16 進ダンプである。

5 行目は (もし存在すれば) sense key のエラー文字列である。コマンドが copy の場合にのみ、セグメント番号が続く。エラーメッセージが現在のコマンドに直接関係していない場合、 deferred error という文字列が表示される。

6 行目は sense code のエラー文字列である。存在する場合には sense qualifier も表示される。デバイスのタイプが既知の場合、 sense data は scsierrs.c" にあるテーブルを用いてデコードされる。その文字列の後には field replaceable unit についてのエラー値が続く。

7 行目には、失敗したコマンドに関連したブロック番号とエラーフラグ文字列が表示される。ブロック番号は有効ではないかも知れない。

8 行目は、そのコマンドについて設定されたタイムアウトと、実際にコマンドが完了するまでにかかった時間が表示される。

バグ

謝辞

メーリングリスト

著者

その他の情報は以下で入手できる。

http://www.fokus.gmd.de/usr/schilling/cdrecord.html

サポートに関する質問は、

cdrecord-support@berlios.de

または other-cdwrite@lists.debian.org

にメールを送ってください。

明らかなバグを見付けた場合は、

cdrecord-developers@berlios.de

または schilling@fokus.gmd.de

にメールを送ってください。

メーリングリストを購読するには、

http://lists.berlios.de/mailman/listinfo/cdrecord-developers

または http://lists.berlios.de/mailman/listinfo/cdrecord-support

を参照すること。