netproc(8)

💖 netproc(8) — the manual, but make it slay 💖

okay bestie, welcome to netproc(8), the man page you're gonna actually read. grab a snack 🍓, we're doing this.

---

✨ NAME ✨

netproc — a process-based network monitoring tool. she watches the traffic and tells you which process it belongs to. main character energy, honestly. 👑

---

🦋 SYNOPSIS 🦋

netproc [-B] [-c] [-f [filename]] [-h] [-i iface] [-n] [-p udp | tcp] [-v]
        [--si]

---

🌸 DESCRIPTION 🌸

So basically netproc monitors network traffic and tries to figure out which process this traffic belongs to. it's literally the move when you wanna know, fast, who is out here eating all your network resources. no cap. 😭

as of right now, netproc supports the TCP and UDP protocols over the IPv4 protocol. that's the vibe. 💅

---

💅 OPTIONS 💅

• -B, --bytes — view stuff in bytes. default is bits, just so you know. 🔢
• -c — visualization of each active connection of the process. so you can see every single one, iconic. ✨
• --color 1|2|3 — pick your color scheme. 1 is the default. (yes, aesthetics matter. always.) 🌈
• -f, --file "filename" — save statistics into a file. filename is optional, and the default is 'netproc.log'. receipts, but on disk. 🎀
• -h, --help — show this message. hi, that's me, I'm the message. 🙈
• -i, --interface iface — specifies an interface. default is all of them, except the interface with network 127.0.0.0/8 (bye loopback, love you tho). 🦋
• -n — numeric host and service, and it's implicit -c. try -nh if you only wanna not translate the host, or -np if you only wanna not translate the service. iykyk. 💜
• -p, --protocol tcp|udp — specifies a protocol. default is tcp and udp, because why choose. 😌
• --si — show SI format, with powers of 1000. default is IEC, with powers of 1024. math is math. 🧚
• -v, --verbose — verbose mode. also shows processes without traffic. yes, the quiet ones too. 👀
• -V, --version — show version. 📌

---

🎮 RUNNING CONTROL 🎮

• arrow keys — scroll. move around, explore, live a little. 🌸
• s — change column-based sort. reorder the whole situation. 🔥
• q — exit. goodbye, you did great. 🫶

---

⭐ EXAMPLES ⭐

This command will display the ips / ports of the udp traffic of the processes, monitoring all available interfaces, except the loopback, and log a summary in the file "log.txt":

# netproc -p udp -c -f "log.txt"

Useful to monitor the file generated in the above command:

$ watch -t -d 'cat log.txt'
$ watch -t 'cut -c -$COLUMNS log.txt'

Running whitout root:

$ sudo setcap "cap_net_admin,cap_net_raw+pe" /usr/local/sbin/netproc
$ export PATH=$PATH:/usr/local/sbin

quick note bestie: that cap_net_admin,cap_net_raw+pe line is literally handing the binary some serious power so it can do the network thing without you living in sudo forever. use it responsibly, okay? 💛

---

💀 BUGS 💀

Help improve this software, report bugs at

https://github.com/berghetti/netproc/issues

be nice, be specific, be that girl. 🐛✨

---

👑 AUTHOR 👑

Mayco Souza Berghetti <mayco.s.berghetti@gmail.com>

---

📜 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.

---

okay so that's the whole thing 💖 huge shoutout to the netproc(8) manual — the source/version line says netproc(8), and it's dated 05 December 2021. like, a whole little time capsule. we love her, we respect her, periodt. 🎀🦋✨