1/* SPDX-License-Identifier: GPL-2.0+ */
 2/*
 3 * Driver for USB Mass Storage compliant devices
 4 * Debugging Functions Header File
 5 *
 6 * Current development and maintenance by:
 7 *   (c) 1999-2002 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
 8 *
 9 * Initial work by:
10 *   (c) 1999 Michael Gee (michael@linuxspecific.com)
11 *
12 * This driver is based on the 'USB Mass Storage Class' document. This
13 * describes in detail the protocol used to communicate with such
14 * devices.  Clearly, the designers had SCSI and ATAPI commands in
15 * mind when they created this document.  The commands are all very
16 * similar to commands in the SCSI-II and ATAPI specifications.
17 *
18 * It is important to note that in a number of cases this class
19 * exhibits class-specific exemptions from the USB specification.
20 * Notably the usage of NAK, STALL and ACK differs from the norm, in
21 * that they are used to communicate wait, failed and OK on commands.
22 *
23 * Also, for certain devices, the interrupt endpoint is used to convey
24 * status of a command.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
25 */
26
27#ifndef _DEBUG_H_
28#define _DEBUG_H_
29
30#include <linux/kernel.h>
 
 
31
32#ifdef CONFIG_USB_STORAGE_DEBUG
33void usb_stor_show_command(const struct us_data *us, struct scsi_cmnd *srb);
34void usb_stor_show_sense(const struct us_data *us, unsigned char key,
35			 unsigned char asc, unsigned char ascq);
36__printf(2, 3) void usb_stor_dbg(const struct us_data *us,
37				 const char *fmt, ...);
38
39#define US_DEBUG(x)		x
40#else
41__printf(2, 3)
42static inline void _usb_stor_dbg(const struct us_data *us,
43				 const char *fmt, ...)
44{
45}
46#define usb_stor_dbg(us, fmt, ...)				\
47	do { if (0) _usb_stor_dbg(us, fmt, ##__VA_ARGS__); } while (0)
48#define US_DEBUG(x)
49#endif
50
51#endif

 1/* Driver for USB Mass Storage compliant devices
 
 
 2 * Debugging Functions Header File
 3 *
 4 * Current development and maintenance by:
 5 *   (c) 1999-2002 Matthew Dharm (mdharm-usb@one-eyed-alien.net)
 6 *
 7 * Initial work by:
 8 *   (c) 1999 Michael Gee (michael@linuxspecific.com)
 9 *
10 * This driver is based on the 'USB Mass Storage Class' document. This
11 * describes in detail the protocol used to communicate with such
12 * devices.  Clearly, the designers had SCSI and ATAPI commands in
13 * mind when they created this document.  The commands are all very
14 * similar to commands in the SCSI-II and ATAPI specifications.
15 *
16 * It is important to note that in a number of cases this class
17 * exhibits class-specific exemptions from the USB specification.
18 * Notably the usage of NAK, STALL and ACK differs from the norm, in
19 * that they are used to communicate wait, failed and OK on commands.
20 *
21 * Also, for certain devices, the interrupt endpoint is used to convey
22 * status of a command.
23 *
24 * Please see http://www.one-eyed-alien.net/~mdharm/linux-usb for more
25 * information about this driver.
26 *
27 * This program is free software; you can redistribute it and/or modify it
28 * under the terms of the GNU General Public License as published by the
29 * Free Software Foundation; either version 2, or (at your option) any
30 * later version.
31 *
32 * This program is distributed in the hope that it will be useful, but
33 * WITHOUT ANY WARRANTY; without even the implied warranty of
34 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
35 * General Public License for more details.
36 *
37 * You should have received a copy of the GNU General Public License along
38 * with this program; if not, write to the Free Software Foundation, Inc.,
39 * 675 Mass Ave, Cambridge, MA 02139, USA.
40 */
41
42#ifndef _DEBUG_H_
43#define _DEBUG_H_
44
45#include <linux/kernel.h>
46
47#define USB_STORAGE "usb-storage: "
48
49#ifdef CONFIG_USB_STORAGE_DEBUG
50void usb_stor_show_command(const struct us_data *us, struct scsi_cmnd *srb);
51void usb_stor_show_sense(const struct us_data *us, unsigned char key,
52			 unsigned char asc, unsigned char ascq);
53__printf(2, 3) void usb_stor_dbg(const struct us_data *us,
54				 const char *fmt, ...);
55
56#define US_DEBUG(x)		x
57#else
58__printf(2, 3)
59static inline void _usb_stor_dbg(const struct us_data *us,
60				 const char *fmt, ...)
61{
62}
63#define usb_stor_dbg(us, fmt, ...)				\
64	do { if (0) _usb_stor_dbg(us, fmt, ##__VA_ARGS__); } while (0)
65#define US_DEBUG(x)
66#endif
67
68#endif