.\" Text automatically generated by txt2man
.TH netproc 8 "05 December 2021" "" "netproc man"
.SH NAME
\fBnetproc \fP- process-based network monitoring tool
.SH SYNOPSIS
.nf
.fam C
\fBnetproc\fP [\fB-B\fP] [\fB-c\fP] [\fB-f\fP [\fIfilename\fP]] [\fB-h\fP] [\fB-i\fP \fIiface\fP] [\fB-n\fP] [\fB-p\fP \fIudp\fP | \fItcp\fP] [\fB-v\fP]
        [\fB--si\fP]
.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
\fBnetproc\fP monitors network traffic and tries to find out which process
this traffic belongs to, this is useful to quickly know who is consuming
our network resources.
.PP
\fBnetproc\fP currently supports the TCP and UDP protocols over the IPv4 protocol.
.SH OPTIONS
.TP
.B
\fB-B\fP, \fB--bytes\fP
view in bytes, default in bits
.TP
.B
\fB-c\fP
visualization each active connection of the process
.TP
.B
\fB--color\fP 1|2|3
color scheme, 1 is default
.TP
.B
\fB-f\fP, \fB--file\fP "\fIfilename\fP"
save statistics in file, \fIfilename\fP is optional,
default is 'netproc.log'
.TP
.B
\fB-h\fP, \fB--help\fP
show this message
.TP
.B
\fB-i\fP, \fB--interface\fP \fIiface\fP
specifies an interface, default is all
(except interface with network 127.0.0.0/8)
.TP
.B
\fB-n\fP
numeric host and service, implicit '\fB-c\fP', try '\fB-nh\fP' to no
translate only host or '\fB-np\fP' to not translate only service
.TP
.B
\fB-p\fP, \fB--protocol\fP \fItcp\fP|\fIudp\fP
specifies a protocol, the default is \fItcp\fP and \fIudp\fP
.TP
.B
\fB--si\fP
show SI format, with powers of 1000, default is IEC,
with powers of 1024
.TP
.B
\fB-v\fP, \fB--verbose\fP
verbose mode, also show process without traffic
.TP
.B
\fB-V\fP, \fB--version\fP
show version
.SH RUNNING CONTROL

.TP
.B
arrow keys
scroll
.TP
.B
s
change column-based sort
.TP
.B
q
exit
.SH EXAMPLES
This command will display the ips / ports of the \fIudp\fP traffic of the processes,
monitoring all available interfaces, except the loopback, and log a summary
in the file "log.txt":
.PP
.nf
.fam C
    # netproc -p udp -c -f "log.txt"

.fam T
.fi
Useful to monitor the file generated in the above command:
.PP
.nf
.fam C
    $ watch -t -d 'cat log.txt'
    $ watch -t 'cut -c -$COLUMNS log.txt'

.fam T
.fi
Running whitout root:
.PP
.nf
.fam C
    $ sudo setcap "cap_net_admin,cap_net_raw+pe" /usr/local/sbin/netproc
    $ export PATH=$PATH:/usr/local/sbin

.fam T
.fi
.SH BUGS
Help improve this software, report bugs at
.PP
https://github.com/berghetti/\fBnetproc\fP/issues
.SH AUTHOR
Mayco Souza Berghetti <mayco.s.berghetti@gmail.com>
.SH COPYRIGHT
Copyright © 2020-2021 Mayco S. Berghetti. Licensed GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.