Annotation of src/usr.bin/cdio/cdio.1, Revision 1.33
1.33 ! jmc 1: .\" $OpenBSD: cdio.1,v 1.32 2006/05/31 01:14:41 mjc Exp $
1.26 jmc 2: .\"
3: .\" Copyright (c) 1995 Serge V. Vakulenko
4: .\" All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\"
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
15: .\" 3. All advertising materials mentioning features or use of this software
16: .\" must display the following acknowledgement:
17: .\" This product includes software developed by Serge V. Vakulenko.
18: .\" 4. The name of the author may not be used to endorse or promote products
19: .\" derived from this software without specific prior written permission.
20: .\"
21: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
1.21 aaron 31: .\"
1.1 downsj 32: .Dd July 3, 1995
33: .Dt CDIO 1
1.14 aaron 34: .Os
1.1 downsj 35: .Sh NAME
36: .Nm cdio
1.20 espie 37: .Nd compact disc audio player and control utility
1.1 downsj 38: .Sh SYNOPSIS
39: .Nm cdio
1.21 aaron 40: .Op Fl sv
1.28 jmc 41: .Xo
42: .Oo Fl d
43: .Ar host : Ns Ar port Oc
44: .Xc
1.13 aaron 45: .Op Fl f Ar device
46: .Op Ar command args ...
1.1 downsj 47: .Sh DESCRIPTION
1.13 aaron 48: The
1.14 aaron 49: .Nm
1.17 aaron 50: program controls audio features of a CD drive.
51: The
1.13 aaron 52: .Ar device
53: is a name such
1.14 aaron 54: as
1.17 aaron 55: .Dq cd0
1.14 aaron 56: or
57: .Dq mcd0 .
1.1 downsj 58: .Pp
1.13 aaron 59: If a
60: .Ar device
1.14 aaron 61: is not specified, the environment variable
1.1 downsj 62: .Ev DISC
1.13 aaron 63: will be used to find the CD device.
1.1 downsj 64: .Pp
1.13 aaron 65: If no command is given,
1.14 aaron 66: .Nm
1.1 downsj 67: enters an interactive mode, reading commands from the standard input.
68: .Pp
1.16 aaron 69: The options are as follows:
1.19 aaron 70: .Bl -tag -width Ds
1.28 jmc 71: .It Xo
72: .Fl d
73: .Ar host : Ns Ar port
74: .Xc
1.24 espie 75: Specifies cddb host (default: freedb.freedb.org:cddb).
1.13 aaron 76: .It Fl f Ar device
77: Specifies a device name such as
78: .Pa /dev/rcd0d
79: or
80: .Pa mcd0 .
81: Both absolute and relative paths to
82: .Pa /dev
83: filenames are possible.
1.11 deraadt 84: The raw partition name is added if needed.
1.28 jmc 85: .It Fl s
86: Silent mode.
87: Do not print table headers or human-readable comments.
88: .It Fl v
89: Verbose mode.
90: Print as much information as possible.
1.1 downsj 91: .El
92: .Pp
1.17 aaron 93: The available commands are listed below.
94: Only as many characters as are required to uniquely identify a command
95: need be specified.
96: The word
97: .Ic play
1.13 aaron 98: may be omitted.
1.29 jmc 99: .Bl -tag -width Ds
1.32 mjc 100: .It Ic blank
101: Minimally blank the disc.
1.29 jmc 102: .It Ic cddb Op Ar n
103: Print the table of contents after matching the disc with the cddb.
104: In case of multiple matches, reissue the command with
105: .Ar n .
106: .It Ic cdid
107: Print the disc ID that will be used for matching with the cddb.
108: .It Ic close
109: Inject the disc.
110: .It Ic debug Ar on | off
111: Enable/disable the debugging mode of the CD device driver.
112: .It Ic device Ar devname
113: Make
114: .Ar devname
115: the current CD device.
116: This is the equivalent of quitting
117: .Nm
118: and restarting with a different device.
119: .It Ic eject
120: Eject the disc.
1.30 robert 121: .It Ic exit
122: A synonym for
123: .Ic quit .
1.29 jmc 124: .It Ic help
125: Print the list of available commands.
126: .It Ic info
127: Print the table of contents.
128: .It Ic next
129: Play the next track.
130: If we're at the last track, stop.
131: .It Ic pause
132: Stop playing.
133: Do not stop the disc.
1.17 aaron 134: .It Ic play Ar first_track Op Ar last_track
1.14 aaron 135: Play from track
136: .Ar first_track
1.1 downsj 137: to track
1.14 aaron 138: .Ar last_track .
1.13 aaron 139: The first track has number 1 and may be omitted in all cases.
1.31 krw 140: .It Xo Ic play
141: .Op Ar tr1
142: .Ar m1 : Ns Ar s1 Ns Op .f1
143: .Op Ar tr2
144: .Oo Ar m2 : Ns Ar s2 Ns
145: .Op .f2 Oc
146: .Xc
1.1 downsj 147: Play from the absolute address
1.14 aaron 148: (MSF) defined by
1.31 krw 149: .Ar m1
1.14 aaron 150: in minutes,
1.31 krw 151: .Ar s1
152: in seconds,
153: frame number
154: .Ar f1 ,
155: to the absolute address defined by
156: .Ar m2
1.14 aaron 157: in minutes,
1.31 krw 158: .Ar s2
159: in seconds,
160: frame number
161: .Ar f2 .
162: If a track number is specified
163: .Pq tr Ns Ar X ,
164: then the minutes, seconds, and frame numbers
165: are relative to the start of that track.
166: Minutes are in the range 0\(en99.
167: Seconds are in the range 0\(en59.
168: Frame numbers are in the range 0\(en74.
1.29 jmc 169: .It Ic play Op Ar #start_block Op Ar length
1.1 downsj 170: Play starting from the logical block
1.13 aaron 171: .Ar start_block
1.1 downsj 172: using
1.13 aaron 173: .Ar length
1.1 downsj 174: logical blocks.
1.17 aaron 175: .It Ic previous
176: Play the previous track.
177: If we're at the first track, restart.
1.29 jmc 178: .It Ic quit
179: Quit the program.
1.17 aaron 180: .It Ic replay
1.8 angelos 181: Replay the current track again.
1.29 jmc 182: .It Ic reset
183: Perform a hardware reset of the device.
1.17 aaron 184: .It Ic resume
185: Resume playing.
186: Used after the
187: .Ic pause
1.4 deraadt 188: command.
1.29 jmc 189: .It Ic set Ar lba | msf
190: Set LBA
191: .Pq Ar lba
192: or minute-second-frame
193: .Pq Ar msf
194: ioctl mode.
195: The default is minute-second-frame ioctl mode.
196: .It Ic status
197: Print information about the disc:
198: the current playing status and position,
199: the current media catalog status,
200: and the current values of the volume for left and right channels.
1.17 aaron 201: .It Ic stop
1.1 downsj 202: Stop the disc.
1.32 mjc 203: .It Xo Ic tao
204: .Op Fl t Ar tracktypes
205: .Ar trackfile ...
206: .Xc
1.33 ! jmc 207: Write a track-at-once CD containing each
1.32 mjc 208: .Ar trackfile
1.33 ! jmc 209: specified.
1.32 mjc 210: The string
211: .Ar tracktypes
212: is used to assign types to each corresponding
213: .Ar trackfile .
214: Valid characters for the
215: .Ar tracktypes
1.33 ! jmc 216: string are
! 217: .Sq a
! 218: for audio,
! 219: .Sq d
! 220: for data.
1.32 mjc 221: If there are more tracks specified than corresponding
222: types, the last type will be used for the remainder.
223: If
224: .Ar tracktypes
225: is completely unspecified, a track type of data is used.
226: This option is only available from the command line.
1.17 aaron 227: .It Ic volume Ar left_channel Ar right_channel
1.14 aaron 228: Set the volume of the left channel to
1.13 aaron 229: .Ar left_channel
1.14 aaron 230: and the volume of the right channel to
231: .Ar right_channel .
1.29 jmc 232: Allowed values are in the range 0\-255.
233: .It Ic volume Ar left
234: Play the left subtrack on both left and right channels.
235: .It Ic volume Ar mono
236: Set the mono mode.
1.17 aaron 237: .It Ic volume Ar mute
1.1 downsj 238: Turn the sound off.
1.29 jmc 239: .It Ic volume Ar right
240: Play the right subtrack on both left and right channels.
1.17 aaron 241: .It Ic volume Ar stereo
1.1 downsj 242: Set the stereo mode.
1.18 aaron 243: .El
1.1 downsj 244: .Sh FILES
245: .Bl -tag -width /dev/rmcd0c -compact
1.10 mickey 246: .It Pa /dev/rcd0c
247: .It Pa /dev/rmcd0c
1.1 downsj 248: .El
1.28 jmc 249: .Sh SEE ALSO
250: .Xr aucat 1 ,
251: .Xr audioctl 1 ,
252: .Xr mixerctl 1 ,
253: .Xr audio 4
1.1 downsj 254: .Sh HISTORY
255: The
1.14 aaron 256: .Nm
1.1 downsj 257: command is based on
258: .Nm cdcontrol ,
1.22 mpech 259: which first appeared in
260: .Fx 2.1 .
1.27 jmc 261: .Sh AUTHORS
262: Jean-Marc Zucconi,
263: Andrey A. Chernov,
264: Serge V. Vakulenko,
265: Marc Espie