drivers/message/fusion/mptdebug.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 /*
   3  *  linux/drivers/message/fusion/mptdebug.h
   4  *      For use with LSI PCI chip/adapter(s)
   5  *      running LSI Fusion MPT (Message Passing Technology) firmware.
   6  *
   7  *  Copyright (c) 1999-2008 LSI Corporation
   8  *  (mailto:DL-MPTFusionLinux@lsi.com)
   9  *
  10  */
  11 /*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/
  12
  13 #ifndef MPTDEBUG_H_INCLUDED
  14 #define MPTDEBUG_H_INCLUDED
  15
  16 /*
  17  * debug level can be programmed on the fly via SysFS (hex values)
  18  *
  19  * Example:  (programming for MPT_DEBUG_EVENTS on host 5)
  20  *
  21  * echo 8 > /sys/class/scsi_host/host5/debug_level
  22  *
  23  * --------------------------------------------------------
  24  * mpt_debug_level - command line parameter
  25  * this allow enabling debug at driver load time (for all iocs)
  26  *
  27  * Example  (programming for MPT_DEBUG_EVENTS)
  28  *
  29  * insmod mptbase.ko mpt_debug_level=8
  30  *
  31  * --------------------------------------------------------
  32  * CONFIG_FUSION_LOGGING - enables compiling debug into driver
  33  * this can be enabled in the driver Makefile
  34  *
  35  *
  36  * --------------------------------------------------------
  37  * Please note most debug prints are set to logging priority = debug
  38  * This is the lowest level, and most verbose.  Please refer to manual
  39  * pages for syslogd or syslogd-ng on how to configure this.
  40  */
  41
  42 #define MPT_DEBUG                       0x00000001
  43 #define MPT_DEBUG_MSG_FRAME             0x00000002
  44 #define MPT_DEBUG_SG                    0x00000004
  45 #define MPT_DEBUG_EVENTS                0x00000008
  46 #define MPT_DEBUG_VERBOSE_EVENTS        0x00000010
  47 #define MPT_DEBUG_INIT                  0x00000020
  48 #define MPT_DEBUG_EXIT                  0x00000040
  49 #define MPT_DEBUG_FAIL                  0x00000080
  50 #define MPT_DEBUG_TM                    0x00000100
  51 #define MPT_DEBUG_DV                    0x00000200
  52 #define MPT_DEBUG_REPLY                 0x00000400
  53 #define MPT_DEBUG_HANDSHAKE             0x00000800
  54 #define MPT_DEBUG_CONFIG                0x00001000
  55 #define MPT_DEBUG_DL                    0x00002000
  56 #define MPT_DEBUG_RESET                 0x00008000
  57 #define MPT_DEBUG_SCSI                  0x00010000
  58 #define MPT_DEBUG_IOCTL                 0x00020000
  59 #define MPT_DEBUG_FC                    0x00080000
  60 #define MPT_DEBUG_SAS                   0x00100000
  61 #define MPT_DEBUG_SAS_WIDE              0x00200000
  62 #define MPT_DEBUG_36GB_MEM              0x00400000
  63
  64 /*
  65  * CONFIG_FUSION_LOGGING - enabled in Kconfig
  66  */
  67
  68 #ifdef CONFIG_FUSION_LOGGING
  69 #define MPT_CHECK_LOGGING(IOC, CMD, BITS)                       \
  70 {                                                               \
  71         if (IOC->debug_level & BITS)                            \
  72                 CMD;                                            \
  73 }
  74 #else
  75 #define MPT_CHECK_LOGGING(IOC, CMD, BITS)
  76 #endif
  77
  78
  79 /*
  80  * debug macros
  81  */
  82
  83 #define dprintk(IOC, CMD)                       \
  84         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG)
  85
  86 #define dsgprintk(IOC, CMD)                     \
  87         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SG)
  88
  89 #define devtprintk(IOC, CMD)                    \
  90         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EVENTS)
  91
  92 #define devtverboseprintk(IOC, CMD)             \
  93         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_VERBOSE_EVENTS)
  94
  95 #define dinitprintk(IOC, CMD)                   \
  96         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_INIT)
  97
  98 #define dexitprintk(IOC, CMD)                   \
  99         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EXIT)
 100
 101 #define dfailprintk(IOC, CMD)                   \
 102         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_FAIL)
 103
 104 #define dtmprintk(IOC, CMD)                     \
 105         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_TM)
 106
 107 #define ddvprintk(IOC, CMD)                     \
 108         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_DV)
 109
 110 #define dreplyprintk(IOC, CMD)                  \
 111         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_REPLY)
 112
 113 #define dhsprintk(IOC, CMD)                     \
 114         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_HANDSHAKE)
 115
 116 #define dcprintk(IOC, CMD)                      \
 117         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_CONFIG)
 118
 119 #define ddlprintk(IOC, CMD)                     \
 120         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_DL)
 121
 122 #define drsprintk(IOC, CMD)                     \
 123         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_RESET)
 124
 125 #define dsprintk(IOC, CMD)                      \
 126         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SCSI)
 127
 128 #define dctlprintk(IOC, CMD)                    \
 129         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_IOCTL)
 130
 131 #define dfcprintk(IOC, CMD)                     \
 132         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_FC)
 133
 134 #define dsasprintk(IOC, CMD)                    \
 135         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SAS)
 136
 137 #define dsaswideprintk(IOC, CMD)                \
 138         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SAS_WIDE)
 139
 140 #define d36memprintk(IOC, CMD)          \
 141         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_36GB_MEM)
 142
 143
 144 /*
 145  * Verbose logging
 146  */
 147 #if defined(MPT_DEBUG_VERBOSE) && defined(CONFIG_FUSION_LOGGING)
 148 static inline void
 149 DBG_DUMP_FW_DOWNLOAD(MPT_ADAPTER *ioc, u32  *mfp, int numfrags)
 150 {
 151         int i;
 152
 153         if (!(ioc->debug_level & MPT_DEBUG))
 154                 return;
 155         printk(KERN_DEBUG "F/W download request:\n");
 156         for (i=0; i < 7+numfrags*2; i++)
 157                 printk(" %08x", le32_to_cpu(mfp[i]));
 158         printk("\n");
 159 }
 160
 161 static inline void
 162 DBG_DUMP_PUT_MSG_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
 163 {
 164         int      ii, n;
 165
 166         if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
 167                 return;
 168         printk(KERN_DEBUG "%s: About to Put msg frame @ %p:\n",
 169                 ioc->name, mfp);
 170         n = ioc->req_sz/4 - 1;
 171         while (mfp[n] == 0)
 172                 n--;
 173         for (ii=0; ii<=n; ii++) {
 174                 if (ii && ((ii%8)==0))
 175                         printk("\n");
 176                 printk(" %08x", le32_to_cpu(mfp[ii]));
 177         }
 178         printk("\n");
 179 }
 180
 181 static inline void
 182 DBG_DUMP_FW_REQUEST_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
 183 {
 184         int  i, n;
 185
 186         if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
 187                 return;
 188         n = 10;
 189         printk(KERN_INFO " ");
 190         for (i = 0; i < n; i++)
 191                 printk(" %08x", le32_to_cpu(mfp[i]));
 192         printk("\n");
 193 }
 194
 195 static inline void
 196 DBG_DUMP_REQUEST_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
 197 {
 198         int  i, n;
 199
 200         if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
 201                 return;
 202         n = 24;
 203         for (i=0; i<n; i++) {
 204                 if (i && ((i%8)==0))
 205                         printk("\n");
 206                 printk("%08x ", le32_to_cpu(mfp[i]));
 207         }
 208         printk("\n");
 209 }
 210
 211 static inline void
 212 DBG_DUMP_REPLY_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
 213 {
 214         int  i, n;
 215
 216         if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
 217                 return;
 218         n = (le32_to_cpu(mfp[0]) & 0x00FF0000) >> 16;
 219         printk(KERN_INFO " ");
 220         for (i=0; i<n; i++)
 221                 printk(" %08x", le32_to_cpu(mfp[i]));
 222         printk("\n");
 223 }
 224
 225 static inline void
 226 DBG_DUMP_REQUEST_FRAME_HDR(MPT_ADAPTER *ioc, u32 *mfp)
 227 {
 228         int  i, n;
 229
 230         if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
 231                 return;
 232         n = 3;
 233         printk(KERN_INFO " ");
 234         for (i=0; i<n; i++)
 235                 printk(" %08x", le32_to_cpu(mfp[i]));
 236         printk("\n");
 237 }
 238
 239 static inline void
 240 DBG_DUMP_TM_REQUEST_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
 241 {
 242         int  i, n;
 243
 244         if (!(ioc->debug_level & MPT_DEBUG_TM))
 245                 return;
 246         n = 13;
 247         printk(KERN_DEBUG "TM_REQUEST:\n");
 248         for (i=0; i<n; i++) {
 249                 if (i && ((i%8)==0))
 250                         printk("\n");
 251                 printk("%08x ", le32_to_cpu(mfp[i]));
 252         }
 253         printk("\n");
 254 }
 255
 256 static inline void
 257 DBG_DUMP_TM_REPLY_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
 258 {
 259         int  i, n;
 260
 261         if (!(ioc->debug_level & MPT_DEBUG_TM))
 262                 return;
 263         n = (le32_to_cpu(mfp[0]) & 0x00FF0000) >> 16;
 264         printk(KERN_DEBUG "TM_REPLY MessageLength=%d:\n", n);
 265         for (i=0; i<n; i++) {
 266                 if (i && ((i%8)==0))
 267                         printk("\n");
 268                 printk(" %08x", le32_to_cpu(mfp[i]));
 269         }
 270         printk("\n");
 271 }
 272
 273 #define dmfprintk(IOC, CMD)                     \
 274         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_MSG_FRAME)
 275
 276 # else /* ifdef MPT_DEBUG_MF */
 277
 278 #define DBG_DUMP_FW_DOWNLOAD(IOC, mfp, numfrags)
 279 #define DBG_DUMP_PUT_MSG_FRAME(IOC, mfp)
 280 #define DBG_DUMP_FW_REQUEST_FRAME(IOC, mfp)
 281 #define DBG_DUMP_REQUEST_FRAME(IOC, mfp)
 282 #define DBG_DUMP_REPLY_FRAME(IOC, mfp)
 283 #define DBG_DUMP_REQUEST_FRAME_HDR(IOC, mfp)
 284 #define DBG_DUMP_TM_REQUEST_FRAME(IOC, mfp)
 285 #define DBG_DUMP_TM_REPLY_FRAME(IOC, mfp)
 286
 287 #define dmfprintk(IOC, CMD)                     \
 288         MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_MSG_FRAME)
 289
 290 #endif /* defined(MPT_DEBUG_VERBOSE) && defined(CONFIG_FUSION_LOGGING) */
 291
 292 #endif /* ifndef MPTDEBUG_H_INCLUDED */