1.\" $NetBSD: cdplay.1,v 1.8 2000/09/18 16:47:11 abs Exp $ 2.\" 3.\" Copyright (c) 1999, 2000 Andrew Doran. 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.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 16.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 17.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 18.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 19.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 20.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 21.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 23.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 24.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 25.\" SUCH DAMAGE. 26.\" 27.\" from FreeBSD: cdcontrol.1,v 1.16.2.2 1999/01/31 15:36:01 billf Exp 28.\" 29.Dd Sep 18, 2000 30.Dt CDPLAY 1 31.Os NetBSD 1.5 32.Sh NAME 33.Nm cdplay 34.Nd compact disc player 35.Sh SYNOPSIS 36.Nm cdplay 37.Op Fl f Ar device 38.Op Ar command ... 39.Sh DESCRIPTION 40.Nm 41is a program to control audio features of a CD drive. 42.Pp 43If no command is given, then 44.Nm 45enters interactive mode, reading commands from the standard input. 46.Pp 47The following options are available: 48.Bl -tag -width indent 49.It Fl f Ar device 50Specify the control device. Both absolute paths and paths relative to 51.Pa /dev 52are accepted. The suffix `c' (or 'd' on some architectures, see 53.Xr disklabel 8 54for details) is added to the 55device name if needed. If the device not specified, the environment variables 56.Ev MUSIC_CD , 57.Ev CD_DRIVE , 58.Ev DISC 59and 60.Ev CDPLAY 61will be tried (in this order) to find the device. 62.El 63.Pp 64The available commands are listed below. Only as many 65characters as are required to uniquely identify a command 66need be specified. The word 67.Em play 68can be omitted in all cases. 69.Bl -tag -width Cm 70.It Cm play Op Ar first_track Op Ar last_track 71Play from track 72.Ar first_track 73to track 74.Ar last_track . 75The first track has number 1. 76.It Cm play Op Ar start_m:start_s.start_f Op Ar end_m:end_s.end_f 77Play from the absolute address 78(MSF) defined by 79.Ar start_m 80in minutes, 81.Ar start_s , 82in seconds and 83.Ar start_f 84(frame number) to the absolute address defined by 85.Ar end_m 86in minutes, 87.Ar end_s , 88in seconds and 89.Ar end_f 90(frame number). Minutes are in the range 0-99. Seconds are in the range 0-59. 91Frame numbers are in the range 0-74. 92.It Cm play Op Ar #start_block Op length 93Play starting from the logical block 94.Ar start_block 95using 96.Ar length 97logical blocks. 98.It Cm pause 99Stop playing. Do not stop the disc. 100.It Cm resume 101Resume playing. Used after the 102.Em pause 103command. 104.It Cm stop 105Stop the disc. 106.It Cm eject 107Eject the disc. 108.It Cm close 109Inject the disc. 110.It Cm volume Ar left_channel Ar right_channel 111Set the volume of left channel to 112.Ar left_channel 113and the volume of right channel to 114.Ar right_channel . 115Allowed values are in the range 0-255. 116.It Cm volume Ar value 117Set the volume of both left channel right channel to 118.Ar value . 119Allowed values are in the range 0-255. 120.It Cm volume mute 121Turn the sound off. 122.It Cm volume mono 123Set the mono mode. 124.It Cm volume stereo 125Set the stereo mode. 126.It Cm volume left 127Play the left subtrack on both left and right channels. 128.It Cm volume right 129Play the right subtrack on both left and right channels. 130.It Cm info 131Print the table of contents. 132.It Cm status 133.Op audio | media | volume 134 135Print the information about the disc: 136 137.Nm audio 138the current playing status and position, 139 140.Nm media 141the current media catalog status, 142 143.Nm volume 144the current values of the volume for left and right channels. 145.It Cm help 146Print the list of available commands. 147.It Cm reset 148Perform the hardware reset of the device. 149.It Cm set msf 150Set minute-second-frame ioctl mode (default). 151.It Cm set lba 152Set LBA ioctl mode. 153.It Cm quit 154Quit the program. 155.El 156.Sh FILES 157.Bl -tag -width /dev/rmcd0c -compact 158.It Pa /dev/cd?? 159.It Pa /dev/mcd?? 160.El 161.Sh SEE ALSO 162.Xr disklabel 8 163.Sh AUTHORS 164.An Jean-Marc Zucconi , 165.An Andrey A.\ Chernov , 166.An Serge V.\ Vakulenko , 167.An Andy Doran 168.Sh HISTORY 169The 170.Nm 171command first appeared in 172.Nx 1.5 . 173