share/man/man4/man4.i386/mcd.4

   1 .\"
   2 .\" Copyright (c) 1994 Keith E. Walker
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. The name of the author may not be used to endorse or promote products
  14 .\"    derived from this software withough specific prior written permission
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  17 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  18 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  19 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  20 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  21 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  22 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  23 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  24 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  25 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  26 .\"
  27 .\" $FreeBSD$
  28 .\"
  29 .Dd December 8, 1994
  30 .Dt MCD 4 i386
  31 .Os FreeBSD 2.0
  32 .Sh NAME
  33 .Nm mcd
  34 .Nd Mitsumi CD-ROM driver
  35 .Sh SYNOPSIS
  36 .Cd "device mcd0 at isa? port 0x300 irq 10"
  37 .Sh DESCRIPTION
  38 The
  39 .Nm mcd
  40 driver provides a data and audio interface to the Mitsumi-brand CD-ROM
  41 player. The CD-ROM player must be interfaced to the ISA bus through
  42 one of the Mitsumi proprietary controller boards. The controller
  43 boards supported are the LU002S, LU005S, the FX001 and the quite
  44 common FX001D.
  45 .Pp
  46 The
  47 .Nm mcd
  48 driver responds to disk-specific
  49 .Fn ioctl
  50 commands, namely the
  51 .Dv DIOCGDINFO ,
  52 .Dv DIOCGPART ,
  53 .Dv DIOCWDINFO ,
  54 and
  55 .Dv DIOCSDINFO ,
  56 commands.
  57 Other disk-specific
  58 .Fn ioctl
  59 commands will return an error.
  60 .Pp
  61 The
  62 .Nm mcd
  63 driver also responds to special CD-ROM
  64 .Fn ioctl
  65 commands. These commands
  66 control the CD-ROM player's audio features.
  67 The commands are:
  68 .Pp
  69 .Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent
  70 .It CDIOCREADSUBCHANNEL
  71 get sub-channel information on current status of disc playing
  72 .It CDIOCREADTOCHEADER
  73 get table of contents header
  74 .It CDIOCREADTOCENTRYS
  75 gets all of the table of contents
  76 .It CDIOCPLAYTRACKS
  77 begins audio playing at location specified
  78 .It CDIOCPLAYBLOCKS
  79 fails with error
  80 .Dv EINVAL
  81 .It CDIOCPLAYMSF
  82 begins audio playing at location specified
  83 .It CDIOCRESUME
  84 resumes playing a previously paused disc
  85 .It CDIOCPAUSE
  86 pauses a playing disc
  87 .It CDIOCSTART
  88 begins playing a disc
  89 .It CDIOCSTOP
  90 stops a previously playing disc
  91 .It CDIOCEJECT
  92 opens the disc tray (there is no support for a corresponding un-eject
  93 command).
  94 .It CDIOCRESET
  95 stops any play and resets the Mitsumi controller board
  96 .It CDIOCSETDEBUG
  97 cause the kernel to print debug messages to the console about the
  98 .Nm mcd
  99 driver
 100 .It CDIOCCLRDEBUG
 101 cause the kernel to quit printing debug messages about the
 102 .Nm mcd
 103 driver
 104 .El
 105 .Pp
 106 The
 107 .Fn ioctl
 108 commands defined above are the only ones that the
 109 .Nm mcd
 110 driver supports. There are other CD-ROM related
 111 .Fn ioctl
 112 commands (such as
 113 .Dv CDIOCSETVOL
 114 and
 115 .Dv CDIOCSETSTERIO )
 116 which are available
 117 and may be supported by future versions of the driver.
 118 .Sh FILES
 119 .Bl -tag -width /dev/(r)mcd0a -compact
 120 .It Pa /dev/(r)mcd0a
 121 accesses BSD partition on the disc.
 122 Normally, there is only
 123 one file system on a CD-ROM disc.
 124 .It Pa /dev/(r)mcd0c
 125 accesses raw device.
 126 .El
 127 .Sh NOTES
 128 The character-mode devices for the
 129 .Nm mcd
 130 driver should only be used for accessing the audio features of the
 131 CD-ROM player as the performance on data is abysmal.
 132 .Pp
 133 The current version of the driver uses neither the DMA or IRQ
 134 features of the interface board, although it has an interrupt handler
 135 for any IRQ requests that are generated. Until the DMA features are
 136 supported, the only interrupts that the board generates are those that
 137 aren't supported by the driver anyway.
 138 .Sh SEE ALSO
 139 .Pa /usr/include/sys/cdio.h
 140 .Sh AUTHORS
 141 The driver was written by
 142 .An Holger Veit
 143 (data part) and
 144 .An Brian Moore
 145 (audio part). Changes were
 146 provided by
 147 .An Gary Clark II ,
 148 .An Andrew A. Chernov ,
 149 and
 150 .An Jordan K. Hubbard .
 151 .Sh HISTORY
 152 An
 153 .Nm mcd
 154 driver appeared in
 155 .Fx 1.0 .