drivers/scsi/scsi_logging.h

   1 #ifndef _SCSI_LOGGING_H
   2 #define _SCSI_LOGGING_H
   3
   4 #include <linux/config.h>
   5
   6 /*
   7  * This defines the scsi logging feature.  It is a means by which the user
   8  * can select how much information they get about various goings on, and it
   9  * can be really useful for fault tracing.  The logging word is divided into
  10  * 8 nibbles, each of which describes a loglevel.  The division of things is
  11  * somewhat arbitrary, and the division of the word could be changed if it
  12  * were really needed for any reason.  The numbers below are the only place
  13  * where these are specified.  For a first go-around, 3 bits is more than
  14  * enough, since this gives 8 levels of logging (really 7, since 0 is always
  15  * off).  Cutting to 2 bits might be wise at some point.
  16  */
  17
  18 #define SCSI_LOG_ERROR_SHIFT              0
  19 #define SCSI_LOG_TIMEOUT_SHIFT            3
  20 #define SCSI_LOG_SCAN_SHIFT               6
  21 #define SCSI_LOG_MLQUEUE_SHIFT            9
  22 #define SCSI_LOG_MLCOMPLETE_SHIFT         12
  23 #define SCSI_LOG_LLQUEUE_SHIFT            15
  24 #define SCSI_LOG_LLCOMPLETE_SHIFT         18
  25 #define SCSI_LOG_HLQUEUE_SHIFT            21
  26 #define SCSI_LOG_HLCOMPLETE_SHIFT         24
  27 #define SCSI_LOG_IOCTL_SHIFT              27
  28
  29 #define SCSI_LOG_ERROR_BITS               3
  30 #define SCSI_LOG_TIMEOUT_BITS             3
  31 #define SCSI_LOG_SCAN_BITS                3
  32 #define SCSI_LOG_MLQUEUE_BITS             3
  33 #define SCSI_LOG_MLCOMPLETE_BITS          3
  34 #define SCSI_LOG_LLQUEUE_BITS             3
  35 #define SCSI_LOG_LLCOMPLETE_BITS          3
  36 #define SCSI_LOG_HLQUEUE_BITS             3
  37 #define SCSI_LOG_HLCOMPLETE_BITS          3
  38 #define SCSI_LOG_IOCTL_BITS               3
  39
  40 extern unsigned int scsi_logging_level;
  41
  42 #ifdef CONFIG_SCSI_LOGGING
  43
  44 #define SCSI_LOG_LEVEL(SHIFT, BITS)                             \
  45         ((scsi_logging_level >> (SHIFT)) & ((1 << (BITS)) - 1))
  46
  47 #define SCSI_CHECK_LOGGING(SHIFT, BITS, LEVEL, CMD)             \
  48 do {                                                            \
  49         if (unlikely((SCSI_LOG_LEVEL(SHIFT, BITS)) > (LEVEL)))  \
  50                 do {                                            \
  51                         CMD;                                    \
  52                 } while (0);                                    \
  53 } while (0)
  54 #else
  55 #define SCSI_CHECK_LOGGING(SHIFT, BITS, LEVEL, CMD)
  56 #endif /* CONFIG_SCSI_LOGGING */
  57
  58 /*
  59  * These are the macros that are actually used throughout the code to
  60  * log events.  If logging isn't enabled, they are no-ops and will be
  61  * completely absent from the user's code.
  62  */
  63 #define SCSI_LOG_ERROR_RECOVERY(LEVEL,CMD)  \
  64         SCSI_CHECK_LOGGING(SCSI_LOG_ERROR_SHIFT, SCSI_LOG_ERROR_BITS, LEVEL,CMD);
  65 #define SCSI_LOG_TIMEOUT(LEVEL,CMD)  \
  66         SCSI_CHECK_LOGGING(SCSI_LOG_TIMEOUT_SHIFT, SCSI_LOG_TIMEOUT_BITS, LEVEL,CMD);
  67 #define SCSI_LOG_SCAN_BUS(LEVEL,CMD)  \
  68         SCSI_CHECK_LOGGING(SCSI_LOG_SCAN_SHIFT, SCSI_LOG_SCAN_BITS, LEVEL,CMD);
  69 #define SCSI_LOG_MLQUEUE(LEVEL,CMD)  \
  70         SCSI_CHECK_LOGGING(SCSI_LOG_MLQUEUE_SHIFT, SCSI_LOG_MLQUEUE_BITS, LEVEL,CMD);
  71 #define SCSI_LOG_MLCOMPLETE(LEVEL,CMD)  \
  72         SCSI_CHECK_LOGGING(SCSI_LOG_MLCOMPLETE_SHIFT, SCSI_LOG_MLCOMPLETE_BITS, LEVEL,CMD);
  73 #define SCSI_LOG_LLQUEUE(LEVEL,CMD)  \
  74         SCSI_CHECK_LOGGING(SCSI_LOG_LLQUEUE_SHIFT, SCSI_LOG_LLQUEUE_BITS, LEVEL,CMD);
  75 #define SCSI_LOG_LLCOMPLETE(LEVEL,CMD)  \
  76         SCSI_CHECK_LOGGING(SCSI_LOG_LLCOMPLETE_SHIFT, SCSI_LOG_LLCOMPLETE_BITS, LEVEL,CMD);
  77 #define SCSI_LOG_HLQUEUE(LEVEL,CMD)  \
  78         SCSI_CHECK_LOGGING(SCSI_LOG_HLQUEUE_SHIFT, SCSI_LOG_HLQUEUE_BITS, LEVEL,CMD);
  79 #define SCSI_LOG_HLCOMPLETE(LEVEL,CMD)  \
  80         SCSI_CHECK_LOGGING(SCSI_LOG_HLCOMPLETE_SHIFT, SCSI_LOG_HLCOMPLETE_BITS, LEVEL,CMD);
  81 #define SCSI_LOG_IOCTL(LEVEL,CMD)  \
  82         SCSI_CHECK_LOGGING(SCSI_LOG_IOCTL_SHIFT, SCSI_LOG_IOCTL_BITS, LEVEL,CMD);
  83
  84 #endif /* _SCSI_LOGGING_H */