netr 0.3.0

Display network interface throughput by second and by minute along with a graph. This is quick and easy to use via a mobile handset or similar device where typing is cumbersome.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

% NETR(1) net user manual
% Ed Neville (ed-netr@s5h.net)
% 07 Dec 2020

# NAME

netr - a simple tool to display network throughput

# SYNOPSIS

```
netr
```

# DESCRIPTION

netr shows a list of network interfaces and their throughput per second and minute.

Input (I) and output (O) are separated in the graph.

Exit by killing the process with ctrl-c.

# INTERFACE MATCHING

Interface names can be provided as regex matches to **include** or **exclude** for reporting.

# COUNTERS

For use with programs such as MRTG the interface counters can be printed, using the regex inclusion filter:

```
netr --counters --include eth0
```

If you have multiple interfaces where numbering/naming may be overly inclusive then the names can use regex anchors:

```
netr --counters --include ^eth0$
```

The script `mrtg_cfg.pl` can be used to generate basic MRTG config and index files:

```
perl mrtg_cfg.pl www ^eth0$ > mrtg.cfg
mrtg mrtg.cfg
```

# OUTPUT FORMAT

The follow strings are supported with `--format`:

| placeholder | effect |
|-------------|--------|
| %{if}       | Interface name, eg 'enp1s0' |
| %{ibytes}   | Interface input bytes |
| %{obytes}   | Interface output bytes |
| %{ipackets} | Interface input packets |
| %{opackets} | Interface output packets |
| \\`n` | line feed |
| \\`r` | carriage return |
| \\`t` | tab |

Usage of a format string will simply output and exit.

# CONTRIBUTIONS

I welcome pull requests with open arms.