1/*
2 * 1.00  Oct 31, 1994 -- Initial version.
3 * 1.01  Nov  2, 1994 -- Fixed problem with starting request in
4 *                       cdrom_check_status.
5 * 1.03  Nov 25, 1994 -- leaving unmask_intr[] as a user-setting (as for disks)
6 * (from mlord)       -- minor changes to cdrom_setup()
7 *                    -- renamed ide_dev_s to ide_drive_t, enable irq on command
8 * 2.00  Nov 27, 1994 -- Generalize packet command interface;
9 *                       add audio ioctls.
10 * 2.01  Dec  3, 1994 -- Rework packet command interface to handle devices
11 *                       which send an interrupt when ready for a command.
12 * 2.02  Dec 11, 1994 -- Cache the TOC in the driver.
13 *                       Don't use SCMD_PLAYAUDIO_TI; it's not included
14 *                       in the current version of ATAPI.
15 *                       Try to use LBA instead of track or MSF addressing
16 *                       when possible.
17 *                       Don't wait for READY_STAT.
18 * 2.03  Jan 10, 1995 -- Rewrite block read routines to handle block sizes
19 *                       other than 2k and to move multiple sectors in a
20 *                       single transaction.
21 * 2.04  Apr 21, 1995 -- Add work-around for Creative Labs CD220E drives.
22 *                       Thanks to Nick Saw <cwsaw@pts7.pts.mot.com> for
23 *                       help in figuring this out.  Ditto for Acer and
24 *                       Aztech drives, which seem to have the same problem.
25 * 2.04b May 30, 1995 -- Fix to match changes in ide.c version 3.16 -ml
26 * 2.05  Jun  8, 1995 -- Don't attempt to retry after an illegal request
27 *                        or data protect error.
28 *                       Use HWIF and DEV_HWIF macros as in ide.c.
29 *                       Always try to do a request_sense after
30 *                        a failed command.
31 *                       Include an option to give textual descriptions
32 *                        of ATAPI errors.
33 *                       Fix a bug in handling the sector cache which
34 *                        showed up if the drive returned data in 512 byte
35 *                        blocks (like Pioneer drives).  Thanks to
36 *                        Richard Hirst <srh@gpt.co.uk> for diagnosing this.
37 *                       Properly supply the page number field in the
38 *                        MODE_SELECT command.
39 *                       PLAYAUDIO12 is broken on the Aztech; work around it.
40 * 2.05x Aug 11, 1995 -- lots of data structure renaming/restructuring in ide.c
41 *                       (my apologies to Scott, but now ide-cd.c is independent)
42 * 3.00  Aug 22, 1995 -- Implement CDROMMULTISESSION ioctl.
43 *                       Implement CDROMREADAUDIO ioctl (UNTESTED).
44 *                       Use input_ide_data() and output_ide_data().
45 *                       Add door locking.
46 *                       Fix usage count leak in cdrom_open, which happened
47 *                        when a read-write mount was attempted.
48 *                       Try to load the disk on open.
49 *                       Implement CDROMEJECT_SW ioctl (off by default).
50 *                       Read total cdrom capacity during open.
51 *                       Rearrange logic in cdrom_decode_status.  Issue
52 *                        request sense commands for failed packet commands
53 *                        from here instead of from cdrom_queue_packet_command.
54 *                        Fix a race condition in retrieving error information.
55 *                       Suppress printing normal unit attention errors and
56 *                        some drive not ready errors.
57 *                       Implement CDROMVOLREAD ioctl.
58 *                       Implement CDROMREADMODE1/2 ioctls.
59 *                       Fix race condition in setting up interrupt handlers
60 *                        when the `serialize' option is used.
61 * 3.01  Sep  2, 1995 -- Fix ordering of reenabling interrupts in
62 *                        cdrom_queue_request.
63 *                       Another try at using ide_[input,output]_data.
64 * 3.02  Sep 16, 1995 -- Stick total disk capacity in partition table as well.
65 *                       Make VERBOSE_IDE_CD_ERRORS dump failed command again.
66 *                       Dump out more information for ILLEGAL REQUEST errs.
67 *                       Fix handling of errors occurring before the
68 *                        packet command is transferred.
69 *                       Fix transfers with odd bytelengths.
70 * 3.03  Oct 27, 1995 -- Some Creative drives have an id of just `CD'.
71 *                       `DCI-2S10' drives are broken too.
72 * 3.04  Nov 20, 1995 -- So are Vertos drives.
73 * 3.05  Dec  1, 1995 -- Changes to go with overhaul of ide.c and ide-tape.c
74 * 3.06  Dec 16, 1995 -- Add support needed for partitions.
75 *                       More workarounds for Vertos bugs (based on patches
76 *                        from Holger Dietze <dietze@aix520.informatik.uni-leipzig.de>).
77 *                       Try to eliminate byteorder assumptions.
78 *                       Use atapi_cdrom_subchnl struct definition.
79 *                       Add STANDARD_ATAPI compilation option.
80 * 3.07  Jan 29, 1996 -- More twiddling for broken drives: Sony 55D,
81 *                        Vertos 300.
82 *                       Add NO_DOOR_LOCKING configuration option.
83 *                       Handle drive_cmd requests w/NULL args (for hdparm -t).
84 *                       Work around sporadic Sony55e audio play problem.
85 * 3.07a Feb 11, 1996 -- check drive->id for NULL before dereferencing, to fix
86 *                        problem with "hde=cdrom" with no drive present.  -ml
87 * 3.08  Mar  6, 1996 -- More Vertos workarounds.
88 * 3.09  Apr  5, 1996 -- Add CDROMCLOSETRAY ioctl.
89 *                       Switch to using MSF addressing for audio commands.
90 *                       Reformat to match kernel tabbing style.
91 *                       Add CDROM_GET_UPC ioctl.
92 * 3.10  Apr 10, 1996 -- Fix compilation error with STANDARD_ATAPI.
93 * 3.11  Apr 29, 1996 -- Patch from Heiko Eißfeldt <heiko@colossus.escape.de>
94 *                       to remove redundant verify_area calls.
95 * 3.12  May  7, 1996 -- Rudimentary changer support.  Based on patches
96 *                        from Gerhard Zuber <zuber@berlin.snafu.de>.
97 *                       Let open succeed even if there's no loaded disc.
98 * 3.13  May 19, 1996 -- Fixes for changer code.
99 * 3.14  May 29, 1996 -- Add work-around for Vertos 600.
100 *                        (From Hennus Bergman <hennus@sky.ow.nl>.)
101 * 3.15  July 2, 1996 -- Added support for Sanyo 3 CD changers
102 *                        from Ben Galliart <bgallia@luc.edu> with
103 *                        special help from Jeff Lightfoot
104 *                        <jeffml@pobox.com>
105 * 3.15a July 9, 1996 -- Improved Sanyo 3 CD changer identification
106 * 3.16  Jul 28, 1996 -- Fix from Gadi to reduce kernel stack usage for ioctl.
107 * 3.17  Sep 17, 1996 -- Tweak audio reads for some drives.
108 *                       Start changing CDROMLOADFROMSLOT to CDROM_SELECT_DISC.
109 * 3.18  Oct 31, 1996 -- Added module and DMA support.
110 *
111 * 4.00  Nov 5, 1996   -- New ide-cd maintainer,
112 *                                 Erik B. Andersen <andersee@debian.org>
113 *                     -- Newer Creative drives don't always set the error
114 *                          register correctly.  Make sure we see media changes
115 *                          regardless.
116 *                     -- Integrate with generic cdrom driver.
117 *                     -- CDROMGETSPINDOWN and CDROMSETSPINDOWN ioctls, based on
118 *                          a patch from Ciro Cattuto <>.
119 *                     -- Call set_device_ro.
120 *                     -- Implement CDROMMECHANISMSTATUS and CDROMSLOTTABLE
121 *                          ioctls, based on patch by Erik Andersen
122 *                     -- Add some probes of drive capability during setup.
123 *
124 * 4.01  Nov 11, 1996  -- Split into ide-cd.c and ide-cd.h
125 *                     -- Removed CDROMMECHANISMSTATUS and CDROMSLOTTABLE
126 *                          ioctls in favor of a generalized approach
127 *                          using the generic cdrom driver.
128 *                     -- Fully integrated with the 2.1.X kernel.
129 *                     -- Other stuff that I forgot (lots of changes)
130 *
131 * 4.02  Dec 01, 1996  -- Applied patch from Gadi Oxman <gadio@netvision.net.il>
132 *                          to fix the drive door locking problems.
133 *
134 * 4.03  Dec 04, 1996  -- Added DSC overlap support.
135 * 4.04  Dec 29, 1996  -- Added CDROMREADRAW ioclt based on patch
136 *                          by Ales Makarov (xmakarov@sun.felk.cvut.cz)
137 *
138 * 4.05  Nov 20, 1997  -- Modified to print more drive info on init
139 *                        Minor other changes
140 *                        Fix errors on CDROMSTOP (If you have a "Dolphin",
141 *                          you must define IHAVEADOLPHIN)
142 *                        Added identifier so new Sanyo CD-changer works
143 *                        Better detection if door locking isn't supported
144 *
145 * 4.06  Dec 17, 1997  -- fixed endless "tray open" messages  -ml
146 * 4.07  Dec 17, 1997  -- fallback to set pc->stat on "tray open"
147 * 4.08  Dec 18, 1997  -- spew less noise when tray is empty
148 *                     -- fix speed display for ACER 24X, 18X
149 * 4.09  Jan 04, 1998  -- fix handling of the last block so we return
150 *                         an end of file instead of an I/O error (Gadi)
151 * 4.10  Jan 24, 1998  -- fixed a bug so now changers can change to a new
152 *                         slot when there is no disc in the current slot.
153 *                     -- Fixed a memory leak where info->changer_info was
154 *                         malloc'ed but never free'd when closing the device.
155 *                     -- Cleaned up the global namespace a bit by making more
156 *                         functions static that should already have been.
157 * 4.11  Mar 12, 1998  -- Added support for the CDROM_SELECT_SPEED ioctl
158 *                         based on a patch for 2.0.33 by Jelle Foks
159 *                         <jelle@scintilla.utwente.nl>, a patch for 2.0.33
160 *                         by Toni Giorgino <toni@pcape2.pi.infn.it>, the SCSI
161 *                         version, and my own efforts.  -erik
162 *                     -- Fixed a stupid bug which egcs was kind enough to
163 *                         inform me of where "Illegal mode for this track"
164 *                         was never returned due to a comparison on data
165 *                         types of limited range.
166 * 4.12  Mar 29, 1998  -- Fixed bug in CDROM_SELECT_SPEED so write speed is
167 *                         now set ionly for CD-R and CD-RW drives.  I had
168 *                         removed this support because it produced errors.
169 *                         It produced errors _only_ for non-writers. duh.
170 * 4.13  May 05, 1998  -- Suppress useless "in progress of becoming ready"
171 *                         messages, since this is not an error.
172 *                     -- Change error messages to be const
173 *                     -- Remove a "\t" which looks ugly in the syslogs
174 * 4.14  July 17, 1998 -- Change to pointing to .ps version of ATAPI spec
175 *                         since the .pdf version doesn't seem to work...
176 *                     -- Updated the TODO list to something more current.
177 *
178 * 4.15  Aug 25, 1998  -- Updated ide-cd.h to respect machine endianness,
179 *                         patch thanks to "Eddie C. Dost" <ecd@skynet.be>
180 *
181 * 4.50  Oct 19, 1998  -- New maintainers!
182 *                         Jens Axboe <axboe@image.dk>
183 *                         Chris Zwilling <chris@cloudnet.com>
184 *
185 * 4.51  Dec 23, 1998  -- Jens Axboe <axboe@image.dk>
186 *                      - ide_cdrom_reset enabled since the ide subsystem
187 *                         handles resets fine now. <axboe@image.dk>
188 *                      - Transfer size fix for Samsung CD-ROMs, thanks to
189 *                        "Ville Hallik" <ville.hallik@mail.ee>.
190 *                      - other minor stuff.
191 *
192 * 4.52  Jan 19, 1999  -- Jens Axboe <axboe@image.dk>
193 *                      - Detect DVD-ROM/RAM drives
194 *
195 * 4.53  Feb 22, 1999   - Include other model Samsung and one Goldstar
196 *                         drive in transfer size limit.
197 *                      - Fix the I/O error when doing eject without a medium
198 *                         loaded on some drives.
199 *                      - CDROMREADMODE2 is now implemented through
200 *                         CDROMREADRAW, since many drives don't support
201 *                         MODE2 (even though ATAPI 2.6 says they must).
202 *                      - Added ignore parameter to ide-cd (as a module), eg
203 *                         	insmod ide-cd ignore='hda hdb'
204 *                         Useful when using ide-cd in conjunction with
205 *                         ide-scsi. TODO: non-modular way of doing the
206 *                         same.
207 *
208 * 4.54  Aug 5, 1999	- Support for MMC2 class commands through the generic
209 *			  packet interface to cdrom.c.
210 *			- Unified audio ioctl support, most of it.
211 *			- cleaned up various deprecated verify_area().
212 *			- Added ide_cdrom_packet() as the interface for
213 *			  the Uniform generic_packet().
214 *			- bunch of other stuff, will fill in logs later.
215 *			- report 1 slot for non-changers, like the other
216 *			  cd-rom drivers. don't report select disc for
217 *			  non-changers as well.
218 *			- mask out audio playing, if the device can't do it.
219 *
220 * 4.55  Sep 1, 1999	- Eliminated the rest of the audio ioctls, except
221 *			  for CDROMREADTOC[ENTRY|HEADER]. Some of the drivers
222 *			  use this independently of the actual audio handling.
223 *			  They will disappear later when I get the time to
224 *			  do it cleanly.
225 *			- Minimize the TOC reading - only do it when we
226 *			  know a media change has occurred.
227 *			- Moved all the CDROMREADx ioctls to the Uniform layer.
228 *			- Heiko Eißfeldt <heiko@colossus.escape.de> supplied
229 *			  some fixes for CDI.
230 *			- CD-ROM leaving door locked fix from Andries
231 *			  Brouwer <Andries.Brouwer@cwi.nl>
232 *			- Erik Andersen <andersen@xmission.com> unified
233 *			  commands across the various drivers and how
234 *			  sense errors are handled.
235 *
236 * 4.56  Sep 12, 1999	- Removed changer support - it is now in the
237 *			  Uniform layer.
238 *			- Added partition based multisession handling.
239 *			- Mode sense and mode select moved to the
240 *			  Uniform layer.
241 *			- Fixed a problem with WPI CDS-32X drive - it
242 *			  failed the capabilities
243 *
244 * 4.57  Apr 7, 2000	- Fixed sense reporting.
245 *			- Fixed possible oops in ide_cdrom_get_last_session()
246 *			- Fix locking mania and make ide_cdrom_reset relock
247 *			- Stop spewing errors to log when magicdev polls with
248 *			  TEST_UNIT_READY on some drives.
249 *			- Various fixes from Tobias Ringstrom:
250 *			  tray if it was locked prior to the reset.
251 *			  - cdrom_read_capacity returns one frame too little.
252 *			  - Fix real capacity reporting.
253 *
254 * 4.58  May 1, 2000	- Clean up ACER50 stuff.
255 *			- Fix small problem with ide_cdrom_capacity
256 *
257 * 4.59  Aug 11, 2000	- Fix changer problem in cdrom_read_toc, we weren't
258 *			  correctly sensing a disc change.
259 *			- Rearranged some code
260 *			- Use extended sense on drives that support it for
261 *			  correctly reporting tray status -- from
262 *			  Michael D Johnson <johnsom@orst.edu>
263 * 4.60  Dec 17, 2003	- Add mt rainier support
264 *			- Bump timeout for packet commands, matches sr
265 *			- Odd stuff
266 * 4.61  Jan 22, 2004	- support hardware sector sizes other than 2kB,
267 *			  Pascal Schmidt <der.eremit@email.de>
268 */
269