1inject(8)                   System Manager's Manual                  inject(8)
2
3
4

NAME

6       inject  -  injects  appropriate error into function if input call chain
7       and predicates are satisfied. Uses Linux eBPF/bcc.
8

SYNOPSIS

10       inject -h [-I header] [-P probability] [-v] [-C count] mode spec
11

DESCRIPTION

13       inject injects errors into specified kernel functionality when a  given
14       call chain and associated predicates are satsified.
15
16       WARNING:  This  tool injects failures into key kernel functions and may
17       crash the kernel. You should know what you're  doing  if  you're  using
18       this tool.
19
20       This makes use of a Linux 4.16 feature (bpf_override_return())
21
22       Since this uses BPF, only the root user can use this tool.
23

REQUIREMENTS

25       CONFIG_BPF, CONFIG_BPF_KPROBE_OVERRIDE, bcc
26

OPTIONS

28       -h     Print usage message.
29
30       -v     Display  the  generated  BPF program, for debugging or modifica‐
31              tion.
32
33       -I header
34              Necessary headers to be included.
35
36       -P probability
37              Optional probability of failure, default 1.
38
39       -C count
40              Number of errors to inject before stopping, default never stops.
41

EXAMPLES

43       Please see inject_example.txt
44

SOURCE

46       This is from bcc.
47
48              https://github.com/iovisor/bcc
49
50       Also look in the bcc distribution for a  companion  _examples.txt  file
51       containing example usage, output, and commentary for this tool.
52

OS

54       Linux
55

STABILITY

57       Unstable - in development.
58

AUTHOR

60       Howard McLauchlan
61
62
63
64USER COMMANDS                     2018-03-16                         inject(8)