NET2KISS(8)

📦
version 1.1.0 · 2 versions
  • 1.1.0 · alpine 3.24, debian bookworm, debian trixie, nixos 26.05, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.4 · fedora 43, fedora 44
, in alpine 3.24, debian bookworm, debian trixie, nixos 26.05, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💅 NET2KISS(8) — like, the net2kiss manual page, bestie 🎀

okay so first thing: this is a page from section 8 of the manual (the sysadmin-y one), and the command is called net2kiss, bestie. buckle up, it's actually so cool.

✨ NAME ✨

net2kiss — convert a network AX.25 driver to a KISS stream on a pseudo-tty

like, it takes your AX.25 network driver and pipes it out as a KISS stream over a pseudo-tty. it's giving translator energy, ngl 💅

🌸 SYNOPSIS 🌸

net2kiss [-sfzva] [-i ifname] ptyname

that's the whole shape of it. flags go together in one little cluster -sfzva, then optionally -i ifname, then you gotta give it a ptyname or it's not going anywhere, periodt.

🦋 DESCRIPTION 🦋

so here's the vibe: net2kiss takes AX.25 packets from an AX.25 kernel network interface and converts them into a KISS data stream via a pseudo-tty.

that's literally the whole job. kernel interface in → KISS stream out the pty. main character behaviour honestly 💖

🍓 PARAMETERS 🍓

  • ptyname — specifies the path to the pseudo-tty. and listen, there's a special case you need to know about: if you use the special name /dev/ptmx, then a Unix98-PTY pair is used, and the pty name gets written to stdout. so like, don't go looking for a file, just read your terminal, iykyk ✨

👑 OPTIONS 👑

  • -i ifname — specifies the name of the kernel AX.25 network interface. the default is bc0. (yes, bc0 is the default, no you don't have to pick one, the vibes pick it for you 🌈)
  • -s — tells net2kiss to search by itself for a free pseudoterminal, open the master side, and create a symlink named by -p to the slave side. self-sufficient queen behaviour, no notes 💅
  • -f — can be used in conjunction with -s to force the creation of the symlink even if the target file does already exist. *DANGEROUS* 🚨 like bestie I'm serious, it's written in all caps in the original and everything — it will absolutely clobber a file that's already sitting there, so know what you're doing.
  • -v — Verbose output. Displays error messages during operation and decoded packets to stdout. honestly the best one if you're confused, she'll tell you what's happening 🫶
  • -z — put the network interface into promiscuous mode. she sees everything now 👀
  • -a — receive every packet instead of only AX.25 from the kernel AX.25 network interface. like, everything everything 🔥

💀 BUGS 💀

None known.

(iconic. zero notes. flawless. we love to see it 😭👑)

🔥 SEE ALSO 🔥

go read those too, fr fr 🧚

💜 AUTHORS 💜

Thomas M. Sailer, HB9JNX/AE4WA, <t.sailer@alumni.ethz.ch>

and that's the whole page, bestie, no cap. net2kiss is section 8 of the manual, dated 15 January 2009 (yes she's a 2009 girlie and she still ate 💖). mwah, go convert some packets 🌸🦋✨
📦 where this page comes from