Return to cdio.1 CVS log

Up to [local] / src / usr.bin / cdio

Annotation of src/usr.bin/cdio/cdio.1, Revision 1.5

1.5     ! etheisen    1: .\" $OpenBSD: cdio.1,v 1.4 1996/08/26 08:22:00 deraadt Exp $
1.1       downsj      2: .Dd July 3, 1995
                      3: .Dt CDIO 1
1.5     ! etheisen    4: .Os OpenBSD 2.0
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
                     12: .Op Fl f Ar discname
                     13: .Op Ar command args...
                     14: .Sh DESCRIPTION
                     15: .Nm cdio
                     16: is a program to control audio features of a CD drive. The device is a name such
1.2       deraadt    17: as cd0, acd0, or mcd0
1.1       downsj     18: .Pp
1.2       deraadt    19: If the device is not specified, the environment variable
1.1       downsj     20: .Ev DISC
                     21: will be used to find the cd device.
                     22: .Pp
                     23: If no command is given, then
                     24: .Nm cdio
                     25: enters an interactive mode, reading commands from the standard input.
                     26: .Pp
                     27: The following options are available:
                     28: .Bl -tag -width flag
                     29: .It Fl s
                     30: Silent mode - do not print table headers and human readable comments.
                     31: .It Fl v
                     32: Verbose mode - print as much information as possible.
                     33: .It Fl f Ar discname
                     34: Specifies a device name, such as /dev/rcd0d or mcd0.
                     35: Both absolute path and relative to /dev filename are possible.
                     36: The raw parition name is added if needed.
                     37: .El
                     38: .Pp
                     39: The available commands are listed below.  Only as many
                     40: characters as are required to uniquely identify a command
                     41: need be specified. Word
                     42: .Nm play
                     43: can be ommitted.
                     44: .Bl -tag -width Cm
                     45: .It Cm play Ar first_track Op Ar last_track
                     46: Play from track
                     47: .Nm first_track
                     48: to track
                     49: .Nm last_track.
                     50: The first track has number 1.
                     51: can be ommited in all cases.
                     52: .It Cm play Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f
                     53: Play from the absolute address
                     54: (MSF) defined by
                     55: .Nm start_m
                     56: in minutes,
                     57: .Nm start_s,
                     58: in seconds and
                     59: .Nm start_f
                     60: (frame number) to the absolute address defined by
                     61: .Nm end_m
                     62: in minutes,
                     63: .Nm end_s,
                     64: in seconds and
                     65: .Nm end_f
                     66: (frame number). Minutes are in the range 0-99. Seconds are in the range 0-59.
                     67: Frame numbers are in the range 0-74.
                     68: .It Cm play Op Ar #start_block Op length
                     69: Play starting from the logical block
                     70: .Nm start_block
                     71: using
                     72: .Nm length
                     73: logical blocks.
                     74: .It Cm pause
                     75: Stop playing. Do not stop the disc.
                     76: .It Cm resume
1.4       deraadt    77: Resume playing. Used after the
1.1       downsj     78: .Nm pause
1.4       deraadt    79: command.
1.1       downsj     80: .It Cm stop
                     81: Stop the disc.
                     82: .It Cm eject
                     83: Eject the disc.
                     84: .It Cm close
                     85: Inject the disc.
                     86: .It Cm volume Ar left_channel Ar right_channel
                     87: Set the volume of left channel to
                     88: .Nm left_channel
                     89: and the volume of right channel to
                     90: .Nm right_channel.
                     91: Allowed values are in the range 0-255.
                     92: .It Cm volume Ar mute
                     93: Turn the sound off.
                     94: .It Cm volume Ar mono
                     95: Set the mono mode.
                     96: .It Cm volume Ar stereo
                     97: Set the stereo mode.
                     98: .It Cm volume Ar left
                     99: Play the left subtrack on both left and right channels.
                    100: .It Cm volume Ar right
                    101: Play the right subtrack on both left and right channels.
                    102: .It Cm info
                    103: Print the the table of contents.
                    104: .It Cm status
                    105: Print the information about the disc:
                    106: the current playing status and position,
                    107: the current media catalog status,
                    108: the current values of the volume for left and right channels.
                    109: .It Cm help
                    110: Print the list of available commands.
                    111: .It Cm debug Ar on
                    112: Enable the debugging mode of the CD device driver.
                    113: .It Cm debug Ar off
                    114: Disable the driver debugging mode.
                    115: .It Cm reset
                    116: Perform the hardware reset of the device.
                    117: .It Cm set Ar msf
                    118: Set minute-second-frame ioctl mode (default).
                    119: .It Cm set Ar lba
                    120: Set LBA ioctl mode.
                    121: .It Cm quit
                    122: Quit the program.
                    123: .Sh FILES
                    124: .Bl -tag -width /dev/rmcd0c -compact
                    125: .It Pa /dev/rcd0d
                    126: .It Pa /dev/racd0d
                    127: .It Pa /dev/rmcd0d
                    128: .El
                    129: .Sh AUTHORS
                    130: Jean-Marc Zucconi,
                    131: Andrey A.\ Chernov,
                    132: Serge V.\ Vakulenko
                    133: .Sh HISTORY
                    134: The
                    135: .Nm cdio
                    136: command is based on
                    137: .Nm cdcontrol ,
                    138: which first appeared in FreeBSD 2.1