[BACK]Return to cdio.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / cdio

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

1.22    ! mpech       1: .\" $OpenBSD: cdio.1,v 1.21 2000/12/24 11:34:09 aaron Exp $
1.21      aaron       2: .\"
1.1       downsj      3: .Dd July 3, 1995
                      4: .Dt CDIO 1
1.14      aaron       5: .Os
1.1       downsj      6: .Sh NAME
                      7: .Nm cdio
1.20      espie       8: .Nd compact disc audio player and control utility
1.1       downsj      9: .Sh SYNOPSIS
                     10: .Nm cdio
1.21      aaron      11: .Op Fl sv
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.19      aaron      37: .Bl -tag -width Ds
1.1       downsj     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.
1.18      aaron     158: .El
1.1       downsj    159: .Sh FILES
                    160: .Bl -tag -width /dev/rmcd0c -compact
1.10      mickey    161: .It Pa /dev/rcd0c
                    162: .It Pa /dev/rmcd0c
1.1       downsj    163: .El
                    164: .Sh AUTHORS
                    165: Jean-Marc Zucconi,
                    166: Andrey A.\ Chernov,
                    167: Serge V.\ Vakulenko
                    168: .Sh HISTORY
                    169: The
1.14      aaron     170: .Nm
1.1       downsj    171: command is based on
                    172: .Nm cdcontrol ,
1.22    ! mpech     173: which first appeared in
        !           174: .Fx 2.1 .