1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * -- <linux/cdrom.h> 4 * General header file for linux CD-ROM drivers 5 * Copyright (C) 1992 David Giller, rafetmad@oxy.edu 6 * 1994, 1995 Eberhard Mönkeberg, emoenke@gwdg.de 7 * 1996 David van Leeuwen, david@tm.tno.nl 8 * 1997, 1998 Erik Andersen, andersee@debian.org 9 * 1998-2002 Jens Axboe, axboe@suse.de 10 */ 11 #ifndef _LINUX_CDROM_H 12 #define _LINUX_CDROM_H 13 14 #include <linux/fs.h> /* not really needed, later.. */ 15 #include <linux/list.h> 16 #include <uapi/linux/cdrom.h> 17 18 struct packet_command 19 { 20 unsigned char cmd[CDROM_PACKET_SIZE]; 21 unsigned char *buffer; 22 unsigned int buflen; 23 int stat; 24 struct request_sense *sense; 25 unsigned char data_direction; 26 int quiet; 27 int timeout; 28 void *reserved[1]; 29 }; 30 31 /* 32 * _OLD will use PIO transfer on atapi devices, _BPC_* will use DMA 33 */ 34 #define CDDA_OLD 0 /* old style */ 35 #define CDDA_BPC_SINGLE 1 /* single frame block pc */ 36 #define CDDA_BPC_FULL 2 /* multi frame block pc */ 37 38 /* Uniform cdrom data structures for cdrom.c */ 39 struct cdrom_device_info { 40 const struct cdrom_device_ops *ops; /* link to device_ops */ 41 struct list_head list; /* linked list of all device_info */ 42 struct gendisk *disk; /* matching block layer disk */ 43 void *handle; /* driver-dependent data */ 44 /* specifications */ 45 int mask; /* mask of capability: disables them */ 46 int speed; /* maximum speed for reading data */ 47 int capacity; /* number of discs in jukebox */ 48 /* device-related storage */ 49 unsigned int options : 30; /* options flags */ 50 unsigned mc_flags : 2; /* media change buffer flags */ 51 unsigned int vfs_events; /* cached events for vfs path */ 52 unsigned int ioctl_events; /* cached events for ioctl path */ 53 int use_count; /* number of times device opened */ 54 char name[20]; /* name of the device type */ 55 /* per-device flags */ 56 __u8 sanyo_slot : 2; /* Sanyo 3 CD changer support */ 57 __u8 keeplocked : 1; /* CDROM_LOCKDOOR status */ 58 __u8 reserved : 5; /* not used yet */ 59 int cdda_method; /* see flags */ 60 __u8 last_sense; 61 __u8 media_written; /* dirty flag, DVD+RW bookkeeping */ 62 unsigned short mmc3_profile; /* current MMC3 profile */ 63 int for_data; 64 int (*exit)(struct cdrom_device_info *); 65 int mrw_mode_page; 66 }; 67 68 struct cdrom_device_ops { 69 /* routines */ 70 int (*open) (struct cdrom_device_info *, int); 71 void (*release) (struct cdrom_device_info *); 72 int (*drive_status) (struct cdrom_device_info *, int); 73 unsigned int (*check_events) (struct cdrom_device_info *cdi, 74 unsigned int clearing, int slot); 75 int (*media_changed) (struct cdrom_device_info *, int); 76 int (*tray_move) (struct cdrom_device_info *, int); 77 int (*lock_door) (struct cdrom_device_info *, int); 78 int (*select_speed) (struct cdrom_device_info *, int); 79 int (*select_disc) (struct cdrom_device_info *, int); 80 int (*get_last_session) (struct cdrom_device_info *, 81 struct cdrom_multisession *); 82 int (*get_mcn) (struct cdrom_device_info *, 83 struct cdrom_mcn *); 84 /* hard reset device */ 85 int (*reset) (struct cdrom_device_info *); 86 /* play stuff */ 87 int (*audio_ioctl) (struct cdrom_device_info *,unsigned int, void *); 88 89 /* driver specifications */ 90 const int capability; /* capability flags */ 91 /* handle uniform packets for scsi type devices (scsi,atapi) */ 92 int (*generic_packet) (struct cdrom_device_info *, 93 struct packet_command *); 94 }; 95 96 /* the general block_device operations structure: */ 97 extern int cdrom_open(struct cdrom_device_info *cdi, struct block_device *bdev, 98 fmode_t mode); 99 extern void cdrom_release(struct cdrom_device_info *cdi, fmode_t mode); 100 extern int cdrom_ioctl(struct cdrom_device_info *cdi, struct block_device *bdev, 101 fmode_t mode, unsigned int cmd, unsigned long arg); 102 extern unsigned int cdrom_check_events(struct cdrom_device_info *cdi, 103 unsigned int clearing); 104 extern int cdrom_media_changed(struct cdrom_device_info *); 105 106 extern int register_cdrom(struct cdrom_device_info *cdi); 107 extern void unregister_cdrom(struct cdrom_device_info *cdi); 108 109 typedef struct { 110 int data; 111 int audio; 112 int cdi; 113 int xa; 114 long error; 115 } tracktype; 116 117 extern int cdrom_get_last_written(struct cdrom_device_info *cdi, long *last_written); 118 extern int cdrom_number_of_slots(struct cdrom_device_info *cdi); 119 extern int cdrom_mode_select(struct cdrom_device_info *cdi, 120 struct packet_command *cgc); 121 extern int cdrom_mode_sense(struct cdrom_device_info *cdi, 122 struct packet_command *cgc, 123 int page_code, int page_control); 124 extern void init_cdrom_command(struct packet_command *cgc, 125 void *buffer, int len, int type); 126 extern int cdrom_dummy_generic_packet(struct cdrom_device_info *cdi, 127 struct packet_command *cgc); 128 129 /* The SCSI spec says there could be 256 slots. */ 130 #define CDROM_MAX_SLOTS 256 131 132 struct cdrom_mechstat_header { 133 #if defined(__BIG_ENDIAN_BITFIELD) 134 __u8 fault : 1; 135 __u8 changer_state : 2; 136 __u8 curslot : 5; 137 __u8 mech_state : 3; 138 __u8 door_open : 1; 139 __u8 reserved1 : 4; 140 #elif defined(__LITTLE_ENDIAN_BITFIELD) 141 __u8 curslot : 5; 142 __u8 changer_state : 2; 143 __u8 fault : 1; 144 __u8 reserved1 : 4; 145 __u8 door_open : 1; 146 __u8 mech_state : 3; 147 #endif 148 __u8 curlba[3]; 149 __u8 nslots; 150 __u16 slot_tablelen; 151 }; 152 153 struct cdrom_slot { 154 #if defined(__BIG_ENDIAN_BITFIELD) 155 __u8 disc_present : 1; 156 __u8 reserved1 : 6; 157 __u8 change : 1; 158 #elif defined(__LITTLE_ENDIAN_BITFIELD) 159 __u8 change : 1; 160 __u8 reserved1 : 6; 161 __u8 disc_present : 1; 162 #endif 163 __u8 reserved2[3]; 164 }; 165 166 struct cdrom_changer_info { 167 struct cdrom_mechstat_header hdr; 168 struct cdrom_slot slots[CDROM_MAX_SLOTS]; 169 }; 170 171 typedef enum { 172 mechtype_caddy = 0, 173 mechtype_tray = 1, 174 mechtype_popup = 2, 175 mechtype_individual_changer = 4, 176 mechtype_cartridge_changer = 5 177 } mechtype_t; 178 179 typedef struct { 180 #if defined(__BIG_ENDIAN_BITFIELD) 181 __u8 ps : 1; 182 __u8 reserved1 : 1; 183 __u8 page_code : 6; 184 __u8 page_length; 185 __u8 reserved2 : 1; 186 __u8 bufe : 1; 187 __u8 ls_v : 1; 188 __u8 test_write : 1; 189 __u8 write_type : 4; 190 __u8 multi_session : 2; /* or border, DVD */ 191 __u8 fp : 1; 192 __u8 copy : 1; 193 __u8 track_mode : 4; 194 __u8 reserved3 : 4; 195 __u8 data_block_type : 4; 196 #elif defined(__LITTLE_ENDIAN_BITFIELD) 197 __u8 page_code : 6; 198 __u8 reserved1 : 1; 199 __u8 ps : 1; 200 __u8 page_length; 201 __u8 write_type : 4; 202 __u8 test_write : 1; 203 __u8 ls_v : 1; 204 __u8 bufe : 1; 205 __u8 reserved2 : 1; 206 __u8 track_mode : 4; 207 __u8 copy : 1; 208 __u8 fp : 1; 209 __u8 multi_session : 2; /* or border, DVD */ 210 __u8 data_block_type : 4; 211 __u8 reserved3 : 4; 212 #endif 213 __u8 link_size; 214 __u8 reserved4; 215 #if defined(__BIG_ENDIAN_BITFIELD) 216 __u8 reserved5 : 2; 217 __u8 app_code : 6; 218 #elif defined(__LITTLE_ENDIAN_BITFIELD) 219 __u8 app_code : 6; 220 __u8 reserved5 : 2; 221 #endif 222 __u8 session_format; 223 __u8 reserved6; 224 __be32 packet_size; 225 __u16 audio_pause; 226 __u8 mcn[16]; 227 __u8 isrc[16]; 228 __u8 subhdr0; 229 __u8 subhdr1; 230 __u8 subhdr2; 231 __u8 subhdr3; 232 } __attribute__((packed)) write_param_page; 233 234 struct modesel_head 235 { 236 __u8 reserved1; 237 __u8 medium; 238 __u8 reserved2; 239 __u8 block_desc_length; 240 __u8 density; 241 __u8 number_of_blocks_hi; 242 __u8 number_of_blocks_med; 243 __u8 number_of_blocks_lo; 244 __u8 reserved3; 245 __u8 block_length_hi; 246 __u8 block_length_med; 247 __u8 block_length_lo; 248 }; 249 250 typedef struct { 251 __u16 report_key_length; 252 __u8 reserved1; 253 __u8 reserved2; 254 #if defined(__BIG_ENDIAN_BITFIELD) 255 __u8 type_code : 2; 256 __u8 vra : 3; 257 __u8 ucca : 3; 258 #elif defined(__LITTLE_ENDIAN_BITFIELD) 259 __u8 ucca : 3; 260 __u8 vra : 3; 261 __u8 type_code : 2; 262 #endif 263 __u8 region_mask; 264 __u8 rpc_scheme; 265 __u8 reserved3; 266 } rpc_state_t; 267 268 struct event_header { 269 __be16 data_len; 270 #if defined(__BIG_ENDIAN_BITFIELD) 271 __u8 nea : 1; 272 __u8 reserved1 : 4; 273 __u8 notification_class : 3; 274 #elif defined(__LITTLE_ENDIAN_BITFIELD) 275 __u8 notification_class : 3; 276 __u8 reserved1 : 4; 277 __u8 nea : 1; 278 #endif 279 __u8 supp_event_class; 280 }; 281 282 struct media_event_desc { 283 #if defined(__BIG_ENDIAN_BITFIELD) 284 __u8 reserved1 : 4; 285 __u8 media_event_code : 4; 286 __u8 reserved2 : 6; 287 __u8 media_present : 1; 288 __u8 door_open : 1; 289 #elif defined(__LITTLE_ENDIAN_BITFIELD) 290 __u8 media_event_code : 4; 291 __u8 reserved1 : 4; 292 __u8 door_open : 1; 293 __u8 media_present : 1; 294 __u8 reserved2 : 6; 295 #endif 296 __u8 start_slot; 297 __u8 end_slot; 298 }; 299 300 extern int cdrom_get_media_event(struct cdrom_device_info *cdi, struct media_event_desc *med); 301 302 static inline void lba_to_msf(int lba, u8 *m, u8 *s, u8 *f) 303 { 304 lba += CD_MSF_OFFSET; 305 lba &= 0xffffff; /* negative lbas use only 24 bits */ 306 *m = lba / (CD_SECS * CD_FRAMES); 307 lba %= (CD_SECS * CD_FRAMES); 308 *s = lba / CD_FRAMES; 309 *f = lba % CD_FRAMES; 310 } 311 312 static inline int msf_to_lba(u8 m, u8 s, u8 f) 313 { 314 return (((m * CD_SECS) + s) * CD_FRAMES + f) - CD_MSF_OFFSET; 315 } 316 #endif /* _LINUX_CDROM_H */ 317