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] 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

EXAMPLES

40       Please see inject_example.txt
41

SOURCE

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

OS

51       Linux
52

STABILITY

54       Unstable - in development.
55

AUTHOR

57       Howard McLauchlan
58
59
60
61USER COMMANDS                     2018-03-16                         inject(8)