2 # SPDX-License-Identifier: GPL-2.0
5 # failcmd.sh - run a command with injecting slab/page allocation failures
9 # failcmd.sh [<options>] command [arguments]
12 # Run command with injecting slab/page allocation failures by fault
15 # NOTE: you need to run this script as root.
21 Usage: $0 [options] command [arguments]
26 likelihood of failure injection, in percent.
31 specifies how many times failures may happen at most.
34 --oom-kill-allocating-task=value
35 set /proc/sys/vm/oom_kill_allocating_task to specified value
36 before running the command.
40 Display a usage message and exit
42 --interval=value, --space=value, --verbose=value, --task-filter=value,
43 --stacktrace-depth=value, --require-start=value, --require-end=value,
44 --reject-start=value, --reject-end=value, --ignore-gfp-wait=value
45 See Documentation/fault-injection/fault-injection.rst for more
51 fail_page_alloc options:
52 --ignore-gfp-highmem=value, --min-order=value
56 The following values for FAILCMD_TYPE are recognized:
59 inject slab allocation failures
61 inject page allocation failures
63 If FAILCMD_TYPE is not defined, then failslab is used.
67 if [ $UID != 0 ]; then
68 echo must be run as root >&2
72 DEBUGFS=`mount -t debugfs | head -1 | awk '{ print $3}'`
74 if [ ! -d "$DEBUGFS" ]; then
75 echo debugfs is not mounted >&2
79 FAILCMD_TYPE=${FAILCMD_TYPE:-failslab}
80 FAULTATTR=$DEBUGFS/$FAILCMD_TYPE
82 if [ ! -d $FAULTATTR ]; then
83 echo $FAILCMD_TYPE is not available >&2
87 LONGOPTS=probability:,interval:,times:,space:,verbose:,task-filter:
88 LONGOPTS=$LONGOPTS,stacktrace-depth:,require-start:,require-end:
89 LONGOPTS=$LONGOPTS,reject-start:,reject-end:,oom-kill-allocating-task:,help
91 if [ $FAILCMD_TYPE = failslab ]; then
92 LONGOPTS=$LONGOPTS,ignore-gfp-wait:,cache-filter:
93 elif [ $FAILCMD_TYPE = fail_page_alloc ]; then
94 LONGOPTS=$LONGOPTS,ignore-gfp-wait:,ignore-gfp-highmem:,min-order:
97 TEMP=`getopt -o p:i:t:s:v:h --long $LONGOPTS -n 'failcmd.sh' -- "$@"`
108 echo N > $FAULTATTR/task-filter
109 echo 0 > $FAULTATTR/probability
110 echo 1 > $FAULTATTR/times
115 oom_kill_allocating_task_saved=`cat /proc/sys/vm/oom_kill_allocating_task`
120 echo $oom_kill_allocating_task_saved \
121 > /proc/sys/vm/oom_kill_allocating_task
127 declare -i oom_kill_allocating_task=1
128 declare task_filter=Y
129 declare -i probability=1
139 echo $2 > $FAULTATTR/interval
147 echo $2 > $FAULTATTR/space
151 echo $2 > $FAULTATTR/verbose
159 echo $2 > $FAULTATTR/stacktrace-depth
163 echo $2 > $FAULTATTR/require-start
167 echo $2 > $FAULTATTR/require-end
171 echo $2 > $FAULTATTR/reject-start
175 echo $2 > $FAULTATTR/reject-end
178 --oom-kill-allocating-task)
179 oom_kill_allocating_task=$2
183 echo $2 > $FAULTATTR/ignore-gfp-wait
187 echo $2 > $FAULTATTR/cache_filter
190 --ignore-gfp-highmem)
191 echo $2 > $FAULTATTR/ignore-gfp-highmem
195 echo $2 > $FAULTATTR/min-order
210 [ -z "$1" ] && exit 0
212 echo $oom_kill_allocating_task > /proc/sys/vm/oom_kill_allocating_task
213 echo $task_filter > $FAULTATTR/task-filter
214 echo $probability > $FAULTATTR/probability
215 echo $times > $FAULTATTR/times
217 trap "restore_values" SIGINT SIGTERM EXIT
219 cmd="echo 1 > /proc/self/make-it-fail && exec $@"