IPTOTAL_CONFIG(5)

💖 IPTOTAL_CONFIG — the iptotal config file, bestie edition 💖

okay so this is the manual page for iptotal_config, aka the config file for iptotal. it lives in section 5 (File Formats Manual) which is fancy-speak for "this is a file, not a command, don't @ me". sit down, grab a strawberry drink 🍓, and let's get into it.

---

✨ NAME ✨

iptotal_config — literally just the iptotal configuration file. that's it. that's the name. iconic 💅

---

🌸 SYNOPSIS 🌸

/etc/iptotal.cfg

she's a path. she's the path. no flags, no drama, just vibes 🦋

---

👑 DESCRIPTION 👑

so iptotal pulls all its config data from /etc/iptotal.cfg — OR from whatever other file you point at it with -c on the command line, because bestie gets choices.

the file is made up of keyword-argument pairs, one per line. that's the whole format. no brackets, no semicolons, no suffering.

lines that start with # are comments. empty lines are also comments. the parser is very forgiving, periodt.

🫶 quick lil heads up before we go through every single keyword: the keywords are case-insensitive, but the arguments are case-sensitive. so DEBUG and debug both work, but Eth0 and eth0 are not the same girl. write that down.

here's the full lineup of keywords and what they mean:

• debug <level> — how much tea iptotal spills about what it's doing. 0 means no debugging at all (silent queen), 1 gives you a summary, and 3 logs literally every packet captured (main character energy, extremely chatty). default is 0.
• interface <interface> — the network interface iptotal is gonna monitor. the default is eth0.
• filter <filterstr> — lets you drop in pcap filters so you only capture the traffic you actually care about. peep tcpdump if you need the filter syntax, she's the blueprint.
• fork <choice> — "no" runs it in the foreground (you get to watch), "yes" runs it in the background (it dips, respectfully). the default is "no".
• maskbits <maskbits> — sets the number of network mask bits, valid range 1–32, used for subnet traffic aggregation. default is 24, which is 255.255.255.0 if you're a dotted-decimal girly.
• report <seconds> — the reporting period, measured in seconds. default is 300.

---

🎀 FILES 🎀

• /etc/iptotal.cfg — the file that defines the configuration used to invoke iptotal(1). yeah it's the same path as the synopsis, no your eyes aren't broken 😭

---

💜 AUTHOR 💜

Written by Antoine Megens <webmaster@dingetje.homeip.net>

Manpage written by Millis Miller <millis@faztek.org>

two queens, one manpage ✨

---

🙈 REPORTING BUGS 🙈

found a bug? not me finding bugs 😭 report them to <webmaster@dingetje.homeip.net> and we'll sort it. be nice, be specific, slay.

---

🌈 COPYRIGHT 🌈

Copyright © 2003 Free Software Foundation, Inc.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

💀 translated for the group chat: it's free, you can use it, but if it eats your network stats that is genuinely not their problem.

---

⭐ SEE ALSO ⭐

iptotal(1), iptotald(8), tcpdump (1)

go read those too bestie, iykyk 🦋

---

iptotal 0.3.2 🌸 Dec 2003 🎀 that's the version, that's the date, that's the whole entire manual page. love that for us. mwah 💋🫶