Documentation/cdrom/cdrom-standard.rst

62 which was expressed through `cdrom.h`, it appeared to be a rather wild
85 in the file `cdrom.c`. This driver is intended to be an additional software
98 programmer's interface defined in `cdrom.h`. This guide was written to
100 Driver code defined in `cdrom.c`.
133 CD-ROM drivers\' header files to the kernel's cdrom directory. This was
134 done to help ensure that the user is only presented with only one cdrom
135 interface, the interface defined in `cdrom.h`.
139 of common **CD-ROM device operations**, *<cdrom-device>_dops*.
144 in the file `cdrom.c`. In this file, the Uniform CD-ROM Driver interfaces
164 declared above are all implemented in `cdrom.c`, since this file is the
173 the general routines in `cdrom.c`, not through the Virtual File System
174 (VFS) any more. The interface implemented in `cdrom.c` is carried out
203 device driver. When `cdrom.c` accesses a CD-ROM device, it does it
249 `cdrom.c`, currently contains the following fields::
305 The intermediate software layer that `cdrom.c` forms will perform some
336 done by the calling routine in `cdrom.c`, so the low-level routine
358 *slot_nr* should be ignored. In `cdrom.h` the possibilities are listed::
412 drive, measured in units of standard cdrom speed (176kB/sec raw data
429 routines in `cdrom.c` have sanitized this argument: its requested
435 course) and the routines in `cdrom.c` will make the transformation if
459 longer listening, it may be wise for the underlying low-level cdrom
467 Some of the CD-ROM-\ *ioctl()*\ 's defined in `cdrom.h` can be
509 standardized in `cdrom.c`.
531 `cdrom.c` supplies the possibility to indicate the **capabilities**
533 capability-constants that are defined in `cdrom.h` at the registration
551 inform `cdrom.c` of what the driver can do. If the drive found
560 In the file `cdrom.c` you will encounter many constructions of the type::
586 new *ioctl()'s* implemented in `cdrom.c`, that allow you to control the
675    newly inserted CD-ROM under `/cdrom/*<volume-name>*`.
698 The routines in `cdrom.c` are designed in such a way that run-time
724 Description of routines in `cdrom.c`
727 Only a few routines in `cdrom.c` are exported to the drivers. In this
730 to `cdrom.c` is called `cdrom.h`. Formerly, some of the contents of this
732 merged back into `cdrom.h`.
869 New *ioctl()'s* in `cdrom.c`
884 	of standard cdrom speed (176\,kB/sec raw data or
958 	types, see a recent version of `cdrom.h`.
985 - Get hold of the files `cdrom.c` and `cdrom.h`, they should be in
987 - Make sure you include `cdrom.h`.
1008   according to prototypes listed in  `cdrom.h`, and specifications given
1032   for `cdrom.o` and your driver, as debugging is much easier this
1039 taken over the torch in maintaining `cdrom.c` and integrating much