debug.h 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  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. #ifndef _DEBUG_H_
  27. #define _DEBUG_H_
  28. #include <linux/kernel.h>
  29. #define USB_STORAGE "usb-storage: "
  30. #ifdef CONFIG_USB_STORAGE_DEBUG
  31. void usb_stor_show_command(const struct us_data *us, struct scsi_cmnd *srb);
  32. void usb_stor_show_sense(const struct us_data *us, unsigned char key,
  33. unsigned char asc, unsigned char ascq);
  34. __printf(2, 3) void usb_stor_dbg(const struct us_data *us,
  35. const char *fmt, ...);
  36. #define US_DEBUG(x) x
  37. #else
  38. __printf(2, 3)
  39. static inline void _usb_stor_dbg(const struct us_data *us,
  40. const char *fmt, ...)
  41. {
  42. }
  43. #define usb_stor_dbg(us, fmt, ...) \
  44. do { if (0) _usb_stor_dbg(us, fmt, ##__VA_ARGS__); } while (0)
  45. #define US_DEBUG(x)
  46. #endif
  47. #endif