cdcontrol.1 revision 13865 
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 Op 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 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 information about the disc:
115the current playing status and position,
116the current values of the volume for left and right channels,
117and the table of contents.
118
119.It Cm help
120Print the list of available commands.
121
122.It Cm debug Ar on
123Enable the debugging mode of the CD device driver.
124
125.It Cm debug Ar off
126Disable the driver debugging mode.
127
128.It Cm debug Ar reset
129Perform the hardware reset of the device.
130
131.It Cm quit
132Quit the program.
133
134.Sh FILES
135.Bl -tag -width /dev/rmcd0c -compact
136.It Pa /dev/rcd0c
137.It Pa /dev/rmcd0c
138.It Pa /dev/rwcd0c
139.El
140.Sh AUTHORS
141Jean-Marc Zucconi,
142Andrey A.\ Chernov,
143Serge V.\ Vakulenko
144.Sh HISTORY
145The
146.Nm cdcontrol
147command appeared in FreeBSD 2.1
148