[linux.git] / drivers / scsi / sr.h

/* SPDX-License-Identifier: GPL-2.0 */
/*
 *      sr.h by David Giller
 *      CD-ROM disk driver header file
 *      
 *      adapted from:
 *      sd.h Copyright (C) 1992 Drew Eckhardt 
 *      SCSI disk driver header file by
 *              Drew Eckhardt 
 *
 *      <[email protected]>
 *
 *       Modified by Eric Youngdale [email protected] to
 *       add scatter-gather, multiple outstanding request, and other
 *       enhancements.
 */

#ifndef _SR_H
#define _SR_H

#include <linux/genhd.h>
#include <linux/kref.h>
#include <linux/mutex.h>

#define MAX_RETRIES	3
#define SR_TIMEOUT	(30 * HZ)

struct scsi_device;

/* The CDROM is fairly slow, so we need a little extra time */
/* In fact, it is very slow if it has to spin up first */
#define IOCTL_TIMEOUT 30*HZ


typedef struct scsi_cd {
	struct scsi_driver *driver;
	unsigned capacity;	/* size in blocks                       */
	struct scsi_device *device;
	unsigned int vendor;	/* vendor code, see sr_vendor.c         */
	unsigned long ms_offset;	/* for reading multisession-CD's        */
	unsigned writeable : 1;
	unsigned use:1;		/* is this device still supportable     */
	unsigned xa_flag:1;	/* CD has XA sectors ? */
	unsigned readcd_known:1;	/* drive supports READ_CD (0xbe) */
	unsigned readcd_cdda:1;	/* reading audio data using READ_CD */
	unsigned media_present:1;	/* media is present */

	/* GET_EVENT spurious event handling, blk layer guarantees exclusion */
	int tur_mismatch;		/* nr of get_event TUR mismatches */
	bool tur_changed:1;		/* changed according to TUR */
	bool get_event_changed:1;	/* changed according to GET_EVENT */
	bool ignore_get_event:1;	/* GET_EVENT is unreliable, use TUR */

	struct cdrom_device_info cdi;
	struct mutex lock;
	/* We hold gendisk and scsi_device references on probe and use
	 * the refs on this kref to decide when to release them */
	struct kref kref;
	struct gendisk *disk;
} Scsi_CD;

#define sr_printk(prefix, cd, fmt, a...) \
	sdev_prefix_printk(prefix, (cd)->device, (cd)->cdi.name, fmt, ##a)

int sr_do_ioctl(Scsi_CD *, struct packet_command *);

int sr_lock_door(struct cdrom_device_info *, int);
int sr_tray_move(struct cdrom_device_info *, int);
int sr_drive_status(struct cdrom_device_info *, int);
int sr_disk_status(struct cdrom_device_info *);
int sr_get_last_session(struct cdrom_device_info *, struct cdrom_multisession *);
int sr_get_mcn(struct cdrom_device_info *, struct cdrom_mcn *);
int sr_reset(struct cdrom_device_info *);
int sr_select_speed(struct cdrom_device_info *cdi, int speed);
int sr_audio_ioctl(struct cdrom_device_info *, unsigned int, void *);

int sr_is_xa(Scsi_CD *);

/* sr_vendor.c */
void sr_vendor_init(Scsi_CD *);
int sr_cd_check(struct cdrom_device_info *);
int sr_set_blocklength(Scsi_CD *, int blocklength);

#endif
Commit	Line	Data
b2441318	1	/* SPDX-License-Identifier: GPL-2.0 */
1da177e4 LT	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	* <[email protected]>
	12	*
	13	* Modified by Eric Youngdale [email protected] 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>
51a85881	23	#include <linux/mutex.h>
1da177e4	24
210ba1d1 JB	25	#define MAX_RETRIES 3
	26	#define SR_TIMEOUT (30 * HZ)
	27
1da177e4 LT	28	struct scsi_device;
	29
	30	/* The CDROM is fairly slow, so we need a little extra time */
	31	/* In fact, it is very slow if it has to spin up first */
	32	#define IOCTL_TIMEOUT 30*HZ
	33
	34
	35	typedef struct scsi_cd {
	36	struct scsi_driver *driver;
	37	unsigned capacity; /* size in blocks */
	38	struct scsi_device *device;
	39	unsigned int vendor; /* vendor code, see sr_vendor.c */
	40	unsigned long ms_offset; /* for reading multisession-CD's */
fd2eb903	41	unsigned writeable : 1;
1da177e4 LT	42	unsigned use:1; /* is this device still supportable */
	43	unsigned xa_flag:1; /* CD has XA sectors ? */
	44	unsigned readcd_known:1; /* drive supports READ_CD (0xbe) */
	45	unsigned readcd_cdda:1; /* reading audio data using READ_CD */
93aae17a	46	unsigned media_present:1; /* media is present */
79b9677d KS	47
	48	/* GET_EVENT spurious event handling, blk layer guarantees exclusion */
	49	int tur_mismatch; /* nr of get_event TUR mismatches */
	50	bool tur_changed:1; /* changed according to TUR */
	51	bool get_event_changed:1; /* changed according to GET_EVENT */
	52	bool ignore_get_event:1; /* GET_EVENT is unreliable, use TUR */
	53
1da177e4	54	struct cdrom_device_info cdi;
51a85881	55	struct mutex lock;
1da177e4 LT	56	/* We hold gendisk and scsi_device references on probe and use
	57	* the refs on this kref to decide when to release them */
	58	struct kref kref;
	59	struct gendisk *disk;
	60	} Scsi_CD;
	61
96eefad2	62	#define sr_printk(prefix, cd, fmt, a...) \
22e0d994	63	sdev_prefix_printk(prefix, (cd)->device, (cd)->cdi.name, fmt, ##a)
96eefad2	64
1da177e4 LT	65	int sr_do_ioctl(Scsi_CD , struct packet_command );
	66
	67	int sr_lock_door(struct cdrom_device_info *, int);
	68	int sr_tray_move(struct cdrom_device_info *, int);
	69	int sr_drive_status(struct cdrom_device_info *, int);
	70	int sr_disk_status(struct cdrom_device_info *);
	71	int sr_get_last_session(struct cdrom_device_info , struct cdrom_multisession );
	72	int sr_get_mcn(struct cdrom_device_info , struct cdrom_mcn );
	73	int sr_reset(struct cdrom_device_info *);
	74	int sr_select_speed(struct cdrom_device_info *cdi, int speed);
	75	int sr_audio_ioctl(struct cdrom_device_info , unsigned int, void );
1da177e4 LT	76
	77	int sr_is_xa(Scsi_CD *);
	78
	79	/* sr_vendor.c */
	80	void sr_vendor_init(Scsi_CD *);
	81	int sr_cd_check(struct cdrom_device_info *);
	82	int sr_set_blocklength(Scsi_CD *, int blocklength);
	83
	84	#endif