Annotation of src/usr.bin/cdio/cdio.1, Revision 1.17
1.17 ! aaron 1: .\" $OpenBSD: cdio.1,v 1.16 2000/03/05 00:28:52 aaron Exp $
1.1 downsj 2: .Dd July 3, 1995
3: .Dt CDIO 1
1.14 aaron 4: .Os
1.1 downsj 5: .Sh NAME
6: .Nm cdio
7: .Nd compact disc control utility
8: .Sh SYNOPSIS
9: .Nm cdio
10: .Op Fl s
11: .Op Fl v
1.13 aaron 12: .Op Fl f Ar device
13: .Op Ar command args ...
1.1 downsj 14: .Sh DESCRIPTION
1.13 aaron 15: The
1.14 aaron 16: .Nm
1.17 ! aaron 17: program controls audio features of a CD drive.
! 18: The
1.13 aaron 19: .Ar device
20: is a name such
1.14 aaron 21: as
1.17 ! aaron 22: .Dq cd0
1.14 aaron 23: or
24: .Dq mcd0 .
1.1 downsj 25: .Pp
1.13 aaron 26: If a
27: .Ar device
1.14 aaron 28: is not specified, the environment variable
1.1 downsj 29: .Ev DISC
1.13 aaron 30: will be used to find the CD device.
1.1 downsj 31: .Pp
1.13 aaron 32: If no command is given,
1.14 aaron 33: .Nm
1.1 downsj 34: enters an interactive mode, reading commands from the standard input.
35: .Pp
1.16 aaron 36: The options are as follows:
1.1 downsj 37: .Bl -tag -width flag
38: .It Fl s
1.17 ! aaron 39: Silent mode.
! 40: Do not print table headers or human-readable comments.
1.1 downsj 41: .It Fl v
1.17 ! aaron 42: Verbose mode.
! 43: Print as much information as possible.
1.13 aaron 44: .It Fl f Ar device
45: Specifies a device name such as
46: .Pa /dev/rcd0d
47: or
48: .Pa mcd0 .
49: Both absolute and relative paths to
50: .Pa /dev
51: filenames are possible.
1.11 deraadt 52: The raw partition name is added if needed.
1.1 downsj 53: .El
54: .Pp
1.17 ! aaron 55: The available commands are listed below.
! 56: Only as many characters as are required to uniquely identify a command
! 57: need be specified.
! 58: The word
! 59: .Ic play
1.13 aaron 60: may be omitted.
1.17 ! aaron 61: .Bl -tag -width Ic
! 62: .It Ic play Ar first_track Op Ar last_track
1.14 aaron 63: Play from track
64: .Ar first_track
1.1 downsj 65: to track
1.14 aaron 66: .Ar last_track .
1.13 aaron 67: The first track has number 1 and may be omitted in all cases.
1.17 ! aaron 68: .It Ic play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
1.1 downsj 69: Play from the absolute address
1.14 aaron 70: (MSF) defined by
1.13 aaron 71: .Ar start_m
1.14 aaron 72: in minutes,
1.17 ! aaron 73: .Ar start_s
! 74: in seconds, and
1.13 aaron 75: .Ar start_f
1.1 downsj 76: (frame number) to the absolute address defined by
1.13 aaron 77: .Ar end_m
1.14 aaron 78: in minutes,
1.17 ! aaron 79: .Ar end_s
! 80: in seconds, and
1.13 aaron 81: .Ar end_f
1.17 ! aaron 82: (frame number).
! 83: Minutes are in the range 0-99.
! 84: Seconds are in the range 0-59.
1.1 downsj 85: Frame numbers are in the range 0-74.
1.17 ! aaron 86: .It Ic play Op Ar #start_block Op length
1.1 downsj 87: Play starting from the logical block
1.13 aaron 88: .Ar start_block
1.1 downsj 89: using
1.13 aaron 90: .Ar length
1.1 downsj 91: logical blocks.
1.17 ! aaron 92: .It Ic pause
! 93: Stop playing.
! 94: Do not stop the disc.
! 95: .It Ic next
! 96: Play the next track.
! 97: If we're at the last track, stop.
! 98: .It Ic previous
! 99: Play the previous track.
! 100: If we're at the first track, restart.
! 101: .It Ic replay
1.8 angelos 102: Replay the current track again.
1.17 ! aaron 103: .It Ic resume
! 104: Resume playing.
! 105: Used after the
! 106: .Ic pause
1.4 deraadt 107: command.
1.17 ! aaron 108: .It Ic stop
1.1 downsj 109: Stop the disc.
1.17 ! aaron 110: .It Ic eject
1.1 downsj 111: Eject the disc.
1.17 ! aaron 112: .It Ic close
1.1 downsj 113: Inject the disc.
1.17 ! aaron 114: .It Ic volume Ar left_channel Ar right_channel
1.14 aaron 115: Set the volume of the left channel to
1.13 aaron 116: .Ar left_channel
1.14 aaron 117: and the volume of the right channel to
118: .Ar right_channel .
119: Allowed values are in the range 0-255.
1.17 ! aaron 120: .It Ic volume Ar mute
1.1 downsj 121: Turn the sound off.
1.17 ! aaron 122: .It Ic volume Ar mono
1.1 downsj 123: Set the mono mode.
1.17 ! aaron 124: .It Ic volume Ar stereo
1.1 downsj 125: Set the stereo mode.
1.17 ! aaron 126: .It Ic volume Ar left
1.1 downsj 127: Play the left subtrack on both left and right channels.
1.17 ! aaron 128: .It Ic volume Ar right
1.1 downsj 129: Play the right subtrack on both left and right channels.
1.17 ! aaron 130: .It Ic info
1.6 deraadt 131: Print the table of contents.
1.17 ! aaron 132: .It Ic status
1.13 aaron 133: Print information about the disc:
1.1 downsj 134: the current playing status and position,
135: the current media catalog status,
1.17 ! aaron 136: and the current values of the volume for left and right channels.
! 137: .It Ic help
1.1 downsj 138: Print the list of available commands.
1.17 ! aaron 139: .It Ic debug Ar on
1.1 downsj 140: Enable the debugging mode of the CD device driver.
1.17 ! aaron 141: .It Ic debug Ar off
1.1 downsj 142: Disable the driver debugging mode.
1.17 ! aaron 143: .It Ic device Ar devname
1.9 millert 144: Make
145: .Ar devname
1.17 ! aaron 146: the current CD device.
! 147: This is the equivalent of quitting
1.9 millert 148: .Nm
149: and restarting with a different device.
1.17 ! aaron 150: .It Ic reset
1.14 aaron 151: Perform a hardware reset of the device.
1.17 ! aaron 152: .It Ic set Ar msf
1.1 downsj 153: Set minute-second-frame ioctl mode (default).
1.17 ! aaron 154: .It Ic set Ar lba
1.1 downsj 155: Set LBA ioctl mode.
1.17 ! aaron 156: .It Ic quit
1.1 downsj 157: Quit the program.
158: .Sh FILES
159: .Bl -tag -width /dev/rmcd0c -compact
1.10 mickey 160: .It Pa /dev/rcd0c
161: .It Pa /dev/rmcd0c
1.1 downsj 162: .El
163: .Sh AUTHORS
164: Jean-Marc Zucconi,
165: Andrey A.\ Chernov,
166: Serge V.\ Vakulenko
167: .Sh HISTORY
168: The
1.14 aaron 169: .Nm
1.1 downsj 170: command is based on
171: .Nm cdcontrol ,
1.13 aaron 172: which first appeared in FreeBSD 2.1.