LXR linux/drivers/scsi/sr.h

   1/* SPDX-License-Identifier: GPL-2.0 */
   2/*
   3 *      sr.h by David Giller
   4 *      CD-ROM disk driver header file
   5 *      
   6 *      adapted from:
   7 *      sd.h Copyright (C) 1992 Drew Eckhardt 
   8 *      SCSI disk driver header file by
   9 *              Drew Eckhardt 
  10 *
  11 *      <drew@colorado.edu>
  12 *
  13 *       Modified by Eric Youngdale eric@andante.org to
  14 *       add scatter-gather, multiple outstanding request, and other
  15 *       enhancements.
  16 */
  17
  18#ifndef _SR_H
  19#define _SR_H
  20
  21#include <linux/genhd.h>
  22#include <linux/kref.h>
  23
  24#define MAX_RETRIES     3
  25#define SR_TIMEOUT      (30 * HZ)
  26
  27struct scsi_device;
  28
  29/* The CDROM is fairly slow, so we need a little extra time */
  30/* In fact, it is very slow if it has to spin up first */
  31#define IOCTL_TIMEOUT 30*HZ
  32
  33
  34typedef struct scsi_cd {
  35        struct scsi_driver *driver;
  36        unsigned capacity;      /* size in blocks                       */
  37        struct scsi_device *device;
  38        unsigned int vendor;    /* vendor code, see sr_vendor.c         */
  39        unsigned long ms_offset;        /* for reading multisession-CD's        */
  40        unsigned writeable : 1;
  41        unsigned use:1;         /* is this device still supportable     */
  42        unsigned xa_flag:1;     /* CD has XA sectors ? */
  43        unsigned readcd_known:1;        /* drive supports READ_CD (0xbe) */
  44        unsigned readcd_cdda:1; /* reading audio data using READ_CD */
  45        unsigned media_present:1;       /* media is present */
  46
  47        /* GET_EVENT spurious event handling, blk layer guarantees exclusion */
  48        int tur_mismatch;               /* nr of get_event TUR mismatches */
  49        bool tur_changed:1;             /* changed according to TUR */
  50        bool get_event_changed:1;       /* changed according to GET_EVENT */
  51        bool ignore_get_event:1;        /* GET_EVENT is unreliable, use TUR */
  52
  53        struct cdrom_device_info cdi;
  54        /* We hold gendisk and scsi_device references on probe and use
  55         * the refs on this kref to decide when to release them */
  56        struct kref kref;
  57        struct gendisk *disk;
  58} Scsi_CD;
  59
  60#define sr_printk(prefix, cd, fmt, a...) \
  61        sdev_prefix_printk(prefix, (cd)->device, (cd)->cdi.name, fmt, ##a)
  62
  63int sr_do_ioctl(Scsi_CD *, struct packet_command *);
  64
  65int sr_lock_door(struct cdrom_device_info *, int);
  66int sr_tray_move(struct cdrom_device_info *, int);
  67int sr_drive_status(struct cdrom_device_info *, int);
  68int sr_disk_status(struct cdrom_device_info *);
  69int sr_get_last_session(struct cdrom_device_info *, struct cdrom_multisession *);
  70int sr_get_mcn(struct cdrom_device_info *, struct cdrom_mcn *);
  71int sr_reset(struct cdrom_device_info *);
  72int sr_select_speed(struct cdrom_device_info *cdi, int speed);
  73int sr_audio_ioctl(struct cdrom_device_info *, unsigned int, void *);
  74
  75int sr_is_xa(Scsi_CD *);
  76
  77/* sr_vendor.c */
  78void sr_vendor_init(Scsi_CD *);
  79int sr_cd_check(struct cdrom_device_info *);
  80int sr_set_blocklength(Scsi_CD *, int blocklength);
  81
  82#endif
  83