write in 30M

hc

2024-02-20 ea08eeccae9297f7aabd2ef7f0c2517ac4549acc

 kernel/Documentation/fault-injection/fault-injection.rst
..
..
@@ -78,8 +78,8 @@
78
78
 
79
79
 - /sys/kernel/debug/fail*/times:
80
80
 
81
-	specifies how many times failures may happen at most.
82
-	A value of -1 means "no limit".
81
+	specifies how many times failures may happen at most. A value of -1
82
+	means "no limit".
83
83
 
84
84
 - /sys/kernel/debug/fail*/space:
85
85
 
..
..
@@ -167,11 +167,13 @@
167
167
 	- ERRNO: retval must be -1 to -MAX_ERRNO (-4096).
168
168
 	- ERR_NULL: retval must be 0 or -1 to -MAX_ERRNO (-4096).
169
169
 
170
-- /sys/kernel/debug/fail_function/<functiuon-name>/retval:
170
+- /sys/kernel/debug/fail_function/<function-name>/retval:
171
171
 
172
-	specifies the "error" return value to inject to the given
173
-	function for given function. This will be created when
174
-	user specifies new injection entry.
172
+	specifies the "error" return value to inject to the given function.
173
+	This will be created when the user specifies a new injection entry.
174
+	Note that this file only accepts unsigned values. So, if you want to
175
+	use a negative errno, you better use 'printf' instead of 'echo', e.g.:
176
+	$ printf %#x -12 > retval
175
177
 
176
178
 Boot option
177
179
 ^^^^^^^^^^^
..
..
@@ -336,7 +338,7 @@
336
338
     FAILTYPE=fail_function
337
339
     FAILFUNC=open_ctree
338
340
     echo $FAILFUNC > /sys/kernel/debug/$FAILTYPE/inject
339
-    echo -12 > /sys/kernel/debug/$FAILTYPE/$FAILFUNC/retval
341
+    printf %#x -12 > /sys/kernel/debug/$FAILTYPE/$FAILFUNC/retval
340
342
     echo N > /sys/kernel/debug/$FAILTYPE/task-filter
341
343
     echo 100 > /sys/kernel/debug/$FAILTYPE/probability
342
344
     echo 0 > /sys/kernel/debug/$FAILTYPE/interval