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.
  42 The CD-ROM player must be interfaced to the ISA bus through
  43 one of the Mitsumi proprietary controller boards.
  44 The controller
  45 boards supported are the LU002S, LU005S, the FX001 and the quite
  46 common FX001D.
  47 .Pp
  48 The
  49 .Nm mcd
  50 driver responds to disk-specific
  51 .Fn ioctl
  52 commands, namely the
  53 .Dv DIOCGDINFO ,
  54 .Dv DIOCGPART ,
  55 .Dv DIOCWDINFO ,
  56 and
  57 .Dv DIOCSDINFO ,
  58 commands.
  59 Other disk-specific
  60 .Fn ioctl
  61 commands will return an error.
  62 .Pp
  63 The
  64 .Nm mcd
  65 driver also responds to special CD-ROM
  66 .Fn ioctl
  67 commands.
  68 These commands
  69 control the CD-ROM player's audio features.
  70 The commands are:
  71 .Pp
  72 .Bl -tag -width CDIOCREADSUBCHANNEL -compact -offset indent
  73 .It CDIOCREADSUBCHANNEL
  74 get sub-channel information on current status of disc playing
  75 .It CDIOCREADTOCHEADER
  76 get table of contents header
  77 .It CDIOCREADTOCENTRYS
  78 gets all of the table of contents
  79 .It CDIOCPLAYTRACKS
  80 begins audio playing at location specified
  81 .It CDIOCPLAYBLOCKS
  82 fails with error
  83 .Dv EINVAL
  84 .It CDIOCPLAYMSF
  85 begins audio playing at location specified
  86 .It CDIOCRESUME
  87 resumes playing a previously paused disc
  88 .It CDIOCPAUSE
  89 pauses a playing disc
  90 .It CDIOCSTART
  91 begins playing a disc
  92 .It CDIOCSTOP
  93 stops a previously playing disc
  94 .It CDIOCEJECT
  95 opens the disc tray (there is no support for a corresponding un-eject
  96 command).
  97 .It CDIOCRESET
  98 stops any play and resets the Mitsumi controller board
  99 .It CDIOCSETDEBUG
 100 cause the kernel to print debug messages to the console about the
 101 .Nm mcd
 102 driver
 103 .It CDIOCCLRDEBUG
 104 cause the kernel to quit printing debug messages about the
 105 .Nm mcd
 106 driver
 107 .El
 108 .Pp
 109 The
 110 .Fn ioctl
 111 commands defined above are the only ones that the
 112 .Nm mcd
 113 driver supports.
 114 There are other CD-ROM related
 115 .Fn ioctl
 116 commands (such as
 117 .Dv CDIOCSETVOL
 118 and
 119 .Dv CDIOCSETSTERIO )
 120 which are available
 121 and may be supported by future versions of the driver.
 122 .Sh FILES
 123 .Bl -tag -width /dev/(r)mcd0a -compact
 124 .It Pa /dev/(r)mcd0a
 125 accesses BSD partition on the disc.
 126 Normally, there is only
 127 one file system on a CD-ROM disc.
 128 .It Pa /dev/(r)mcd0c
 129 accesses raw device.
 130 .El
 131 .Sh NOTES
 132 The character-mode devices for the
 133 .Nm mcd
 134 driver should only be used for accessing the audio features of the
 135 CD-ROM player as the performance on data is abysmal.
 136 .Pp
 137 The current version of the driver uses neither the DMA or IRQ
 138 features of the interface board, although it has an interrupt handler
 139 for any IRQ requests that are generated.
 140 Until the DMA features are
 141 supported, the only interrupts that the board generates are those that
 142 aren't supported by the driver anyway.
 143 .Sh SEE ALSO
 144 .Pa /usr/include/sys/cdio.h
 145 .Sh AUTHORS
 146 The driver was written by
 147 .An Holger Veit
 148 (data part) and
 149 .An Brian Moore
 150 (audio part). Changes were
 151 provided by
 152 .An Gary Clark II ,
 153 .An Andrew A. Chernov ,
 154 and
 155 .An Jordan K. Hubbard .
 156 .Sh HISTORY
 157 An
 158 .Nm mcd
 159 driver appeared in
 160 .Fx 1.0 .