This ioctl() spins up the disc and seeks to the last address requested.

This ioctl() spins down the disc.

This ioctl() pauses the current audio play operation.

This ioctl() resumes the paused audio play operation.

This ioctl() ejects the caddy with the disc.

This ioctl() closes the caddy with the disc.

This ioctl() command requests the drive to output the audio signals at the specified starting address and continue the audio play until the specified ending address is detected. The address is in MSF format. The third argument of this ioctl() call is a pointer to the type struct cdrom_msf.

/*
 * definition of play audio msf structure
 */
struct cdrom_msf {
 unsigned char cdmsf_min0; /* starting minute*/
 unsigned char cdmsf_sec0; /* starting second*/
 unsigned char cdmsf_frame0; /*starting frame*/
 unsigned char cdmsf_min1; /* ending minute */
 unsigned char cdmsf_sec1; /* ending second */
 unsigned char cdmsf_frame1; /* ending frame */
};

This ioctl() command is similar to CDROMPLAYMSF. The starting and ending address is in track/index format. The third argument of the ioctl() call is a pointer to the type struct cdrom_ti.

/*
 * definition of play audio track/index structure
 */
struct cdrom_ti {
 unsigned char cdti_trk0; /* starting track*/
 unsigned char cdti_ind0; /* starting index*/
 unsigned char cdti_trk1; /* ending track */
 unsigned char cdti_ind1; /* ending index */
};

This ioctl() command controls the audio output level. The SCSI command allows the control of up to four channels. The current implementation of the supported CD-ROM drive only uses channel 0 and channel 1. The valid values of volume control are between 0x00 and 0xFF, with a value of 0xFF indicating maximum volume. The third argument of the ioctl() call is a pointer to struct cdrom_volctrl which contains the output volume values.

/*
 * definition of audio volume control structure
 */
struct cdrom_volctrl {
 unsigned char channel0;
 unsigned char channel1;
 unsigned char channel2;
 unsigned char channel3;
};

This ioctl() command returns the header of the table of contents (TOC). The header consists of the starting tracking number and the ending track number of the disc. These two numbers are returned through a pointer of struct cdrom_tochdr. While the disc can start at any number, all tracks between the first and last tracks are in contiguous ascending order.

/*
 * definition of read toc header structure
 */
struct cdrom_tochdr {
 unsigned char cdth_trk0; /* starting track*/
 unsigned char cdth_trk1; /* ending track*/
};

This ioctl() command returns the information of a specified track. The third argument of the function call is a pointer to the type struct cdrom_tocentry. The caller needs to supply the track number and the address format. This command will return a 4-bit adr field, a 4-bit ctrl field, the starting address in MSF format or LBA format, and the data mode if the track is a data track. The ctrl field specifies whether the track is data or audio.

/*
 * definition of read toc entry structure
 */
struct cdrom_tocentry {
 unsigned char cdte_track;
 unsigned char cdte_adr :4;
 unsigned char cdte_ctrl :4;
 unsigned char cdte_format;
 union {
 struct {
 unsigned char minute;
 unsigned char second;
 unsigned char frame;
 } msf;
 int lba;
 } cdte_addr;
 unsigned char cdte_datamode;
};

This ioctl() command reads the Q sub-channel data of the current block. The subchannel data includes track number, index number, absolute CD-ROM address, track relative CD-ROM address, control data and audio status. All information is returned through a pointer to struct cdrom_subchnl. The caller needs to supply the address format for the returned address.

struct cdrom_subchnl {
 unsigned char cdsc_format;
 unsigned char cdsc_audiostatus;
 unsigned char cdsc_adr: 4;
 unsigned char cdsc_ctrl: 4;
 unsigned char cdsc_trk;
 unsigned char cdsc_ind;
 union {
 struct {
 unsigned char minute;
 unsigned char second;
 unsigned char frame;
 } msf;
 int lba;
 } cdsc_absaddr;
 union {
 struct {
 unsigned char minute;
 unsigned char second;
 unsigned char frame;
 } msf;
 int lba;
 } cdsc_reladdr;
};

This ioctl() command returns the absolute CD-ROM address of the first track in the last session of a Multi-Session CD-ROM. The third argument of the ioctl() call is a pointer to an int.

This ioctl() command returns the CD-DA data or the subcode data. The third argument of the ioctl() call is a pointer to the type struct cdrom_cdda. In addition to allocating memory and supplying its address, the caller needs to supply the starting address of the data, the transfer length in terms of the number of blocks to be transferred, and the subcode options. The caller also needs to issue the CDROMREADTOCENTRY ioctl() to find out which tracks contain CD-DA data before issuing this ioctl().

/*
 * Definition of CD-DA structure
 */
struct cdrom_cdda {
 unsigned int cdda_addr;
 unsigned int cdda_length;
 caddr_t cdda_data;
 unsigned char cdda_subcode;
};

This ioctl() command returns the CD-ROM XA (CD-ROM Extended Architecture) data according to CD-ROM XA format. The third argument of the ioctl() call is a pointer to the type struct cdrom_cdxa. In addition to allocating memory and supplying its address, the caller needs to supply the starting address of the data, the transfer length in terms of number of blocks, and the format. The caller also needs to issue the CDROMREADTOCENTRY ioctl() to find out which tracks contain CD-ROM XA data before issuing this ioctl().

/*
 * Definition of CD-ROM XA structure
 */
struct cdrom_cdxa {
 unsigned int cdxa_addr;
 unsigned int cdxa_length;
 caddr_t cdxa_data;
 unsigned char cdxa_format;
};

This ioctl() command returns raw subcode data (subcodes P ~ W are described in the "Red Book," see SEE ALSO) to the initiator while the target is playing audio. The third argument of the ioctl() call is a pointer to the type struct cdrom_subcode. The caller needs to supply the transfer length in terms of number of blocks and allocate memory for subcode data. The memory allocated should be a multiple of 96 bytes depending on the transfer length.

/*
 * Definition of subcode structure
 */
struct cdrom_subcode {
 unsigned int cdsc_length;
 caddr_t cdsc_addr;
};

This ioctl() command returns the current block size used by the CD-ROM drive. The third argument of the ioctl() call is a pointer to an integer.

This ioctl() command requests the CD-ROM drive to change from the current block size to the requested block size. The third argument of the ioctl() call is an integer which contains the requested block size. This ioctl() command operates in exclusive-use mode only. The caller must ensure that no other processes can operate on the same CD-ROM device before issuing this ioctl(). read(2) behavior subsequent to this ioctl() remains the same: the caller is still constrained to read the raw device on block boundaries and in block multiples. To set the proper block size, the following values are appropriate: CDROM_BLK_512

This ioctl() command returns the current CD-ROM drive speed. The third argument of the ioctl() call is a pointer to an integer.

This ioctl() command requests the CD-ROM drive to change the current drive speed to the requested drive speed. This speed setting is only applicable when reading data areas. The third argument of the ioctl() is an integer which contains the requested drive speed. To set the CD-ROM drive to the proper speed, the following values are appropriate: CDROM_NORMAL_SPEED