通知器错误注入¶
通知器错误注入提供了向指定的通知器链回调注入人为错误的能力。它对于测试很少执行的通知器调用链故障的错误处理非常有用。有一些内核模块可用于测试以下通知器。
PM 通知器
内存热插拔通知器
powerpc pSeries 重新配置通知器
网络设备通知器
PM 通知器错误注入模块¶
此功能通过 debugfs 接口控制
/sys/kernel/debug/notifier-error-inject/pm/actions/<通知器事件>/error
可能发生故障的 PM 通知器事件有
PM_HIBERNATION_PREPARE
PM_SUSPEND_PREPARE
PM_RESTORE_PREPARE
示例：注入 PM 挂起错误 (-12 = -ENOMEM)
# cd /sys/kernel/debug/notifier-error-inject/pm/
# echo -12 > actions/PM_SUSPEND_PREPARE/error
# echo mem > /sys/power/state
bash: echo: write error: Cannot allocate memory
内存热插拔通知器错误注入模块¶
此功能通过 debugfs 接口控制
/sys/kernel/debug/notifier-error-inject/memory/actions/<通知器事件>/error
可能发生故障的内存通知器事件有
MEM_GOING_ONLINE
MEM_GOING_OFFLINE
示例：注入内存热插拔离线错误 (-12 == -ENOMEM)
# cd /sys/kernel/debug/notifier-error-inject/memory
# echo -12 > actions/MEM_GOING_OFFLINE/error
# echo offline > /sys/devices/system/memory/memoryXXX/state
bash: echo: write error: Cannot allocate memory
powerpc pSeries 重新配置通知器错误注入模块¶
此功能通过 debugfs 接口控制
/sys/kernel/debug/notifier-error-inject/pSeries-reconfig/actions/<通知器事件>/error
可能发生故障的 pSeries 重新配置通知器事件有
PSERIES_RECONFIG_ADD
PSERIES_RECONFIG_REMOVE
PSERIES_DRCONF_MEM_ADD
PSERIES_DRCONF_MEM_REMOVE
网络设备通知器错误注入模块¶
此功能通过 debugfs 接口控制
/sys/kernel/debug/notifier-error-inject/netdev/actions/<通知器事件>/error
可能发生故障的网络设备通知器事件有
NETDEV_REGISTER
NETDEV_CHANGEMTU
NETDEV_CHANGENAME
NETDEV_PRE_UP
NETDEV_PRE_TYPE_CHANGE
NETDEV_POST_INIT
NETDEV_PRECHANGEMTU
NETDEV_PRECHANGEUPPER
NETDEV_CHANGEUPPER
示例：注入网络设备 MTU 更改错误 (-22 == -EINVAL)
# cd /sys/kernel/debug/notifier-error-inject/netdev
# echo -22 > actions/NETDEV_CHANGEMTU/error
# ip link set eth0 mtu 1024
RTNETLINK answers: Invalid argument
更多使用示例¶
有一些 tools/testing/selftests 使用通知器错误注入功能来测试 CPU 和内存通知器。
tools/testing/selftests/cpu-hotplug/cpu-on-off-test.sh
tools/testing/selftests/memory-hotplug/mem-on-off-test.sh
这些脚本首先进行简单的上线和下线测试，然后在通知器错误注入模块可用时进行故障注入测试。