cdcontrol.1 revision 13884 
1.Dd July 3, 1995
2.Dt CDCONTROL 1
3.Os FreeBSD
4.Sh NAME
5.Nm cdcontrol
6.Nd compact disc control utility
7.Sh SYNOPSIS
8.Nm cdcontrol
9.Op Fl s
10.Op Fl v
11.Op Fl f Ar discname
12.Op Ar command args...
13.Sh DESCRIPTION
14.Nm cdcontrol
15is a program to control audio features of a CD drive. The device is a name such
16as cd0 or mcd0. 
17.Pp
18If the device not specified, the environment variable 
19.Ev DISC
20will be used to find the cd device.
21.Pp
22If no command is given, then
23.Nm cdcontrol
24enters an interactive mode, reading commands from the standard input.
25.Pp
26The following options are available:
27.Bl -tag -width flag
28.It Fl s
29Silent mode - do not print table headers and human readable comments.
30.It Fl v
31Verbose mode - print as much information as possible.
32.It Fl f Ar discname
33Specifies a device name, such as /dev/cd0c or mcd0.
34Both absolute path and relative to /dev filename are possible.
35Suffix `c' is added to the device name if needed.
36.El
37.Pp
38The available commands are listed below.  Only as many
39characters as are required to uniquely identify a command
40need be specified.
41.Bl -tag -width Cm
42
43.It Cm play Ar first_track Op Ar last_track
44Play from track 
45.Nm first_track
46to track
47.Nm last_track. 
48The first track has number 1.
49
50.It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
51Play from the absolute address
52(MSF) defined by 
53.Nm start_m
54in minutes, 
55.Nm start_s,
56in seconds and 
57.Nm start_f
58(frame number) to the absolute address defined by
59.Nm end_m
60in minutes, 
61.Nm end_s,
62in seconds and 
63.Nm end_f
64(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
65Frame numbers are in the range 0-74.
66
67.It Cm play Op Ar #start_block Op length
68Play starting from the logical block
69.Nm start_block
70using
71.Nm length
72logical blocks.
73
74.It Cm pause
75Stop playing. Do not stop the disc.
76
77.It Cm resume
78Resume playing. Used after the 
79.Nm pause
80 command.
81
82.It Cm stop
83Stop the disc.
84
85.It Cm eject
86Eject the disc.
87
88.It Cm inject
89Inject the disc.
90
91.It Cm volume Ar left_channel Ar right_channel
92Set the volume of left channel to 
93.Nm left_channel
94and the volume of right channel to 
95.Nm right_channel. 
96Allowed values are in the range 0-255. 
97
98.It Cm volume Ar mute
99Turn the sound off.
100
101.It Cm volume Ar mono
102Set the mono mode.
103
104.It Cm volume Ar stereo
105Set the stereo mode.
106
107.It Cm volume Ar left
108Play the left subtrack on both left and right channels.
109
110.It Cm volume Ar right
111Play the right subtrack on both left and right channels.
112
113.It Cm info
114Print the the table of contents.
115
116.It Cm status
117Print the information about the disc:
118the current playing status and position,
119the current values of the volume for left and right channels.
120
121.It Cm help
122Print the list of available commands.
123
124.It Cm debug Ar on
125Enable the debugging mode of the CD device driver.
126
127.It Cm debug Ar off
128Disable the driver debugging mode.
129
130.It Cm reset
131Perform the hardware reset of the device.
132
133.It Cm set Ar msf
134Set minute-second-frame ioctl mode (default).
135
136.It Cm set Ar lba
137Set LBA ioctl mode.
138
139.It Cm quit
140Quit the program.
141
142.Sh FILES
143.Bl -tag -width /dev/rmcd0c -compact
144.It Pa /dev/rcd0c
145.It Pa /dev/rmcd0c
146.It Pa /dev/rwcd0c
147.El
148.Sh AUTHORS
149Jean-Marc Zucconi,
150Andrey A.\ Chernov,
151Serge V.\ Vakulenko
152.Sh HISTORY
153The
154.Nm cdcontrol
155command appeared in FreeBSD 2.1
156