AXPARMS(8)

💖 AXPARMS(8) 💖

okay so real talk: this is a page straight out of the Linux System Managers Manual, and bestie, it's basically the remote control for your AX.25 interfaces. buckle up 🎀

---

✨ NAME ✨

axparms — the girl who configures AX.25 interfaces for you 💅

---

✨ SYNOPSIS ✨

axparms --assoc|--forward|--route|--setcall|--version ...

---

✨ DESCRIPTION ✨

So axparms is lowkey a multi-function command — think Swiss Army knife but make it packet radio 🔥. It lets miscellaneous commands be issued to the Linux AX.25 protocol layer. Which mode you get is decided by the first argument, and every argument after that depends on which one you picked. So there's literally no generalised command format anyone can hand you — it's choose-your-own-adventure, no cap. 🦋

---

🌸 --assoc Argument 🌸

The format of this option is:

axparms --assoc <callsign> <username|uid>
axparms --assoc <callsign> delete
axparms --assoc policy [default|deny]
axparms --assoc show

This one manipulates the kernel uid/callsign mapping table, so you can associate and dis-associate callsigns with a user. iconic behaviour tbh 🫶

The policy option is the superuser-only vibe check: it lets root decide whether all the other uid's either default to the actual port name, or get blocked from traffic altogether. denied, periodt 💀

At power up the table is blank and the policy is default — which is thus backward compatible. no breaking changes, we love to see it ✨

---

🌸 --forward Argument 🌸

This is the "many receivers, one transmitter" situation — packet forwarding, as the many systems call it. The format of this command is:

axparms --forward <portfrom> <portto>
axparms --forward <portfrom> delete

Any packets that want to be transmitted on port portfrom will instead be transmitted on port portto. it's giving relay energy 📡

This stays in force until you issue the second form of the command, which removes the association. bye bestie 👋

---

🌸 --route Argument 🌸

This option lets you manipulate the internal AX.25 routing table. You can read that table in /proc/net/ax25_route, and it gets built up dynamically by stations being heard — but you can also add, delete and list entries yourself via this option. main character energy fr fr 👑

The formats of this option are:

axparms --route add <port> <callsign> [<digis>] [--ipmode V|D]
axparms --route del <port> <callsign>
axparms --route list

Routes you add via this command will not be removed from the internal routing table when they're “old” the way normal entries are. permanent, unlike some people 😭

The --ipmode option sets mode vc or mode datagram for this destination.

If the <callsign> argument is set to “default”, then this sets the default route for all outgoing AX.25 connections — the one that gets used whenever there's no specific route to the required destination. fallback queen 🌈

---

🌸 --setcall Argument 🌸

The format of this option is:

axparms --setcall <interface> <callsign>

This changes the callsign associated with the given physical ax25 interface. cute little glow-up for your interface 💅

Cave: the interface name is not the symbolic port name from axports, it's the real interface name (from ifconfig(8)): ax0, ax1, .., sp0, .., bpq0, ... etc.. iykyk, don't mix them up or you'll be sad 🙈

The change is permanent as long as the interface exists, or until another “axparms --setcall” is issued.

The interface has to exist already in order to use this option — it may be in state UP or DOWN, so either is fine, she's flexible 🧚

---

🌸 --version Argument 🌸

This option displays the version of the AX.25 utilities that axparms belongs to. simple, honest, iconic ⭐

---

🎀 FILES 🎀

• /proc/net/bpqether
• /proc/net/ax25_calls
• /etc/ax25/axports

---

🦋 SEE ALSO 🦋

call(1), getsockopt(2), setsockopt(2), ax25(4), axctl(8), axports(5).

---

👑 AUTHORS 👑

• Alan Cox GW4PTS <alan@cymru.net>
• Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk>
• Joerg Reuter DL1BKE <jreuter@poboxes.com>

---

that's the whole page bestie, go configure something legendary 💜✨

Linux — 19 January 2017 — AXPARMS(8) 🍓 mwah, see u in the group chat 🫶