LXR linux/include/linux/cdrom.h

   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
  18struct 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 */
  39struct 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
  68struct 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: */
  97extern int cdrom_open(struct cdrom_device_info *cdi, struct block_device *bdev,
  98                        fmode_t mode);
  99extern void cdrom_release(struct cdrom_device_info *cdi, fmode_t mode);
 100extern int cdrom_ioctl(struct cdrom_device_info *cdi, struct block_device *bdev,
 101                       fmode_t mode, unsigned int cmd, unsigned long arg);
 102extern unsigned int cdrom_check_events(struct cdrom_device_info *cdi,
 103                                       unsigned int clearing);
 104extern int cdrom_media_changed(struct cdrom_device_info *);
 105
 106extern int register_cdrom(struct cdrom_device_info *cdi);
 107extern void unregister_cdrom(struct cdrom_device_info *cdi);
 108
 109typedef struct {
 110    int data;
 111    int audio;
 112    int cdi;
 113    int xa;
 114    long error;
 115} tracktype;
 116
 117extern int cdrom_get_last_written(struct cdrom_device_info *cdi, long *last_written);
 118extern int cdrom_number_of_slots(struct cdrom_device_info *cdi);
 119extern int cdrom_mode_select(struct cdrom_device_info *cdi,
 120                             struct packet_command *cgc);
 121extern int cdrom_mode_sense(struct cdrom_device_info *cdi,
 122                            struct packet_command *cgc,
 123                            int page_code, int page_control);
 124extern void init_cdrom_command(struct packet_command *cgc,
 125                               void *buffer, int len, int type);
 126extern 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
 132struct 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
 153struct 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
 166struct cdrom_changer_info {
 167        struct cdrom_mechstat_header hdr;
 168        struct cdrom_slot slots[CDROM_MAX_SLOTS];
 169};
 170
 171typedef 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
 179typedef 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
 234struct 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
 250typedef 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
 268struct 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
 282struct 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
 300extern int cdrom_get_media_event(struct cdrom_device_info *cdi, struct media_event_desc *med);
 301
 302static 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
 312static 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