usr.sbin/cdcontrol/cdcontrol.1

   1 .\" $FreeBSD$
   2 .\"
   3 .Dd July 3, 1995
   4 .Dt CDCONTROL 1
   5 .Os
   6 .Sh NAME
   7 .Nm cdcontrol
   8 .Nd compact disc control utility
   9 .Sh SYNOPSIS
  10 .Nm
  11 .Op Fl sv
  12 .Op Fl f Ar device
  13 .Op Ar command ...
  14 .Sh DESCRIPTION
  15 .Nm Cdcontrol
  16 is a program to control audio features of a CD drive.
  17 The device is a name such
  18 as
  19 .Pa cd0
  20 or
  21 .Pa mcd0 .
  22 .Pp
  23 If no command is given, then
  24 .Nm
  25 enters an interactive mode, reading commands from the standard input.
  26 .Pp
  27 The following options are available:
  28 .Bl -tag -width indent
  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 device
  34 Specify a device, such as
  35 .Pa /dev/cd0c
  36 or
  37 .Pa mcd0 .
  38 Both absolute path and relative to
  39 .Pa /dev
  40 filename are possible.
  41 Suffix `c' is added to the device name if needed.
  42 .El
  43 .Pp
  44 The available commands are listed below.  Only as many
  45 characters as are required to uniquely identify a command
  46 need be specified.
  47 The word
  48 .Cm play
  49 can be omitted or the characters
  50 .Dq +
  51 and
  52 .Dq -
  53 can be used in the
  54 place of
  55 .Cm next
  56 and
  57 .Cm prev .
  58 .Bl -tag -width Cm
  59 .It Cm play Ar first_track Op Ar last_track
  60 Play from track
  61 .Ar first_track
  62 to track
  63 .Ar last_track .
  64 The first track has number 1.
  65 Can be omitted in all cases.
  66 .It Cm play Xo
  67 .Ar start_m : Ns Ar start_s . Ns Ar start_f
  68 .Oo Ar end_m : Ns Ar end_s . Ns
  69 .Ar end_f Oc
  70 .Xc
  71 Play from the absolute address
  72 (MSF) defined by
  73 .Ar start_m
  74 in minutes,
  75 .Ar start_s ,
  76 in seconds and
  77 .Ar start_f
  78 (frame number) to the absolute address defined by
  79 .Ar end_m
  80 in minutes,
  81 .Ar end_s ,
  82 in seconds and
  83 .Ar end_f
  84 (frame number). Minutes are in the range 0-99.
  85 Seconds are in the range 0-59.
  86 Frame numbers are in the range 0-74.
  87 .It Cm play Op Ar #start_block Op length
  88 Play starting from the logical block
  89 .Ar start_block
  90 using
  91 .Ar length
  92 logical blocks.
  93 .It Cm next Op Ar tracks
  94 Skip forward a number of tracks (default 1).
  95 .It Cm prev Op Ar tracks
  96 Skip backward a number of tracks (default 1).
  97 .It Cm pause
  98 Stop playing.
  99 Do not stop the disc.
 100 .It Cm resume
 101 Resume playing.
 102 Used after the
 103 .Em pause
 104 command.
 105 .It Cm stop
 106 Stop the disc.
 107 .It Cm eject
 108 Eject the disc.
 109 .It Cm close
 110 Inject the disc.
 111 .It Cm volume Ar left_channel Ar right_channel
 112 Set the volume of left channel to
 113 .Ar left_channel
 114 and the volume of right channel to
 115 .Ar right_channel .
 116 Allowed values are in the range 0-255.
 117 .It Cm volume Ar mute
 118 Turn the sound off.
 119 .It Cm volume Ar mono
 120 Set the mono mode.
 121 .It Cm volume Ar stereo
 122 Set the stereo mode.
 123 .It Cm volume Ar left
 124 Play the left subtrack on both left and right channels.
 125 .It Cm volume Ar right
 126 Play the right subtrack on both left and right channels.
 127 .It Cm info
 128 Print the table of contents.
 129 .It Cm status Xo
 130 .Op Ar audio | media | volume
 131 .Xc
 132 Print the information about the disc:
 133 .Pp
 134 .Bl -tag -width "volume" -compact
 135 .It Ar audio
 136 the current playing status and position
 137 .It Ar media
 138 the current media catalog status
 139 .It Ar volume
 140 the current values of the volume for left and right channels.
 141 .El
 142 .It Cm cdid
 143 Display the serial number of the cd using the method used by the
 144 cddb (http://www.cddb.org/) project.
 145 .It Cm help
 146 Print the list of available commands.
 147 .It Cm debug Ar on
 148 Enable the debugging mode of the CD device driver.
 149 .It Cm debug Ar off
 150 Disable the driver debugging mode.
 151 .It Cm reset
 152 Perform the hardware reset of the device.
 153 .It Cm set Ar msf
 154 Set minute-second-frame ioctl mode (default).
 155 .It Cm set Ar lba
 156 Set LBA ioctl mode.
 157 .It Cm quit
 158 Quit the program.
 159 .El
 160 .Sh ENVIRONMENT
 161 The following environment variables affect the execution of
 162 .Nm :
 163 .Pp
 164 .Bl -tag -width CD_DRIVE -compact
 165 .It Ev CDROM
 166 The cd device to use if one isn't specified with the
 167 .Fl f
 168 flag.
 169 .Pp
 170 .It Ev CDPLAY
 171 .It Ev CD_DRIVE
 172 .It Ev DISC
 173 .It Ev MUSIC_CD
 174 These variables have been deprecated in favour of
 175 .Ev CDROM .
 176 .El
 177 .Sh FILES
 178 .Bl -tag -width /dev/mcd0c -compact
 179 .It Pa /dev/cd0c
 180 .It Pa /dev/mcd0c
 181 .It Pa /dev/acd0c
 182 .El
 183 .Sh AUTHORS
 184 .An Jean-Marc Zucconi ,
 185 .An Andrey A.\ Chernov ,
 186 .An Serge V.\ Vakulenko
 187 .Sh HISTORY
 188 The
 189 .Nm
 190 command appeared in
 191 .Fx 2.1 .