| .TH inject 8 "2018-03-16" "USER COMMANDS" |
| .SH NAME |
| inject \- injects appropriate error into function if input call chain and |
| predicates are satisfied. Uses Linux eBPF/bcc. |
| .SH SYNOPSIS |
| .B inject -h [-I header] [-P probability] [-v] mode spec |
| .SH DESCRIPTION |
| inject injects errors into specified kernel functionality when a given call |
| chain and associated predicates are satsified. |
| |
| WARNING: This tool injects failures into key kernel functions and may crash the |
| kernel. You should know what you're doing if you're using this tool. |
| |
| This makes use of a Linux 4.16 feature (bpf_override_return()) |
| |
| Since this uses BPF, only the root user can use this tool. |
| .SH REQUIREMENTS |
| CONFIG_BPF, CONFIG_BPF_KPROBE_OVERRIDE, bcc |
| .SH OPTIONS |
| .TP |
| \-h |
| Print usage message. |
| .TP |
| \-v |
| Display the generated BPF program, for debugging or modification. |
| .TP |
| \-I header |
| Necessary headers to be included. |
| .TP |
| \-P probability |
| Optional probability of failure, default 1. |
| .SH EXAMPLES |
| Please see inject_example.txt |
| .SH SOURCE |
| This is from bcc. |
| .IP |
| https://github.com/iovisor/bcc |
| .PP |
| Also look in the bcc distribution for a companion _examples.txt file containing |
| example usage, output, and commentary for this tool. |
| .SH OS |
| Linux |
| .SH STABILITY |
| Unstable - in development. |
| .SH AUTHOR |
| Howard McLauchlan |