1 // SPDX-License-Identifier: GPL-2.0+
3 * Driver for USB Mass Storage compliant devices
4 * Debugging Functions Source Code File
6 * Current development and maintenance by:
7 * (c) 1999-2002 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
9 * Developed with the assistance of:
10 * (c) 2002 Alan Stern <stern@rowland.org>
13 * (c) 1999 Michael Gee (michael@linuxspecific.com)
15 * This driver is based on the 'USB Mass Storage Class' document. This
16 * describes in detail the protocol used to communicate with such
17 * devices. Clearly, the designers had SCSI and ATAPI commands in
18 * mind when they created this document. The commands are all very
19 * similar to commands in the SCSI-II and ATAPI specifications.
21 * It is important to note that in a number of cases this class
22 * exhibits class-specific exemptions from the USB specification.
23 * Notably the usage of NAK, STALL and ACK differs from the norm, in
24 * that they are used to communicate wait, failed and OK on commands.
26 * Also, for certain devices, the interrupt endpoint is used to convey
27 * status of a command.
29 * Please see http://www.one-eyed-alien.net/~mdharm/linux-usb for more
30 * information about this driver.
33 #include <linux/device.h>
34 #include <linux/cdrom.h>
35 #include <linux/export.h>
36 #include <scsi/scsi.h>
37 #include <scsi/scsi_cmnd.h>
38 #include <scsi/scsi_dbg.h>
45 void usb_stor_show_command(const struct us_data
*us
, struct scsi_cmnd
*srb
)
49 switch (srb
->cmnd
[0]) {
50 case TEST_UNIT_READY
: what
= "TEST_UNIT_READY"; break;
51 case REZERO_UNIT
: what
= "REZERO_UNIT"; break;
52 case REQUEST_SENSE
: what
= "REQUEST_SENSE"; break;
53 case FORMAT_UNIT
: what
= "FORMAT_UNIT"; break;
54 case READ_BLOCK_LIMITS
: what
= "READ_BLOCK_LIMITS"; break;
55 case REASSIGN_BLOCKS
: what
= "REASSIGN_BLOCKS"; break;
56 case READ_6
: what
= "READ_6"; break;
57 case WRITE_6
: what
= "WRITE_6"; break;
58 case SEEK_6
: what
= "SEEK_6"; break;
59 case READ_REVERSE
: what
= "READ_REVERSE"; break;
60 case WRITE_FILEMARKS
: what
= "WRITE_FILEMARKS"; break;
61 case SPACE
: what
= "SPACE"; break;
62 case INQUIRY
: what
= "INQUIRY"; break;
63 case RECOVER_BUFFERED_DATA
: what
= "RECOVER_BUFFERED_DATA"; break;
64 case MODE_SELECT
: what
= "MODE_SELECT"; break;
65 case RESERVE
: what
= "RESERVE"; break;
66 case RELEASE
: what
= "RELEASE"; break;
67 case COPY
: what
= "COPY"; break;
68 case ERASE
: what
= "ERASE"; break;
69 case MODE_SENSE
: what
= "MODE_SENSE"; break;
70 case START_STOP
: what
= "START_STOP"; break;
71 case RECEIVE_DIAGNOSTIC
: what
= "RECEIVE_DIAGNOSTIC"; break;
72 case SEND_DIAGNOSTIC
: what
= "SEND_DIAGNOSTIC"; break;
73 case ALLOW_MEDIUM_REMOVAL
: what
= "ALLOW_MEDIUM_REMOVAL"; break;
74 case SET_WINDOW
: what
= "SET_WINDOW"; break;
75 case READ_CAPACITY
: what
= "READ_CAPACITY"; break;
76 case READ_10
: what
= "READ_10"; break;
77 case WRITE_10
: what
= "WRITE_10"; break;
78 case SEEK_10
: what
= "SEEK_10"; break;
79 case WRITE_VERIFY
: what
= "WRITE_VERIFY"; break;
80 case VERIFY
: what
= "VERIFY"; break;
81 case SEARCH_HIGH
: what
= "SEARCH_HIGH"; break;
82 case SEARCH_EQUAL
: what
= "SEARCH_EQUAL"; break;
83 case SEARCH_LOW
: what
= "SEARCH_LOW"; break;
84 case SET_LIMITS
: what
= "SET_LIMITS"; break;
85 case READ_POSITION
: what
= "READ_POSITION"; break;
86 case SYNCHRONIZE_CACHE
: what
= "SYNCHRONIZE_CACHE"; break;
87 case LOCK_UNLOCK_CACHE
: what
= "LOCK_UNLOCK_CACHE"; break;
88 case READ_DEFECT_DATA
: what
= "READ_DEFECT_DATA"; break;
89 case MEDIUM_SCAN
: what
= "MEDIUM_SCAN"; break;
90 case COMPARE
: what
= "COMPARE"; break;
91 case COPY_VERIFY
: what
= "COPY_VERIFY"; break;
92 case WRITE_BUFFER
: what
= "WRITE_BUFFER"; break;
93 case READ_BUFFER
: what
= "READ_BUFFER"; break;
94 case UPDATE_BLOCK
: what
= "UPDATE_BLOCK"; break;
95 case READ_LONG
: what
= "READ_LONG"; break;
96 case WRITE_LONG
: what
= "WRITE_LONG"; break;
97 case CHANGE_DEFINITION
: what
= "CHANGE_DEFINITION"; break;
98 case WRITE_SAME
: what
= "WRITE_SAME"; break;
99 case GPCMD_READ_SUBCHANNEL
: what
= "READ SUBCHANNEL"; break;
100 case READ_TOC
: what
= "READ_TOC"; break;
101 case GPCMD_READ_HEADER
: what
= "READ HEADER"; break;
102 case GPCMD_PLAY_AUDIO_10
: what
= "PLAY AUDIO (10)"; break;
103 case GPCMD_PLAY_AUDIO_MSF
: what
= "PLAY AUDIO MSF"; break;
104 case GPCMD_GET_EVENT_STATUS_NOTIFICATION
:
105 what
= "GET EVENT/STATUS NOTIFICATION"; break;
106 case GPCMD_PAUSE_RESUME
: what
= "PAUSE/RESUME"; break;
107 case LOG_SELECT
: what
= "LOG_SELECT"; break;
108 case LOG_SENSE
: what
= "LOG_SENSE"; break;
109 case GPCMD_STOP_PLAY_SCAN
: what
= "STOP PLAY/SCAN"; break;
110 case GPCMD_READ_DISC_INFO
: what
= "READ DISC INFORMATION"; break;
111 case GPCMD_READ_TRACK_RZONE_INFO
:
112 what
= "READ TRACK INFORMATION"; break;
113 case GPCMD_RESERVE_RZONE_TRACK
: what
= "RESERVE TRACK"; break;
114 case GPCMD_SEND_OPC
: what
= "SEND OPC"; break;
115 case MODE_SELECT_10
: what
= "MODE_SELECT_10"; break;
116 case GPCMD_REPAIR_RZONE_TRACK
: what
= "REPAIR TRACK"; break;
117 case 0x59: what
= "READ MASTER CUE"; break;
118 case MODE_SENSE_10
: what
= "MODE_SENSE_10"; break;
119 case GPCMD_CLOSE_TRACK
: what
= "CLOSE TRACK/SESSION"; break;
120 case 0x5C: what
= "READ BUFFER CAPACITY"; break;
121 case 0x5D: what
= "SEND CUE SHEET"; break;
122 case GPCMD_BLANK
: what
= "BLANK"; break;
123 case REPORT_LUNS
: what
= "REPORT LUNS"; break;
124 case MOVE_MEDIUM
: what
= "MOVE_MEDIUM or PLAY AUDIO (12)"; break;
125 case READ_12
: what
= "READ_12"; break;
126 case WRITE_12
: what
= "WRITE_12"; break;
127 case WRITE_VERIFY_12
: what
= "WRITE_VERIFY_12"; break;
128 case SEARCH_HIGH_12
: what
= "SEARCH_HIGH_12"; break;
129 case SEARCH_EQUAL_12
: what
= "SEARCH_EQUAL_12"; break;
130 case SEARCH_LOW_12
: what
= "SEARCH_LOW_12"; break;
131 case SEND_VOLUME_TAG
: what
= "SEND_VOLUME_TAG"; break;
132 case READ_ELEMENT_STATUS
: what
= "READ_ELEMENT_STATUS"; break;
133 case GPCMD_READ_CD_MSF
: what
= "READ CD MSF"; break;
134 case GPCMD_SCAN
: what
= "SCAN"; break;
135 case GPCMD_SET_SPEED
: what
= "SET CD SPEED"; break;
136 case GPCMD_MECHANISM_STATUS
: what
= "MECHANISM STATUS"; break;
137 case GPCMD_READ_CD
: what
= "READ CD"; break;
138 case 0xE1: what
= "WRITE CONTINUE"; break;
139 case WRITE_LONG_2
: what
= "WRITE_LONG_2"; break;
140 default: what
= "(unknown command)"; break;
142 usb_stor_dbg(us
, "Command %s (%d bytes)\n", what
, srb
->cmd_len
);
143 usb_stor_dbg(us
, "bytes: %*ph\n", min_t(int, srb
->cmd_len
, 16),
144 (const unsigned char *)srb
->cmnd
);
147 void usb_stor_show_sense(const struct us_data
*us
,
152 const char *what
, *keystr
, *fmt
;
154 keystr
= scsi_sense_key_string(key
);
155 what
= scsi_extd_sense_format(asc
, ascq
, &fmt
);
158 keystr
= "(Unknown Key)";
160 what
= "(unknown ASC/ASCQ)";
163 usb_stor_dbg(us
, "%s: %s (%s%x)\n", keystr
, what
, fmt
, ascq
);
165 usb_stor_dbg(us
, "%s: %s\n", keystr
, what
);
168 void usb_stor_dbg(const struct us_data
*us
, const char *fmt
, ...)
174 dev_vprintk_emit(LOGLEVEL_DEBUG
, &us
->pusb_dev
->dev
, fmt
, args
);
178 EXPORT_SYMBOL_GPL(usb_stor_dbg
);