^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) /* SPDX-License-Identifier: GPL-2.0+ */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) /*
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) * Driver for USB Mass Storage compliant devices
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) * Protocol Functions Header File
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) * Current development and maintenance by:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) * (c) 1999, 2000 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) * This driver is based on the 'USB Mass Storage Class' document. This
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) * describes in detail the protocol used to communicate with such
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) * devices. Clearly, the designers had SCSI and ATAPI commands in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) * mind when they created this document. The commands are all very
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) * similar to commands in the SCSI-II and ATAPI specifications.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) * It is important to note that in a number of cases this class
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) * exhibits class-specific exemptions from the USB specification.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) * Notably the usage of NAK, STALL and ACK differs from the norm, in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) * that they are used to communicate wait, failed and OK on commands.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) *
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) * Also, for certain devices, the interrupt endpoint is used to convey
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) * status of a command.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) #ifndef _PROTOCOL_H_
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) #define _PROTOCOL_H_
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) /* Protocol handling routines */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) extern void usb_stor_pad12_command(struct scsi_cmnd*, struct us_data*);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) extern void usb_stor_ufi_command(struct scsi_cmnd*, struct us_data*);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30) extern void usb_stor_transparent_scsi_command(struct scsi_cmnd*,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) struct us_data*);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) /* struct scsi_cmnd transfer buffer access utilities */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) enum xfer_buf_dir {TO_XFER_BUF, FROM_XFER_BUF};
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) extern unsigned int usb_stor_access_xfer_buf(unsigned char *buffer,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) unsigned int buflen, struct scsi_cmnd *srb, struct scatterlist **,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38) unsigned int *offset, enum xfer_buf_dir dir);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40) extern void usb_stor_set_xfer_buf(unsigned char *buffer,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) unsigned int buflen, struct scsi_cmnd *srb);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) #endif