Annotation of src/usr.bin/cdio/cdio.1, Revision 1.37
1.37 ! jmc 1: .\" $OpenBSD: cdio.1,v 1.36 2006/06/01 07:55:10 jmc 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.37 ! jmc 37: .Nd compact disc control utility
1.1 downsj 38: .Sh SYNOPSIS
39: .Nm cdio
1.21 aaron 40: .Op Fl sv
1.37 ! jmc 41: .Oo Fl d Ar host :
! 42: .Ar port Oc
1.13 aaron 43: .Op Fl f Ar device
44: .Op Ar command args ...
1.1 downsj 45: .Sh DESCRIPTION
1.13 aaron 46: The
1.14 aaron 47: .Nm
1.37 ! jmc 48: program is a compact disc control utility,
! 49: with support for playing audio CDs and TAO CD writing.
1.1 downsj 50: .Pp
1.13 aaron 51: If no command is given,
1.14 aaron 52: .Nm
1.37 ! jmc 53: enters interactive mode, reading commands from the standard input.
1.1 downsj 54: .Pp
1.16 aaron 55: The options are as follows:
1.19 aaron 56: .Bl -tag -width Ds
1.28 jmc 57: .It Xo
58: .Fl d
59: .Ar host : Ns Ar port
60: .Xc
1.24 espie 61: Specifies cddb host (default: freedb.freedb.org:cddb).
1.13 aaron 62: .It Fl f Ar device
63: Specifies a device name such as
64: .Pa /dev/rcd0d
65: or
66: .Pa mcd0 .
67: Both absolute and relative paths to
68: .Pa /dev
69: filenames are possible.
1.11 deraadt 70: The raw partition name is added if needed.
1.37 ! jmc 71: If this option is not used, the environment variable
! 72: .Ev DISC
! 73: will be used to find the CD device.
1.28 jmc 74: .It Fl s
75: Silent mode.
76: Do not print table headers or human-readable comments.
77: .It Fl v
78: Verbose mode.
79: Print as much information as possible.
1.1 downsj 80: .El
81: .Pp
1.17 aaron 82: The available commands are listed below.
83: Only as many characters as are required to uniquely identify a command
84: need be specified.
85: The word
86: .Ic play
1.13 aaron 87: may be omitted.
1.29 jmc 88: .Bl -tag -width Ds
1.32 mjc 89: .It Ic blank
90: Minimally blank the disc.
1.29 jmc 91: .It Ic cddb Op Ar n
92: Print the table of contents after matching the disc with the cddb.
93: In case of multiple matches, reissue the command with
94: .Ar n .
95: .It Ic cdid
96: Print the disc ID that will be used for matching with the cddb.
97: .It Ic close
98: Inject the disc.
99: .It Ic debug Ar on | off
100: Enable/disable the debugging mode of the CD device driver.
101: .It Ic device Ar devname
102: Make
103: .Ar devname
104: the current CD device.
105: This is the equivalent of quitting
106: .Nm
107: and restarting with a different device.
108: .It Ic eject
109: Eject the disc.
1.30 robert 110: .It Ic exit
111: A synonym for
112: .Ic quit .
1.29 jmc 113: .It Ic help
114: Print the list of available commands.
115: .It Ic info
116: Print the table of contents.
117: .It Ic next
118: Play the next track.
119: If we're at the last track, stop.
120: .It Ic pause
121: Stop playing.
122: Do not stop the disc.
1.17 aaron 123: .It Ic play Ar first_track Op Ar last_track
1.14 aaron 124: Play from track
125: .Ar first_track
1.1 downsj 126: to track
1.14 aaron 127: .Ar last_track .
1.13 aaron 128: The first track has number 1 and may be omitted in all cases.
1.31 krw 129: .It Xo Ic play
130: .Op Ar tr1
131: .Ar m1 : Ns Ar s1 Ns Op .f1
132: .Op Ar tr2
133: .Oo Ar m2 : Ns Ar s2 Ns
134: .Op .f2 Oc
135: .Xc
1.1 downsj 136: Play from the absolute address
1.14 aaron 137: (MSF) defined by
1.31 krw 138: .Ar m1
1.14 aaron 139: in minutes,
1.31 krw 140: .Ar s1
141: in seconds,
142: frame number
143: .Ar f1 ,
144: to the absolute address defined by
145: .Ar m2
1.14 aaron 146: in minutes,
1.31 krw 147: .Ar s2
148: in seconds,
149: frame number
150: .Ar f2 .
151: If a track number is specified
152: .Pq tr Ns Ar X ,
153: then the minutes, seconds, and frame numbers
154: are relative to the start of that track.
155: Minutes are in the range 0\(en99.
156: Seconds are in the range 0\(en59.
157: Frame numbers are in the range 0\(en74.
1.29 jmc 158: .It Ic play Op Ar #start_block Op Ar length
1.1 downsj 159: Play starting from the logical block
1.13 aaron 160: .Ar start_block
1.1 downsj 161: using
1.13 aaron 162: .Ar length
1.1 downsj 163: logical blocks.
1.17 aaron 164: .It Ic previous
165: Play the previous track.
166: If we're at the first track, restart.
1.29 jmc 167: .It Ic quit
168: Quit the program.
1.17 aaron 169: .It Ic replay
1.8 angelos 170: Replay the current track again.
1.29 jmc 171: .It Ic reset
172: Perform a hardware reset of the device.
1.17 aaron 173: .It Ic resume
174: Resume playing.
175: Used after the
176: .Ic pause
1.4 deraadt 177: command.
1.29 jmc 178: .It Ic set Ar lba | msf
179: Set LBA
180: .Pq Ar lba
181: or minute-second-frame
182: .Pq Ar msf
183: ioctl mode.
184: The default is minute-second-frame ioctl mode.
185: .It Ic status
186: Print information about the disc:
187: the current playing status and position,
188: the current media catalog status,
189: and the current values of the volume for left and right channels.
1.17 aaron 190: .It Ic stop
1.1 downsj 191: Stop the disc.
1.32 mjc 192: .It Xo Ic tao
1.36 jmc 193: .Op Fl ad
1.32 mjc 194: .Ar trackfile ...
195: .Xc
1.36 jmc 196: .Bq command line only
197: \ \&Write a track-at-once CD containing the specified
198: .Ar trackfile .
199: .Pp
200: The options are as follows:
201: .Bl -tag -width Ds
202: .It Fl a
203: Write files as audio tracks.
204: .It Fl d
205: Write files as data tracks (the default).
206: .El
1.17 aaron 207: .It Ic volume Ar left_channel Ar right_channel
1.14 aaron 208: Set the volume of the left channel to
1.13 aaron 209: .Ar left_channel
1.14 aaron 210: and the volume of the right channel to
211: .Ar right_channel .
1.29 jmc 212: Allowed values are in the range 0\-255.
1.34 jmc 213: .It Xo Ic volume
214: .Ic left \*(Ba
215: .Ic right \*(Ba
216: .Ic mono \*(Ba
217: .Ic stereo \*(Ba
218: .Ic mute
219: .Xc
220: Respectively:
221: play the left subtrack on both left and right channels;
222: play the right subtrack on both left and right channels;
223: set mono mode;
224: set stereo mode;
225: turn the sound off.
1.18 aaron 226: .El
1.1 downsj 227: .Sh FILES
228: .Bl -tag -width /dev/rmcd0c -compact
1.10 mickey 229: .It Pa /dev/rcd0c
230: .It Pa /dev/rmcd0c
1.1 downsj 231: .El
1.28 jmc 232: .Sh SEE ALSO
233: .Xr aucat 1 ,
234: .Xr audioctl 1 ,
235: .Xr mixerctl 1 ,
236: .Xr audio 4
1.1 downsj 237: .Sh HISTORY
238: The
1.14 aaron 239: .Nm
1.1 downsj 240: command is based on
241: .Nm cdcontrol ,
1.22 mpech 242: which first appeared in
243: .Fx 2.1 .
1.27 jmc 244: .Sh AUTHORS
245: Jean-Marc Zucconi,
246: Andrey A. Chernov,
247: Serge V. Vakulenko,
248: Marc Espie