Annotation of src/usr.bin/cdio/cdio.1, Revision 1.27
1.27 ! jmc 1: .\" $OpenBSD: cdio.1,v 1.26 2003/02/18 09:42:33 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.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.23 espie 41: .Op Fl d Ar host:port
1.13 aaron 42: .Op Fl f Ar device
43: .Op Ar command args ...
1.1 downsj 44: .Sh DESCRIPTION
1.13 aaron 45: The
1.14 aaron 46: .Nm
1.17 aaron 47: program controls audio features of a CD drive.
48: The
1.13 aaron 49: .Ar device
50: is a name such
1.14 aaron 51: as
1.17 aaron 52: .Dq cd0
1.14 aaron 53: or
54: .Dq mcd0 .
1.1 downsj 55: .Pp
1.13 aaron 56: If a
57: .Ar device
1.14 aaron 58: is not specified, the environment variable
1.1 downsj 59: .Ev DISC
1.13 aaron 60: will be used to find the CD device.
1.1 downsj 61: .Pp
1.13 aaron 62: If no command is given,
1.14 aaron 63: .Nm
1.1 downsj 64: enters an interactive mode, reading commands from the standard input.
65: .Pp
1.16 aaron 66: The options are as follows:
1.19 aaron 67: .Bl -tag -width Ds
1.1 downsj 68: .It Fl s
1.17 aaron 69: Silent mode.
70: Do not print table headers or human-readable comments.
1.1 downsj 71: .It Fl v
1.17 aaron 72: Verbose mode.
73: Print as much information as possible.
1.23 espie 74: .It Fl d Ar host:port
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.1 downsj 85: .El
86: .Pp
1.17 aaron 87: The available commands are listed below.
88: Only as many characters as are required to uniquely identify a command
89: need be specified.
90: The word
91: .Ic play
1.13 aaron 92: may be omitted.
1.17 aaron 93: .Bl -tag -width Ic
94: .It Ic play Ar first_track Op Ar last_track
1.14 aaron 95: Play from track
96: .Ar first_track
1.1 downsj 97: to track
1.14 aaron 98: .Ar last_track .
1.13 aaron 99: The first track has number 1 and may be omitted in all cases.
1.17 aaron 100: .It Ic play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
1.1 downsj 101: Play from the absolute address
1.14 aaron 102: (MSF) defined by
1.13 aaron 103: .Ar start_m
1.14 aaron 104: in minutes,
1.17 aaron 105: .Ar start_s
106: in seconds, and
1.13 aaron 107: .Ar start_f
1.1 downsj 108: (frame number) to the absolute address defined by
1.13 aaron 109: .Ar end_m
1.14 aaron 110: in minutes,
1.17 aaron 111: .Ar end_s
112: in seconds, and
1.13 aaron 113: .Ar end_f
1.17 aaron 114: (frame number).
115: Minutes are in the range 0-99.
116: Seconds are in the range 0-59.
1.1 downsj 117: Frame numbers are in the range 0-74.
1.17 aaron 118: .It Ic play Op Ar #start_block Op length
1.1 downsj 119: Play starting from the logical block
1.13 aaron 120: .Ar start_block
1.1 downsj 121: using
1.13 aaron 122: .Ar length
1.1 downsj 123: logical blocks.
1.17 aaron 124: .It Ic pause
125: Stop playing.
126: Do not stop the disc.
127: .It Ic next
128: Play the next track.
129: If we're at the last track, stop.
130: .It Ic previous
131: Play the previous track.
132: If we're at the first track, restart.
133: .It Ic replay
1.8 angelos 134: Replay the current track again.
1.17 aaron 135: .It Ic resume
136: Resume playing.
137: Used after the
138: .Ic pause
1.4 deraadt 139: command.
1.17 aaron 140: .It Ic stop
1.1 downsj 141: Stop the disc.
1.17 aaron 142: .It Ic eject
1.1 downsj 143: Eject the disc.
1.17 aaron 144: .It Ic close
1.1 downsj 145: Inject the disc.
1.17 aaron 146: .It Ic volume Ar left_channel Ar right_channel
1.14 aaron 147: Set the volume of the left channel to
1.13 aaron 148: .Ar left_channel
1.14 aaron 149: and the volume of the right channel to
150: .Ar right_channel .
151: Allowed values are in the range 0-255.
1.17 aaron 152: .It Ic volume Ar mute
1.1 downsj 153: Turn the sound off.
1.17 aaron 154: .It Ic volume Ar mono
1.1 downsj 155: Set the mono mode.
1.17 aaron 156: .It Ic volume Ar stereo
1.1 downsj 157: Set the stereo mode.
1.17 aaron 158: .It Ic volume Ar left
1.1 downsj 159: Play the left subtrack on both left and right channels.
1.17 aaron 160: .It Ic volume Ar right
1.1 downsj 161: Play the right subtrack on both left and right channels.
1.17 aaron 162: .It Ic info
1.6 deraadt 163: Print the table of contents.
1.23 espie 164: .It Ic cddb Op Ar n
165: Print the table of contents after matching the disc with the cddb.
166: In case of multiple matches, reissue the command with
167: .Ar n
1.25 fgsch 168: .It Ic cdid
169: Print the disc id that will be used for matching with the cddb.
1.17 aaron 170: .It Ic status
1.13 aaron 171: Print information about the disc:
1.1 downsj 172: the current playing status and position,
173: the current media catalog status,
1.17 aaron 174: and the current values of the volume for left and right channels.
175: .It Ic help
1.1 downsj 176: Print the list of available commands.
1.17 aaron 177: .It Ic debug Ar on
1.1 downsj 178: Enable the debugging mode of the CD device driver.
1.17 aaron 179: .It Ic debug Ar off
1.1 downsj 180: Disable the driver debugging mode.
1.17 aaron 181: .It Ic device Ar devname
1.9 millert 182: Make
183: .Ar devname
1.17 aaron 184: the current CD device.
185: This is the equivalent of quitting
1.9 millert 186: .Nm
187: and restarting with a different device.
1.17 aaron 188: .It Ic reset
1.14 aaron 189: Perform a hardware reset of the device.
1.17 aaron 190: .It Ic set Ar msf
1.1 downsj 191: Set minute-second-frame ioctl mode (default).
1.17 aaron 192: .It Ic set Ar lba
1.1 downsj 193: Set LBA ioctl mode.
1.17 aaron 194: .It Ic quit
1.1 downsj 195: Quit the program.
1.18 aaron 196: .El
1.1 downsj 197: .Sh FILES
198: .Bl -tag -width /dev/rmcd0c -compact
1.10 mickey 199: .It Pa /dev/rcd0c
200: .It Pa /dev/rmcd0c
1.1 downsj 201: .El
202: .Sh HISTORY
203: The
1.14 aaron 204: .Nm
1.1 downsj 205: command is based on
206: .Nm cdcontrol ,
1.22 mpech 207: which first appeared in
208: .Fx 2.1 .
1.27 ! jmc 209: .Sh AUTHORS
! 210: Jean-Marc Zucconi,
! 211: Andrey A. Chernov,
! 212: Serge V. Vakulenko,
! 213: Marc Espie