浅析Linux SCSI子系统：调试方法

SCSI日志调试功能

SCSI子系统支持内核选项CONFIG_SCSI_LOGGING配置日志调试功能：

scsi_logging_level

scsi_logging_level定义为一个4字节的值，表示了SCSI的各种日志类型及对应的日志等级：

unsigned int scsi_logging_level;

scsi_logging_level被分成10个3位的字段，每个字段定义为一种日志类型，字段取值范围为0～7，表示了对应日志类型的打印等级。SCSI支持的日志类型如下：

• SCSI_LOG_ERROR
• SCSI_LOG_TIMEOUT_BITS
• SCSI_LOG_SCAN_BITS
• SCSI_LOG_MLQUEUE_BITS
• SCSI_LOG_MLCOMPLETE_BITS
• SCSI_LOG_LLQUEUE_BITS
• SCSI_LOG_LLCOMPLETE_BITS
• SCSI_LOG_HLQUEUE_BITS
• SCSI_LOG_HLCOMPLETE_BITS
• SCSI_LOG_IOCTL

调整SCSI日志等级

SCSI日志调试可以通过修改/proc/sys/devscsi/logging_level进行控制：

echo <bitmask> > /proc/sys/dev/scsi/logging_level   # 0表示关闭，-1表示全开

通过proc文件系统的方式需要手动计算bitmask，相对比较繁琐，lsscsi软件包提供了scsi_logging_level命令行工具来控制SCSI子系统的打印等级：

-s, --set：设置SCSI日志类型打印等级 
-g, --get： 获取当前SCSI日志类型等级设置
-a, --all：设置所有SCSI日志类型的打印等级
-E, --error ：设置SCSI_LOG_ERROR的打印等级
-T, --timeout：设置SCSI_LOG_TIMEOUT的打印等级
-S, --scan：设置SCSI_LOG_SCAN的打印等级
-M, --midlevel：设置SCSI_LOG_MLQUEUE和SCSI_LOG_MLCOMPLETE的打印等级
    --mlqueue：设置SCSI_LOG_MLQUEUE的打印等级
    --mlcomplete：设置SCSI_LOG_MLCOMPLETE的打印等级
-L, --lowlevel：设置SCSI_LOG_LLQUEUE和SCSI_LOG_LLCOMPLETE的打印等级
    --llqueue：设置SCSI_LOG_LLQUEUE的打印等级
    --llcomplete：设置SCSI_LOG_LLCOMPLETE的打印等级
-H, --highlevel：设置SCSI_LOG_HLQUEUE和SCSI_LOG_HLCOMPLETE的打印等级
    --hlqueue：设置SCSI_LOG_HLQUEUE的打印等级
    --hlcomplete：设置SCSI_LOG_HLCOMPLETE的打印等级
-I, --ioctl：设置SCSI_LOG_IOCTL的打印等级

scsi_logging_level命令使用示例：

SCSI trace events

SCSI子系统注册了一些trace events，这些trace events可以用来跟踪特定路径上的行为，已支持的trace events有：

这些trace events也可以在/sys/kernel/debug/tracing/events/scsi目录下找到：

使能SCSI trace events

方式一：通过set_event接口

* 使能特定的event：echo 'scsi_dispatch_cmd_done' > /sys/kernel/debug/tracing/set_event  
* 使能SCSI系统的所有event：echo 'scsi:*'  > /sys/kernel/debug/tracing/
* 禁用特定的event：echo '!scsi_dispatch_cmd_done' > /sys/kernel/debug/tracing/set_event 

方式二：通过enable

* 使能特定的event：echo 1 > /sys/kerne/debug/tracing/events/scsi/scsi_dispatch_cmd_done/enable
* 使能SCSI系统的所有event：echo 1 > /sys/kernel/debug/tracing/event/scsi/enable
* 禁用特定的event：echo '!scsi_dispatch_cmd_done' > /sys/kernel/debug/tracing/set_event 

跟踪trace信息

SCSI子系统注册的trace events有限，只能查看位于IO请求下发、返回的一些信息，对于日常问题定位可能帮助不大，但可以辅助用来分析SCSI的运行流程。

相关参考

• 《存储技术原理分析：基于Linux 2.6内核源代码分析》
• 深入浅出SCSI子系统
• Tracing event