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