| blob | 5a10b12bb755f4150eb691842751063fe65272fe |
1 '\" te
2 .\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH CDIO 7I "Oct 4, 2001"
7 .SH NAME
8 cdio \- CD-ROM control operations
9 .SH SYNOPSIS
10 .LP
11 .nf
12 \fB#include <sys/cdio.h>\fR
13 .fi
15 .SH DESCRIPTION
16 .sp
17 .LP
18 The set of \fBioctl\fR(2) commands described below are used to perform audio
19 and \fBCD-ROM\fR specific operations. Basic to these \fBcdio\fR ioctl requests
20 are the definitions in \fB<sys/cdio.h>\fR\&.
21 .sp
22 .LP
23 Several \fBCD-ROM\fR specific commands can report addresses either in \fBLBA\fR
24 (Logical Block Address) format or in \fBMSF\fR (Minute, Second, Frame) format.
25 The \fBREAD HEADER\fR, \fBREAD SUBCHANNEL\fR, and \fBREAD TABLE OF CONTENTS\fR
26 commands have this feature.
27 .sp
28 .LP
29 \fBLBA\fR format represents the logical block address for the \fBCD-ROM\fR
30 absolute address field or for the offset from the beginning of the current
31 track expressed as a number of logical blocks in a \fBCD-ROM\fR track relative
32 address field. \fBMSF\fR format represents the physical address written on
33 \fBCD-ROM\fR discs, expressed as a sector count relative to either the
34 beginning of the medium or the beginning of the current track.
35 .SH IOCTLS
36 .sp
37 .LP
38 The following \fBI/O\fR controls do not have any additional data passed into or
39 received from them.
40 .sp
41 .ne 2
42 .na
43 \fB\fBCDROMSTART\fR\fR
44 .ad
45 .RS 18n
46 This \fBioctl()\fR spins up the disc and seeks to the last address requested.
47 .RE
49 .sp
50 .ne 2
51 .na
52 \fB\fBCDROMSTOP\fR\fR
53 .ad
54 .RS 18n
55 This \fBioctl()\fR spins down the disc.
56 .RE
58 .sp
59 .ne 2
60 .na
61 \fB\fBCDROMPAUSE\fR\fR
62 .ad
63 .RS 18n
64 This \fBioctl()\fR pauses the current audio play operation.
65 .RE
67 .sp
68 .ne 2
69 .na
70 \fB\fBCDROMRESUME\fR\fR
71 .ad
72 .RS 18n
73 This \fBioctl()\fR resumes the paused audio play operation.
74 .RE
76 .sp
77 .ne 2
78 .na
79 \fB\fBCDROMEJECT\fR\fR
80 .ad
81 .RS 18n
82 This \fBioctl()\fR ejects the caddy with the disc.
83 .RE
85 .sp
86 .ne 2
87 .na
88 \fB\fBCDROMCLOSETRAY\fR\fR
89 .ad
90 .RS 18n
91 This \fBioctl()\fR closes the caddy with the disc.
92 .RE
94 .sp
95 .LP
96 The following \fBI/O\fR controls require a pointer to the structure for that
97 \fBioctl()\fR, with data being passed into the \fBioctl()\fR.
98 .sp
99 .ne 2
100 .na
101 \fB\fBCDROMPLAYMSF\fR\fR
102 .ad
103 .RS 19n
104 This \fBioctl()\fR command requests the drive to output the audio signals at
105 the specified starting address and continue the audio play until the specified
106 ending address is detected. The address is in \fBMSF\fR format. The third
107 argument of this \fBioctl()\fR call is a pointer to the type \fBstruct
108 cdrom_msf\fR.
109 .sp
110 .in +2
111 .nf
112 /*
113 * definition of play audio msf structure
114 */
115 struct cdrom_msf {
116 unsigned char cdmsf_min0; /* starting minute*/
117 unsigned char cdmsf_sec0; /* starting second*/
118 unsigned char cdmsf_frame0; /*starting frame*/
119 unsigned char cdmsf_min1; /* ending minute */
120 unsigned char cdmsf_sec1; /* ending second */
121 unsigned char cdmsf_frame1; /* ending frame */
122 };
123 .fi
124 .in -2
126 The \fBCDROMREADTOCENTRY\fR ioctl request may be used to obtain the start time
127 for a track. An approximation of the finish time can be obtained by using the
128 \fBCDROMREADTOCENTRY\fR ioctl request to retrieve the start time of the track
129 following the current track.
130 .sp
131 The leadout track is the next consecutive track after the last audio track.
132 Hence, the start time of the leadout track may be used as the effective finish
133 time of the last audio track.
134 .RE
136 .sp
137 .ne 2
138 .na
139 \fB\fBCDROMPLAYTRKIND\fR\fR
140 .ad
141 .RS 19n
142 This \fBioctl()\fR command is similar to \fBCDROMPLAYMSF\fR. The starting and
143 ending address is in track/index format. The third argument of the
144 \fBioctl()\fR call is a pointer to the type \fBstruct cdrom_ti\fR.
145 .sp
146 .in +2
147 .nf
148 /*
149 * definition of play audio track/index structure
150 */
151 struct cdrom_ti {
152 unsigned char cdti_trk0; /* starting track*/
153 unsigned char cdti_ind0; /* starting index*/
154 unsigned char cdti_trk1; /* ending track */
155 unsigned char cdti_ind1; /* ending index */
156 };
157 .fi
158 .in -2
160 .RE
162 .sp
163 .ne 2
164 .na
165 \fB\fBCDROMVOLCTRL\fR\fR
166 .ad
167 .RS 19n
168 This \fBioctl()\fR command controls the audio output level. The \fBSCSI\fR
169 command allows the control of up to four channels. The current implementation
170 of the supported \fBCD-ROM\fR drive only uses channel 0 and channel 1. The
171 valid values of volume control are between 0x00 and 0xFF, with a value of 0xFF
172 indicating maximum volume. The third argument of the \fBioctl()\fR call is a
173 pointer to \fBstruct\fR \fBcdrom_volctrl\fR which contains the output volume
174 values.
175 .sp
176 .in +2
177 .nf
178 /*
179 * definition of audio volume control structure
180 */
181 struct cdrom_volctrl {
182 unsigned char channel0;
183 unsigned char channel1;
184 unsigned char channel2;
185 unsigned char channel3;
186 };
187 .fi
188 .in -2
190 .RE
192 .sp
193 .LP
194 The following \fBI/O\fR controls take a pointer that will have data returned to
195 the user program from the \fBCD-ROM\fR driver.
196 .sp
197 .ne 2
198 .na
199 \fB\fBCDROMREADTOCHDR\fR\fR
200 .ad
201 .RS 21n
202 This \fBioctl()\fR command returns the header of the table of contents (TOC).
203 The header consists of the starting tracking number and the ending track number
204 of the disc. These two numbers are returned through a pointer of \fBstruct
205 cdrom_tochdr\fR. While the disc can start at any number, all tracks between the
206 first and last tracks are in contiguous ascending order.
207 .sp
208 .in +2
209 .nf
210 /*
211 * definition of read toc header structure
212 */
213 struct cdrom_tochdr {
214 unsigned char cdth_trk0; /* starting track*/
215 unsigned char cdth_trk1; /* ending track*/
216 };
217 .fi
218 .in -2
220 .RE
222 .sp
223 .ne 2
224 .na
225 \fB\fBCDROMREADTOCENTRY\fR\fR
226 .ad
227 .RS 21n
228 This \fBioctl()\fR command returns the information of a specified track. The
229 third argument of the function call is a pointer to the type \fBstruct
230 cdrom_tocentry\fR. The caller needs to supply the track number and the address
231 format. This command will return a 4-bit \fBadr\fR field, a 4-bit \fBctrl\fR
232 field, the starting address in \fBMSF\fR format or \fBLBA\fR format, and the
233 data mode if the track is a data track. The \fBctrl\fR field specifies whether
234 the track is data or audio.
235 .sp
236 .in +2
237 .nf
238 /*
239 * definition of read toc entry structure
240 */
241 struct cdrom_tocentry {
242 unsigned char cdte_track;
243 unsigned char cdte_adr :4;
244 unsigned char cdte_ctrl :4;
245 unsigned char cdte_format;
246 union {
247 struct {
248 unsigned char minute;
249 unsigned char second;
250 unsigned char frame;
251 } msf;
252 int lba;
253 } cdte_addr;
254 unsigned char cdte_datamode;
255 };
256 .fi
257 .in -2
259 To get the information from the leadout track, the following value is
260 appropriate for the \fBcdte_track\fR field:
261 .sp
262 .ne 2
263 .na
264 \fB\fBCDROM_LEADOUT\fR\fR
265 .ad
266 .RS 17n
267 Leadout track
268 .RE
270 To get the information from the data track, the following value is appropriate
271 for the \fBcdte_ctrl\fR field:
272 .sp
273 .ne 2
274 .na
275 \fB\fBCDROM_DATA_TRACK\fR\fR
276 .ad
277 .RS 20n
278 Data track
279 .RE
281 The following values are appropriate for the \fBcdte_format\fR field:
282 .sp
283 .ne 2
284 .na
285 \fB\fBCDROM_LBA\fR\fR
286 .ad
287 .RS 13n
288 \fBLBA\fR format
289 .RE
291 .sp
292 .ne 2
293 .na
294 \fB\fBCDROM_MSF\fR\fR
295 .ad
296 .RS 13n
297 \fBMSF\fR format
298 .RE
300 .RE
302 .sp
303 .ne 2
304 .na
305 \fB\fBCDROMSUBCHNL\fR\fR
306 .ad
307 .RS 21n
308 This \fBioctl()\fR command reads the Q sub-channel data of the current block.
309 The subchannel data includes track number, index number, absolute \fBCD-ROM\fR
310 address, track relative \fBCD-ROM\fR address, control data and audio status.
311 All information is returned through a pointer to \fBstruct cdrom_subchnl\fR.
312 The caller needs to supply the address format for the returned address.
313 .sp
314 .in +2
315 .nf
316 struct cdrom_subchnl {
317 unsigned char cdsc_format;
318 unsigned char cdsc_audiostatus;
319 unsigned char cdsc_adr: 4;
320 unsigned char cdsc_ctrl: 4;
321 unsigned char cdsc_trk;
322 unsigned char cdsc_ind;
323 union {
324 struct {
325 unsigned char minute;
326 unsigned char second;
327 unsigned char frame;
328 } msf;
329 int lba;
330 } cdsc_absaddr;
331 union {
332 struct {
333 unsigned char minute;
334 unsigned char second;
335 unsigned char frame;
336 } msf;
337 int lba;
338 } cdsc_reladdr;
339 };
340 .fi
341 .in -2
343 The following values are valid for the audio status field returned from
344 \fBREAD\fR \fBSUBCHANNEL\fR command:
345 .sp
346 .ne 2
347 .na
348 \fB\fBCDROM_AUDIO_INVALID\fR\fR
349 .ad
350 .RS 25n
351 Audio status not supported.
352 .RE
354 .sp
355 .ne 2
356 .na
357 \fB\fBCDROM_AUDIO_PLAY\fR\fR
358 .ad
359 .RS 25n
360 Audio play operation in progress.
361 .RE
363 .sp
364 .ne 2
365 .na
366 \fB\fBCDROM_AUDIO_PAUSED\fR\fR
367 .ad
368 .RS 25n
369 Audio play operation paused.
370 .RE
372 .sp
373 .ne 2
374 .na
375 \fB\fBCDROM_AUDIO_COMPLETED\fR\fR
376 .ad
377 .RS 25n
378 Audio play successfully completed.
379 .RE
381 .sp
382 .ne 2
383 .na
384 \fB\fBCDROM_AUDIO_ERROR\fR\fR
385 .ad
386 .RS 25n
387 Audio play stopped due to error.
388 .RE
390 .sp
391 .ne 2
392 .na
393 \fB\fBCDROM_AUDIO_NO_STATUS\fR\fR
394 .ad
395 .RS 25n
396 No current audio status to return.
397 .RE
399 .RE
401 .sp
402 .ne 2
403 .na
404 \fB\fBCDROMREADOFFSET\fR\fR
405 .ad
406 .RS 21n
407 This \fBioctl()\fR command returns the absolute \fBCD-ROM\fR address of the
408 first track in the last session of a Multi-Session \fBCD-ROM\fR. The third
409 argument of the \fBioctl()\fR call is a pointer to an \fBint\fR.
410 .RE
412 .sp
413 .ne 2
414 .na
415 \fB\fBCDROMCDDA\fR\fR
416 .ad
417 .RS 21n
418 This \fBioctl()\fR command returns the \fBCD-DA\fR data or the subcode data.
419 The third argument of the \fBioctl()\fR call is a pointer to the type \fBstruct
420 cdrom_cdda\fR. In addition to allocating memory and supplying its address, the
421 caller needs to supply the starting address of the data, the transfer length in
422 terms of the number of blocks to be transferred, and the subcode options. The
423 caller also needs to issue the \fBCDROMREADTOCENTRY\fR \fBioctl()\fR to find
424 out which tracks contain \fBCD-DA\fR data before issuing this \fBioctl()\fR.
425 .sp
426 .in +2
427 .nf
428 /*
429 * Definition of CD-DA structure
430 */
431 struct cdrom_cdda {
432 unsigned int cdda_addr;
433 unsigned int cdda_length;
434 caddr_t cdda_data;
435 unsigned char cdda_subcode;
436 };
437 .fi
438 .in -2
440 \fBcdda_addr\fR signifies the starting logical block address.
441 .sp
442 \fBcdda_length\fR signifies the transfer length in blocks. The length of the
443 block depends on the \fBcdda_subcode\fR selection, which is explained below.
444 .sp
445 To get the subcode information related to \fBCD-DA\fR data, the following
446 values are appropriate for the \fBcdda_subcode\fR field:
447 .sp
448 .ne 2
449 .na
450 \fB\fBCDROM_DA_NO_SUBCODE\fR\fR
451 .ad
452 .RS 25n
453 \fBCD-DA\fR data with no subcode.
454 .RE
456 .sp
457 .ne 2
458 .na
459 \fB\fBCDROM_DA_SUBQ\fR\fR
460 .ad
461 .RS 25n
462 \fBCD-DA\fR data with sub Q code.
463 .RE
465 .sp
466 .ne 2
467 .na
468 \fB\fBCDROM_DA_ALL_SUBCODE\fR\fR
469 .ad
470 .RS 25n
471 \fBCD-DA\fR data with all subcode.
472 .RE
474 .sp
475 .ne 2
476 .na
477 \fB\fBCDROM_DA_SUBCODE_ONLY\fR\fR
478 .ad
479 .RS 25n
480 All subcode only.
481 .RE
483 To allocate the memory related to \fBCD-DA\fR and/or subcode data, the
484 following values are appropriate for each data block transferred:
485 .sp
486 .ne 2
487 .na
488 \fB\fBCD-DA\fR data with no subcode\fR
489 .ad
490 .sp .6
491 .RS 4n
492 2352 bytes
493 .RE
495 .sp
496 .ne 2
497 .na
498 \fB\fBCD-DA\fR data with sub Q code\fR
499 .ad
500 .sp .6
501 .RS 4n
502 2368 bytes
503 .RE
505 .sp
506 .ne 2
507 .na
508 \fB\fBCD-DA\fR data with all subcode\fR
509 .ad
510 .sp .6
511 .RS 4n
512 2448 bytes
513 .RE
515 .sp
516 .ne 2
517 .na
518 \fBAll subcode only\fR
519 .ad
520 .sp .6
521 .RS 4n
522 96 bytes
523 .RE
525 .RE
527 .sp
528 .ne 2
529 .na
530 \fB\fBCDROMCDXA\fR\fR
531 .ad
532 .RS 21n
533 This \fBioctl()\fR command returns the \fBCD-ROM\fR \fBXA\fR (CD-ROM Extended
534 Architecture) data according to \fBCD-ROM\fR \fBXA\fR format. The third
535 argument of the \fBioctl()\fR call is a pointer to the type \fBstruct
536 cdrom_cdxa\fR. In addition to allocating memory and supplying its address, the
537 caller needs to supply the starting address of the data, the transfer length
538 in terms of number of blocks, and the format. The caller also needs to issue
539 the \fBCDROMREADTOCENTRY\fR \fBioctl()\fR to find out which tracks contain
540 \fBCD-ROM\fR \fBXA\fR data before issuing this \fBioctl()\fR.
541 .sp
542 .in +2
543 .nf
544 /*
545 * Definition of CD-ROM XA structure
546 */
547 struct cdrom_cdxa {
548 unsigned int cdxa_addr;
549 unsigned int cdxa_length;
550 caddr_t cdxa_data;
551 unsigned char cdxa_format;
552 };
553 .fi
554 .in -2
556 To get the proper \fBCD-ROM\fR \fBXA\fR data, the following values are
557 appropriate for the \fBcdxa_format\fR field:
558 .sp
559 .ne 2
560 .na
561 \fB\fBCDROM_XA_DATA\fR\fR
562 .ad
563 .RS 25n
564 \fBCD-ROM\fR \fBXA\fR data only
565 .RE
567 .sp
568 .ne 2
569 .na
570 \fB\fBCDROM_XA_SECTOR_DATA\fR\fR
571 .ad
572 .RS 25n
573 \fBCD-ROM\fR \fBXA\fR all sector data
574 .RE
576 .sp
577 .ne 2
578 .na
579 \fB\fBCDROM_XA_DATA_W_ERROR\fR\fR
580 .ad
581 .RS 25n
582 \fBCD-ROM\fR \fBXA\fR data with error flags data
583 .RE
585 To allocate the memory related to \fBCD-ROM\fR \fBXA\fR format, the following
586 values are appropriate for each data block transferred:
587 .sp
588 .ne 2
589 .na
590 \fB\fBCD-ROM XA\fR data only\fR
591 .ad
592 .sp .6
593 .RS 4n
594 2048 bytes
595 .RE
597 .sp
598 .ne 2
599 .na
600 \fB\fBCD-ROM XA\fR all sector data\fR
601 .ad
602 .sp .6
603 .RS 4n
604 2352 bytes
605 .RE
607 .sp
608 .ne 2
609 .na
610 \fB\fBCD-ROM XA\fR data with error flags data\fR
611 .ad
612 .sp .6
613 .RS 4n
614 2646 bytes
615 .RE
617 .RE
619 .sp
620 .ne 2
621 .na
622 \fB\fBCDROMSUBCODE\fR\fR
623 .ad
624 .RS 21n
625 This \fBioctl()\fR command returns raw subcode data (subcodes P ~ W are
626 described in the "Red Book," see \fBSEE ALSO\fR) to the initiator while the
627 target is playing audio. The third argument of the \fBioctl()\fR call is a
628 pointer to the type \fBstruct cdrom_subcode\fR. The caller needs to supply the
629 transfer length in terms of number of blocks and allocate memory for subcode
630 data. The memory allocated should be a multiple of 96 bytes depending on the
631 transfer length.
632 .sp
633 .in +2
634 .nf
635 /*
636 * Definition of subcode structure
637 */
638 struct cdrom_subcode {
639 unsigned int cdsc_length;
640 caddr_t cdsc_addr;
641 };
642 .fi
643 .in -2
645 .RE
647 .sp
648 .LP
649 The next group of \fBI/O\fR controls get and set various \fBCD-ROM\fR drive
650 parameters.
651 .sp
652 .ne 2
653 .na
654 \fB\fBCDROMGBLKMODE\fR\fR
655 .ad
656 .RS 18n
657 This \fBioctl()\fR command returns the current block size used by the
658 \fBCD-ROM\fR drive. The third argument of the \fBioctl()\fR call is a pointer
659 to an integer.
660 .RE
662 .sp
663 .ne 2
664 .na
665 \fB\fBCDROMSBLKMODE\fR\fR
666 .ad
667 .RS 18n
668 This \fBioctl()\fR command requests the \fBCD-ROM\fR drive to change from the
669 current block size to the requested block size. The third argument of the
670 \fBioctl()\fR call is an integer which contains the requested block size.
671 .sp
672 This \fBioctl()\fR command operates in exclusive-use mode only. The caller must
673 ensure that no other processes can operate on the same \fBCD-ROM\fR device
674 before issuing this \fBioctl()\fR. \fBread\fR(2) behavior subsequent to this
675 \fBioctl()\fR remains the same: the caller is still constrained to read the raw
676 device on block boundaries and in block multiples.
677 .sp
678 To set the proper block size, the following values are appropriate:
679 .sp
680 .ne 2
681 .na
682 \fB\fBCDROM_BLK_512\fR\fR
683 .ad
684 .RS 18n
685 512 bytes
686 .RE
688 .sp
689 .ne 2
690 .na
691 \fB\fBCDROM_BLK_1024\fR\fR
692 .ad
693 .RS 18n
694 1024 bytes
695 .RE
697 .sp
698 .ne 2
699 .na
700 \fB\fBCDROM_BLK_2048\fR\fR
701 .ad
702 .RS 18n
703 2048 bytes
704 .RE
706 .sp
707 .ne 2
708 .na
709 \fB\fBCDROM_BLK_2056\fR\fR
710 .ad
711 .RS 18n
712 2056 bytes
713 .RE
715 .sp
716 .ne 2
717 .na
718 \fB\fBCDROM_BLK_2336\fR\fR
719 .ad
720 .RS 18n
721 2336 bytes
722 .RE
724 .sp
725 .ne 2
726 .na
727 \fB\fBCDROM_BLK_2340\fR\fR
728 .ad
729 .RS 18n
730 2340 bytes
731 .RE
733 .sp
734 .ne 2
735 .na
736 \fB\fBCDROM_BLK_2352\fR\fR
737 .ad
738 .RS 18n
739 2352 bytes
740 .RE
742 .sp
743 .ne 2
744 .na
745 \fB\fBCDROM_BLK_2368\fR\fR
746 .ad
747 .RS 18n
748 2368 bytes
749 .RE
751 .sp
752 .ne 2
753 .na
754 \fB\fBCDROM_BLK_2448\fR\fR
755 .ad
756 .RS 18n
757 2448 bytes
758 .RE
760 .sp
761 .ne 2
762 .na
763 \fB\fBCDROM_BLK_2646\fR\fR
764 .ad
765 .RS 18n
766 2646 bytes
767 .RE
769 .sp
770 .ne 2
771 .na
772 \fB\fBCDROM_BLK_2647\fR\fR
773 .ad
774 .RS 18n
775 2647 bytes
776 .RE
778 .RE
780 .sp
781 .ne 2
782 .na
783 \fB\fBCDROMGDRVSPEED\fR\fR
784 .ad
785 .RS 18n
786 This \fBioctl()\fR command returns the current \fBCD-ROM\fR drive speed. The
787 third argument of the \fBioctl()\fR call is a pointer to an integer.
788 .RE
790 .sp
791 .ne 2
792 .na
793 \fB\fBCDROMSDRVSPEED\fR\fR
794 .ad
795 .RS 18n
796 This \fBioctl()\fR command requests the \fBCD-ROM\fR drive to change the
797 current drive speed to the requested drive speed. This speed setting is only
798 applicable when reading data areas. The third argument of the \fBioctl()\fR is
799 an integer which contains the requested drive speed.
800 .sp
801 To set the \fBCD-ROM\fR drive to the proper speed, the following values are
802 appropriate:
803 .sp
804 .ne 2
805 .na
806 \fB\fBCDROM_NORMAL_SPEED\fR\fR
807 .ad
808 .RS 23n
809 150k/second
810 .RE
812 .sp
813 .ne 2
814 .na
815 \fB\fBCDROM_DOUBLE_SPEED\fR\fR
816 .ad
817 .RS 23n
818 300k/second
819 .RE
821 .sp
822 .ne 2
823 .na
824 \fB\fBCDROM_QUAD_SPEED\fR\fR
825 .ad
826 .RS 23n
827 600k/second
828 .RE
830 .sp
831 .ne 2
832 .na
833 \fB\fBCDROM_MAXIMUM_SPEED\fR\fR
834 .ad
835 .RS 23n
836 300k/second (2x drive) 600k/second (4x drive)
837 .RE
839 Note that these numbers are only accurate when reading 2048 byte blocks. The
840 \fBCD-ROM\fR drive will automatically switch to normal speed when playing audio
841 tracks and will switch back to the speed setting when accessing data.
842 .RE
844 .SH SEE ALSO
845 .sp
846 .LP
847 \fBioctl\fR(2), \fBread\fR(2)
848 .sp
849 .LP
850 N. V. Phillips and Sony Corporation, \fISystem Description Compact Disc Digital
851 Audio\fR, ("Red Book").
852 .sp
853 .LP
854 N. V. Phillips and Sony Corporation, \fISystem Description of Compact Disc Read
855 Only Memory\fR, ("Yellow Book").
856 .sp
857 .LP
858 N. V. Phillips, Microsoft, and Sony Corporation, \fISystem Description CD-ROM
859 XA\fR, 1991.
860 .sp
861 .LP
862 \fIVolume and File Structure of CD-ROM for Information Interchange\fR, ISO
863 9660:1988(E).
864 .sp
865 .LP
866 \fISCSI-2\fR \fIStandard,\fR \fIdocument\fR \fIX3T9.2/86-109\fR
867 .sp
868 .LP
869 \fISCSI Multimedia Commands, Version 2 (MMC-2)\fR
870 .SH NOTES
871 .sp
872 .LP
873 The \fBCDROMCDDA\fR, \fBCDROMCDXA\fR, \fBCDROMSUBCODE\fR,
874 \fBCDROMGDRVSPEED\fR, \fBCDROMSDRVSPEED\fR, and some of the block sizes in
875 \fBCDROMSBLKMODE\fR are designed for new Sun-supported \fBCD-ROM\fR drives and
876 might not work on some of the older \fBCD-ROM\fR drives.
877 .sp
878 .LP
879 CDROMCDDA, CDROMCDXA and CDROMSUBCODE will return error if the transfer length
880 exceeds valid limits as determined appropriate. Example: for MMC-2 drives,
881 length can not exceed 3 bytes (i.e. 0xffffff). The same restriction is
882 enforced for older, pre-MMC-2 drives, as no limit was published for these older
883 drives (and 3 bytes is reasonable for all media). Note that enforcing this
884 limit does not imply that values passed in below this limit will actually be
885 applicable for each and every piece of media.
886 .sp
887 .LP
888 The interface to this device is preliminary and subject to change in future
889 releases. Programs should be written in a modular fashion so that future
890 changes can be easily incorporated.