.\" %FreeBSD: src/usr.sbin/cdcontrol/cdcontrol.1,v 1.39 2003/11/17 14:02:04 eivind Exp %
.\"
.\" $FreeBSD$
.\"
.Dd May 8, 2002
.Dt CDCONTROL 1
.Os
.Sh 名称
.Nm cdcontrol
.Nd コンパクトディスク制御ユーティリティ
.Sh 書式
.Nm cdcontrol
.Op Fl sv
.Op Fl f Ar device
.Op Ar command ...
.Sh 解説
.Nm
ユーティリティはオーディオ CD プレイヤを操作するためのプログラムです。
device には
.Pa cd0
や
.Pa acd0
などを指定します。
.Pp
.Ar command
を指定しない場合、
.Nm
は対話モードになり、標準入力からコマンドを読み込みます。
.Pp
以下のオプションを使用可能です。
.Bl -tag -width indent
.It Fl s
サイレントモード。
テーブルヘッダ及び人間が可読なコメントを表示しません。
.It Fl v
冗長モード。
表示できる情報は全て表示します。
.It Fl f Ar device
.Pa /dev/cd0
や
.Pa acd0
といったデバイスを指定します。
絶対パス及び
.Pa /dev
からの相対パスの指定が可能です。
.Fl f
オプションは
.Ev CDROM
に優先します。
.Ev CDROM
も
.Fl f
オプションも指定されない場合、
.Nm
は最初に
.Pa /dev/cdrom
を、次に
.Pa /dev/cd0
を、最後に
.Pa /dev/acd0
をオープンしようとします。
.El
.Pp
現時点では以下のコマンドが利用できます。
コマンドをユニークに特定できるために必要な文字だけ指定する
必要があります。
語
.Ic play
は省略可能であり、
.Ic next
と
.Ic prev
の代りに文字
.Ic +
と
.Ic -
を使用可能です。
.Bl -tag -width indent
.It Ic play Ar first_track Op Ar last_track
.Ar first_track
で指定されたトラックから
.Ar last_track
で指定されたトラックまで演奏します。最初のトラックが1番になります。
.It Xo
.Ic play
.Ar start_m : Ns Ar start_s . Ns Ar start_f
.Op Ar end_m : Ns Ar end_s . Ns Ar end_f
.Xc
絶対アドレス (MSF) を元に演奏します。演奏開始する時間は
.Ar start_m
に演奏開始する分を、
.Ar start_s
に秒を、
.Ar start_f
にはフレーム番号を指定します。演奏終了の時間は
.Ar end_m
に演奏終了する分を、
.Ar end_s
に秒を、
.Ar end_f
にフレーム番号を指定することで指定できます。分指定で指定できる数値は 0
から 99 の範囲の値です。秒には 0 から 59 までが指定できます。フレーム
番号は 0 から 74 までの範囲で指定できます。
.It Ic play Op # Ns Ar start_block Op Ar length
論理ブロック
.Ar start_block
から
.Ar length
論理ブロック分だけ演奏します。
.It Ic next Op Ar tracks
指定した数のトラックを、前向きにスキップします (デフォルト 1)。
.It Ic prev Op Ar tracks
指定した数のトラックを、後向きにスキップします (デフォルト 1)。
.It Ic pause
演奏を停止します。ディスクは停止しません。
.It Ic resume
演奏を再開します。
.Ic pause
で一時停止した後に使います。
.It Ic stop
ディスクを停止します。
.It Ic eject
ディスクを取り出します。
.It Ic close
ディスクを挿入します。
.It Ic volume Ar left_channel right_channel
左チャネルのボリュームを
.Ar left_channel
にセットし、右チャネルを
.Ar right_channel
にセットします。指定できる値は 0 から 255 の範囲の値です。
.It Ic volume Cm mute
音を消します。
.It Ic volume Cm mono
モノラルモードにします。
.It Ic volume Cm stereo
ステレオモードにします。
.It Ic volume Cm left
左サブトラックを左と右の両チャネルで演奏します。
.It Ic volume Cm right
右サブトラックを左と右の両チャネルで演奏します。
.It Ic info
目次を表示します。
.It Ic status Op Cm audio | media | volume
ディスクに関する以下のような情報を表示します:
.Pp
.Bl -tag -width ".Cm volume" -compact
.It Cm audio
現在の演奏の状態と位置、
.It Cm media
現在のメディアカタログ状態、
.It Cm volume
現在の左チャネル及び右チャネルのボリューム値。
.El
.It Ic cdid
CD のシリアル番号を、
.Tn CDDB
プロジェクト
.Pq Pa http://www.cddb.org/
が使用する方法を使用して、
表示します。
.It Ic help
利用可能なコマンドの一覧を表示します。
.It Ic debug Cm on
CD デバイスドライバのデバッグモードを有効にします。
.It Ic debug Cm off
ドライバのデバッグモードを無効にします。
.It Ic reset
デバイスに対するハードウェアリセットを実行します。
.It Ic set Cm msf
minute-second-frame ioctl モードに設定します (デフォルト)。
.It Ic set Cm lba
LBA ioctl モードに設定します。
.It Ic speed Ar s
ドライブが読み込みに使用可能な最高速度を指定します。
単倍速 CDROM (150KB/s) の倍数の単位となります。
ドライブの最高速度を指定するには
.Dq Li max
を使用します。
.It Ic quit
プログラムを終了します。
.El
.Sh 環境変数
次の環境変数が
.Nm
の実行に影響します:
.Bl -tag -width ".Ev CD_DRIVE"
.It Ev CDROM
.Fl f
オプションで指定しなかった場合に使用される CD デバイス。
.It Ev CDPLAY , CD_DRIVE , DISC , MUSIC_CD
.Ev CDROM
が選ばれたため、これらの変数の価値は低下しています。
.El
.Sh 関連ファイル
.Bl -tag -width ".Pa /dev/mcd0" -compact
.It Pa /dev/cd0
.It Pa /dev/mcd0
.It Pa /dev/acd0
.El
.Sh 作者
.An Jean-Marc Zucconi
.An Andrey A. Chernov
.An Serge V. Vakulenko
.Sh 歴史
.Nm
コマンドは
.Fx 2.1
から登場しました。