ampr-ripd(8)

🎀 NAME 🎀

Okay bestie, welcome to the ampr-ripd(8) page, the General Manual Commands entry 💅 It's a routing daemon for AMPRNet gateways v2.4.2 and it's honestly giving main character energy ✨

---

🌸 SYNOPSIS 🌸

ampr-ripd [-?|-h] [-d] [-v] [-s] [-r] [-i <interface>] [-a <ip|hostname|subnet>[,<ip|hostname|subnet>...]] [-p <password>] [-m <metric>] [-w <window>] [-f <interface>] [-e <ip>] [-F <interface>] [-E <ip>] [-x <system command>] [-g <gateway>]

---

🦋 DESCRIPTION 🦋

Okay so, AMPRnet is a RIPv4 Listener and route injector daemon that gets used with AMPRnet gateways. It's the behind-the-scenes queen 👑

---

✨ OPTIONS ✨

• -?, -h — Usage info, for when you need a little reminder 🙈
• -d — Debug mode! No daemonization (it stays in the foreground) and verbose output 🔍
• -v — Extra verbose debug output 📢 Using this without debug means the console stays attached.
• -s — Saves routes to /var/lib/ampr-ripd/encap.txt (encap format) 💾 If that file already exists, it gets loaded on startup no matter what, so you don't even need this flag for that part.
• -r — Uses a raw listening socket for systems with broken multicast support 🛠️
• -i <interface> — The tunnel interface to use. Defaults to tunl0 🚇
• -t <table> — The routing table to use. Defaults to 'main' 🗂️
• -a <ip>[,<ip>...] — A comma separated list of IPs, hostnames, or ampr subnets to be ignored 🚫 Subnets can be written as full network/mask (like 44.182.20.0/24) or encap (like 44.182.20/24), but they MUST match an entry in the RIP broadcast. If you use a hostname, its IP gets re-resolved 30 sec after every RIP broadcast. The list has your local interface IPs by default.
• -m <metric> — The metric used when setting routes 📊 It's a number from 0 to 255, and it defaults to 0.
• -w <window> — Sets the TCP window size to a given value (defaults to 840) 🪟 This is needed because IP over AX.25 connections have a small TCP window size. A value of 0 disables setting the window size. Not recommended, the default should be totally fine 🙅‍♀️
• -p <password> — The RIPv2 password. It defaults to the current valid password, so only use this if the password ever changes 🔐
• -f <interface> — The interface for RIP forwarding. Defaults to none/disabled 📡
• -e <ip> — The RIP forward destination IP. Defaults to 224.0.0.9 if enabled 🎯
• -F <interface> — The interface for AMPR RIP forwarding. Defaults to none/disabled 📡
• -E <ip> — The AMPR RIP forward destination IP. Defaults to 224.0.0.9 if enabled 🎯
• -x <system command> — Runs this system command after a route is set or changed ⚡ If the command has white spaces, wrap it in quotes, bestie.
• -g <gateway> — The gateway for direct 44net connections. Accepts a gateway IP or an interface name. If you don't set it, it gets auto-detected 🤖
• -L <callsign@locator> — Turns on sending a callsign@locator string (honestly any string works) to the home gateway at udp:44.182.21.1:59001 💌 It gets sent at startup and then every 5 minutes. On termination, a "shutdown" string gets sent. On HUP, the string goes out immediately and the cycle restarts. The whole point is building a dynamic map of all ampr-ripd gateways for visual display 🗺️ If this parameter isn't set, no data gets sent.

👀 Observation

All routes are created with netlink protocol 44 so they're super easy to manage 🧚

---

🚦 SIGNALS 🚦

• SIG_HUP — ampr-ripd deletes all set routes but stays active 🔄 Routes get set again on the next received RIPv2 set, and the saved encap file gets updated.
• SIG_TERM (exit) — ampr-ripd deletes all set routes and exits 👋

---

🐛 DEBUG 🐛

With the default debug level and the -d option, the daemon stays in the foreground, which lets you find the RIPv2 password if you need it 🕵️ (check out the find_pass.sh shell script). For full debug output, it has to be compiled with -D HAVE_DEBUG or by uncommenting the right DOPT line.

⚠️ Heads up: this is how you dig up the RIPv2 password, so handle it with care, okay? 🫶

---

👑 AUTHOR 👑

Author: Marius Petrescu, YO2LOJ, <marius@yo2loj.ro> 🌟

---

💀 KNOWN ISSUES 💀

• When you use a table other than 'main', interrogating the routes via netlink doesn't work properly 😭 That means every update deletes the route and recreates it, even if it's already set correctly. It should be fine, though, since this only happens at startup on encap loading and on route change.
• For BGP announced 44net endpoints, only a single subnet can be assigned to a given endpoint 🙅‍♀️

---

Okay that's the whole tea on ampr-ripd, April 2025 edition 💖 Now go be iconic, bestie 🧚💅🌈