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

文章目录

    • 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  > /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命令使用示例:
浅析Linux SCSI子系统:调试方法_第1张图片

SCSI trace events

SCSI子系统注册了一些trace events,这些trace events可以用来跟踪特定路径上的行为,已支持的trace events有:
在这里插入图片描述
这些trace events也可以在/sys/kernel/debug/tracing/events/scsi目录下找到:
浅析Linux SCSI子系统:调试方法_第2张图片

使能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 SCSI子系统:调试方法_第3张图片

相关参考

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

你可能感兴趣的:(#,存储IO栈,linux,SCSI)