当前位置：首页 > news >正文

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

news 2025/8/23 23:57:29

文章目录

- SCSI日志调试功能
- - scsi_logging_level
  - 调整SCSI日志等级
- SCSI trace events
- - 使能SCSI trace events
  - - 方式一：通过set_event接口
    - 方式二：通过enable
  - 跟踪trace信息
- 相关参考

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的运行流程。
在这里插入图片描述