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

NAME

6       bpfmon - BPF based visual packet rate monitor
7

SYNOPSIS

9       bpfmon
10
11       bpfmon [-autzvIiLlnNh] <device> '<bpf_filter_code>'
12
13       bpfmon [-autzvIiLlnNh] iptables '[<table>] <chain> <rulenum>'
14
15       bpfmon [-autzvIiLlnNh] iptables [select]
16

DESCRIPTION

18       bpfmon  (like tcpdump) uses BPF filter to select packets that match the
19       filter.  While with tcpdump it is easy to see what  packets  match  the
20       filter, bpfmon shows how much are the matches packets in terms of bytes
21       per second and packets per second.
22
23       bpfmon displays the information  in  pseudo-graphical  text  interface,
24       developed  for  modern  terminals, but it also supports pure ASCII dis‐
25       play.
26
27       In addition, bpfmon allows instead of monitoring packets matching a BPF
28       filter to get its data from an iptables rule (on Linux systems).
29
30       In  interactive  mode, there are hot keys to display help or modify the
31       mode of operation.
32
33       Without any arguments, bpfmon will  display  its  version  and  options
34       help.
35

OPTIONS

37       -a     Use ASCII drawing characters
38
39       -u     Use UTF-8 drawing characters
40
41       -t     Use no interface (simple text output)
42
43       -z     Use horizontal full-screen interface
44
45       -v     Use vertical full-screen interface
46
47       -I     Show history in vertical full-screen
48
49       -i     Hide history in vertical full-screen
50
51       -L     Show legend in vertical full-screen
52
53       -l     Hide  legend  in vertical full-screen -n Show interface white on
54              black
55
56       -N     Show interface inverse (black on white)
57
58       -h     Show usage information and exit
59

KEYBOARD SHORTCUTS

61       h, H, ?
62              Toggle help screen
63
64       a, A   switch to ASCII drawing chars
65
66       u, U   switch to UTF-8 drawing chars
67
68       m, M   toggle horizontal/vertical mode
69
70       i, I   toggle history in vertical mode
71
72       l, L   toggle legend in vertical mode
73
74       r, R, Ctrl-L
75              refresh screen
76
77       q, Q, Ctrl-C
78              Exit
79

SEE ALSO

81       tcpdump(8), bpf(4), pcap-filter(7)
82

AUTHOR

84       The bpfmon program was written by Boian Bonev from 2014 to 2020.
85
86       This manual page was written by Boian Bonev for the Debian project  and
87       is placed in the public domain.
88
89
90
91                                September 2020                       BPFMON(8)