root/drivers/message/fusion/mptdebug.h
/* SPDX-License-Identifier: GPL-2.0 */
/*
 *  linux/drivers/message/fusion/mptdebug.h
 *      For use with LSI PCI chip/adapter(s)
 *      running LSI Fusion MPT (Message Passing Technology) firmware.
 *
 *  Copyright (c) 1999-2008 LSI Corporation
 *  (mailto:DL-MPTFusionLinux@lsi.com)
 *
 */
/*=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=*/

#ifndef MPTDEBUG_H_INCLUDED
#define MPTDEBUG_H_INCLUDED

/*
 * debug level can be programmed on the fly via SysFS (hex values)
 *
 * Example:  (programming for MPT_DEBUG_EVENTS on host 5)
 *
 * echo 8 > /sys/class/scsi_host/host5/debug_level
 *
 * --------------------------------------------------------
 * mpt_debug_level - command line parameter
 * this allow enabling debug at driver load time (for all iocs)
 *
 * Example  (programming for MPT_DEBUG_EVENTS)
 *
 * insmod mptbase.ko mpt_debug_level=8
 *
 * --------------------------------------------------------
 * CONFIG_FUSION_LOGGING - enables compiling debug into driver
 * this can be enabled in the driver Makefile
 *
 *
 * --------------------------------------------------------
 * Please note most debug prints are set to logging priority = debug
 * This is the lowest level, and most verbose.  Please refer to manual
 * pages for syslogd or syslogd-ng on how to configure this.
 */

#define MPT_DEBUG                       0x00000001
#define MPT_DEBUG_MSG_FRAME             0x00000002
#define MPT_DEBUG_SG                    0x00000004
#define MPT_DEBUG_EVENTS                0x00000008
#define MPT_DEBUG_VERBOSE_EVENTS        0x00000010
#define MPT_DEBUG_INIT                  0x00000020
#define MPT_DEBUG_EXIT                  0x00000040
#define MPT_DEBUG_FAIL                  0x00000080
#define MPT_DEBUG_TM                    0x00000100
#define MPT_DEBUG_DV                    0x00000200
#define MPT_DEBUG_REPLY                 0x00000400
#define MPT_DEBUG_HANDSHAKE             0x00000800
#define MPT_DEBUG_CONFIG                0x00001000
#define MPT_DEBUG_DL                    0x00002000
#define MPT_DEBUG_RESET                 0x00008000
#define MPT_DEBUG_SCSI                  0x00010000
#define MPT_DEBUG_IOCTL                 0x00020000
#define MPT_DEBUG_FC                    0x00080000
#define MPT_DEBUG_SAS                   0x00100000
#define MPT_DEBUG_SAS_WIDE              0x00200000
#define MPT_DEBUG_36GB_MEM              0x00400000

/*
 * CONFIG_FUSION_LOGGING - enabled in Kconfig
 */

#ifdef CONFIG_FUSION_LOGGING
#define MPT_CHECK_LOGGING(IOC, CMD, BITS)                       \
do {                                                            \
        if (IOC->debug_level & BITS)                            \
                CMD;                                            \
} while (0)
#else
#define MPT_CHECK_LOGGING(IOC, CMD, BITS)                       \
do { } while (0)
#endif


/*
 * debug macros
 */

#define dprintk(IOC, CMD)                       \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG)

#define dsgprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SG)

#define devtprintk(IOC, CMD)                    \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EVENTS)

#define devtverboseprintk(IOC, CMD)             \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_VERBOSE_EVENTS)

#define dinitprintk(IOC, CMD)                   \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_INIT)

#define dexitprintk(IOC, CMD)                   \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EXIT)

#define dfailprintk(IOC, CMD)                   \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_FAIL)

#define dtmprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_TM)

#define ddvprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_DV)

#define dreplyprintk(IOC, CMD)                  \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_REPLY)

#define dhsprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_HANDSHAKE)

#define dcprintk(IOC, CMD)                      \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_CONFIG)

#define ddlprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_DL)

#define drsprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_RESET)

#define dsprintk(IOC, CMD)                      \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SCSI)

#define dctlprintk(IOC, CMD)                    \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_IOCTL)

#define dfcprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_FC)

#define dsasprintk(IOC, CMD)                    \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SAS)

#define dsaswideprintk(IOC, CMD)                \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SAS_WIDE)

#define d36memprintk(IOC, CMD)          \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_36GB_MEM)


/*
 * Verbose logging
 */
#if defined(MPT_DEBUG_VERBOSE) && defined(CONFIG_FUSION_LOGGING)
static inline void
DBG_DUMP_FW_DOWNLOAD(MPT_ADAPTER *ioc, u32  *mfp, int numfrags)
{
        int i;

        if (!(ioc->debug_level & MPT_DEBUG))
                return;
        printk(KERN_DEBUG "F/W download request:\n");
        for (i=0; i < 7+numfrags*2; i++)
                printk(" %08x", le32_to_cpu(mfp[i]));
        printk("\n");
}

static inline void
DBG_DUMP_PUT_MSG_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
{
        int      ii, n;

        if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
                return;
        printk(KERN_DEBUG "%s: About to Put msg frame @ %p:\n",
                ioc->name, mfp);
        n = ioc->req_sz/4 - 1;
        while (mfp[n] == 0)
                n--;
        for (ii=0; ii<=n; ii++) {
                if (ii && ((ii%8)==0))
                        printk("\n");
                printk(" %08x", le32_to_cpu(mfp[ii]));
        }
        printk("\n");
}

static inline void
DBG_DUMP_FW_REQUEST_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
{
        int  i, n;

        if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
                return;
        n = 10;
        printk(KERN_INFO " ");
        for (i = 0; i < n; i++)
                printk(" %08x", le32_to_cpu(mfp[i]));
        printk("\n");
}

static inline void
DBG_DUMP_REQUEST_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
{
        int  i, n;

        if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
                return;
        n = 24;
        for (i=0; i<n; i++) {
                if (i && ((i%8)==0))
                        printk("\n");
                printk("%08x ", le32_to_cpu(mfp[i]));
        }
        printk("\n");
}

static inline void
DBG_DUMP_REPLY_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
{
        int  i, n;

        if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
                return;
        n = (le32_to_cpu(mfp[0]) & 0x00FF0000) >> 16;
        printk(KERN_INFO " ");
        for (i=0; i<n; i++)
                printk(" %08x", le32_to_cpu(mfp[i]));
        printk("\n");
}

static inline void
DBG_DUMP_REQUEST_FRAME_HDR(MPT_ADAPTER *ioc, u32 *mfp)
{
        int  i, n;

        if (!(ioc->debug_level & MPT_DEBUG_MSG_FRAME))
                return;
        n = 3;
        printk(KERN_INFO " ");
        for (i=0; i<n; i++)
                printk(" %08x", le32_to_cpu(mfp[i]));
        printk("\n");
}

static inline void
DBG_DUMP_TM_REQUEST_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
{
        int  i, n;

        if (!(ioc->debug_level & MPT_DEBUG_TM))
                return;
        n = 13;
        printk(KERN_DEBUG "TM_REQUEST:\n");
        for (i=0; i<n; i++) {
                if (i && ((i%8)==0))
                        printk("\n");
                printk("%08x ", le32_to_cpu(mfp[i]));
        }
        printk("\n");
}

static inline void
DBG_DUMP_TM_REPLY_FRAME(MPT_ADAPTER *ioc, u32 *mfp)
{
        int  i, n;

        if (!(ioc->debug_level & MPT_DEBUG_TM))
                return;
        n = (le32_to_cpu(mfp[0]) & 0x00FF0000) >> 16;
        printk(KERN_DEBUG "TM_REPLY MessageLength=%d:\n", n);
        for (i=0; i<n; i++) {
                if (i && ((i%8)==0))
                        printk("\n");
                printk(" %08x", le32_to_cpu(mfp[i]));
        }
        printk("\n");
}

#define dmfprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_MSG_FRAME)

# else /* ifdef MPT_DEBUG_MF */

#define DBG_DUMP_FW_DOWNLOAD(IOC, mfp, numfrags)
#define DBG_DUMP_PUT_MSG_FRAME(IOC, mfp)
#define DBG_DUMP_FW_REQUEST_FRAME(IOC, mfp)
#define DBG_DUMP_REQUEST_FRAME(IOC, mfp)
#define DBG_DUMP_REPLY_FRAME(IOC, mfp)
#define DBG_DUMP_REQUEST_FRAME_HDR(IOC, mfp)
#define DBG_DUMP_TM_REQUEST_FRAME(IOC, mfp)
#define DBG_DUMP_TM_REPLY_FRAME(IOC, mfp)

#define dmfprintk(IOC, CMD)                     \
        MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_MSG_FRAME)

#endif /* defined(MPT_DEBUG_VERBOSE) && defined(CONFIG_FUSION_LOGGING) */

#endif /* ifndef MPTDEBUG_H_INCLUDED */