PINGU(8)

💖 NAME 💖

okay bestie, welcome to the pingu(8) manual — and yes, pingu is a Multi ISP policy routing, failover and load-balancing daemon. It’s giving network infrastructure but make it iconic. 👑

✨ SYNOPSIS ✨

pingu [-dhvV] [-a SOCKETPATH] [-c CONFIG] [-p PIDFILE]

🦋 DESCRIPTION 🦋

The pingu utility monitors specified interfaces and sets up an alternate route table for each specified interface in which it mirrors all routes using that interface. It also sets up a route rule so that this alternate route table is looked up for traffic where the source IP address matches the primary IP address of the corresponding interface. This guarantees that a service bound to the primary address of an interface will always use routes from that interface. periodt. 💅

It can also ping specified hosts at regular intervals to detect if a gateway via a certain interface goes down. It will then remove the default gateway(s) via this interface from main route table so that traffic not bound to the failed interface will fail over to other configured interfaces. failover queen behavior, honestly. 🫶

pingu can also set up a multipath nexthop default route for interfaces configured as "load-balance". load-balancing slay. 🌈

🎀 OPTIONS 🎀

• -a SOCKETPATH — use SOCKETPATH as administration socket instead of the default /var/run/pingu/pingu.ctl. 🔌
• -c CONFIG — use config file CONFIG instead of the default /etc/pingu/pingu.conf. 📝
• -d — fork to background (daemonize). 💤
• -h — show short help text. 🙋
• -p PIDFILE — use PIDFILE as pidfile instead of the default /var/run/pingu/pingu.pid. 🪪
• -V — print version and exit. 🏷️
• -v — run in verbose mode. Will log debug messages. 🔊

🌸 FILES 🌸

• /etc/pingu/pingu.conf
• /var/run/pingu/pingu.pid
• /var/run/pingu/pingu.ctl

👑 AUTHORS 👑

Natanael Copa — yes, the icon who wrote this. 🫶

that’s the whole page, bestie — footer vibe check says 01/03/2025 and the manual is PINGU(8). bye 💖✨