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