/* SPDX-License-Identifier: GPL-2.0+ */ /* * Driver for USB Mass Storage compliant devices * Main Header File * * Current development and maintenance by: * (c) 1999-2002 Matthew Dharm ([email protected]) * * Initial work by: * (c) 1999 Michael Gee ([email protected]) * * This driver is based on the 'USB Mass Storage Class' document. This * describes in detail the protocol used to communicate with such * devices. Clearly, the designers had SCSI and ATAPI commands in * mind when they created this document. The commands are all very * similar to commands in the SCSI-II and ATAPI specifications. * * It is important to note that in a number of cases this class * exhibits class-specific exemptions from the USB specification. * Notably the usage of NAK, STALL and ACK differs from the norm, in * that they are used to communicate wait, failed and OK on commands. * * Also, for certain devices, the interrupt endpoint is used to convey * status of a command. */ #ifndef _USB_H_ #define _USB_H_ #include <linux/usb.h> #include <linux/usb_usual.h> #include <linux/blkdev.h> #include <linux/completion.h> #include <linux/mutex.h> #include <linux/workqueue.h> #include <scsi/scsi_host.h> struct us_data; struct scsi_cmnd; /* * Unusual device list definitions */ struct us_unusual_dev { … }; /* Dynamic bitflag definitions (us->dflags): used in set_bit() etc. */ #define US_FLIDX_URB_ACTIVE … #define US_FLIDX_SG_ACTIVE … #define US_FLIDX_ABORTING … #define US_FLIDX_DISCONNECTING … #define US_FLIDX_RESETTING … #define US_FLIDX_TIMED_OUT … #define US_FLIDX_SCAN_PENDING … #define US_FLIDX_REDO_READ10 … #define US_FLIDX_READ10_WORKED … #define USB_STOR_STRING_LEN … /* * We provide a DMA-mapped I/O buffer for use with small USB transfers. * It turns out that CB[I] needs a 12-byte buffer and Bulk-only needs a * 31-byte buffer. But Freecom needs a 64-byte buffer, so that's the * size we'll allocate. */ #define US_IOBUF_SIZE … #define US_SENSE_SIZE … trans_cmnd; trans_reset; proto_cmnd; extra_data_destructor; /* extra data destructor */ pm_hook; /* power management hook */ #define US_SUSPEND … #define US_RESUME … /* we allocate one of these for every device that we remember */ struct us_data { … }; /* Convert between us_data and the corresponding Scsi_Host */ static inline struct Scsi_Host *us_to_host(struct us_data *us) { … } static inline struct us_data *host_to_us(struct Scsi_Host *host) { … } /* Function to fill an inquiry response. See usb.c for details */ extern void fill_inquiry_response(struct us_data *us, unsigned char *data, unsigned int data_len); /* * The scsi_lock() and scsi_unlock() macros protect the sm_state and the * single queue element srb for write access */ #define scsi_unlock(host) … #define scsi_lock(host) … /* General routines provided by the usb-storage standard core */ #ifdef CONFIG_PM extern int usb_stor_suspend(struct usb_interface *iface, pm_message_t message); extern int usb_stor_resume(struct usb_interface *iface); extern int usb_stor_reset_resume(struct usb_interface *iface); #else #define usb_stor_suspend … #define usb_stor_resume … #define usb_stor_reset_resume … #endif extern int usb_stor_pre_reset(struct usb_interface *iface); extern int usb_stor_post_reset(struct usb_interface *iface); extern int usb_stor_probe1(struct us_data **pus, struct usb_interface *intf, const struct usb_device_id *id, const struct us_unusual_dev *unusual_dev, const struct scsi_host_template *sht); extern int usb_stor_probe2(struct us_data *us); extern void usb_stor_disconnect(struct usb_interface *intf); extern void usb_stor_adjust_quirks(struct usb_device *dev, u64 *fflags); #define module_usb_stor_driver(__driver, __sht, __name) … #endif
Codebase Browser
linux