nlpatch(8)

✨ nlpatch(8) β€” the FTN mailer glow-up you didn't know you needed ✨

okay bestie, sit down, hydrate, and let me tell you about nlpatch, a lil tool from the FTN mailer world. yes the manual name is nlpatch(8) and yes it's giving very "old school internet but make it iconic" πŸ’…


🌸 NAME 🌸

nlpatch β€” it patches a nodelist. that's it. that's the whole vibe. πŸ¦‹


🌈 SYNOPSIS 🌈

nlpatch [-h] [-x verbosity] [-I file] nodelist nodediff

πŸ’– DESCRIPTION πŸ’–

Nlpatch patches a nodelist. no cap, that's literally the entire description the original gives us, and honestly? respect the brevity. main character energy ✨


πŸŽ€ OPTIONS πŸŽ€

  • -h β€” shows you a short help message. your little "what do I do now" button, we love her 🫢
  • -x Verbosity β€” sets the debug verbosity. Verbosity can be either:
    • a number from 0 to 32, which sets the 'on' bits from 1 up to that number, or
    • a string of letters, where 'a' = bit 1, 'b' = bit 2, etc., all the way up to bit 26.

so you got choices, bestie, pick your fighter πŸ’…

  • -I File β€” use the alternate configuration file File instead of the usual one. swapping the fit, love that for you πŸ’–

⭐ RETURN CODES ⭐

when nlpatch exits, it leaves you a lil note. here's the tea:

  • 0 β€” Successfull (yes, with the double l β€” that's the original spelling, and we are not touching it, periodt πŸ’€)
  • 1 β€” command line usage error. you said something it didn't understand πŸ™ˆ
  • 2 β€” cannot open some files
  • 3 β€” could not read some files
  • 4 β€” CRC error 😭
  • 5 β€” unknown command line
  • 6 β€” diff does not match old list

πŸ”₯ DEBUG VERBOSITY πŸ”₯

so when you crank up -x, these are the lil letters you can turn on, and what each one is watching. iykyk πŸ‘‘

  • d β€” lock files
  • f β€” aka matching
  • g β€” outbound directories
  • h β€” call
  • j β€” session handshake
  • k β€” file transfer
  • l β€” filelist
  • m β€” nodelist flags
  • r β€” modem
  • t β€” nodelist index
  • z β€” hydra protocol

🧚 FILES 🧚

  • $IFLIBDIR/config β€” the runtime configuration file. yes, $IFLIBDIR is an environment variable, she's doing the heavy lifting πŸ’œ
  • nodelist.??? β€” a list of nodes in an FTN network. the ??? is not me being mysterious, that's literally the filename pattern bestie 🌸

πŸ¦‹ SEE ALSO πŸ¦‹

ifmail(8), ifpack(8), ifunpack(8), iftoss(8), mgetty(8), getty(1)

go read those too, they're the rest of the friend group πŸ’–


πŸ‘‘ ACKNOWLEDGEMENTS πŸ‘‘

the lore!! okay so:

  • Some ideas were taken from the Fidogate/RFmail package, written by Teemu Torma and hacked by Martin Junius.
  • Some tcp code was taken from the JE version, written by Tsuneo Tanaka <ttan@twics.com>.
  • 1993, 1994 Eugene Crosser
  • This is free software. You can do what you wish with it as long as this copyright notice is preserved. (that part is not optional bestie, keep the receipt 🫢)
  • Manpage and dbz-nodelist-index support by Christof Meerwald <cmeerw@mail.htl.fh-sbg.ac.at>
  • Many thanks to the institute of computer science in Salzburg/Austria and especially to Anton Hofmann <hofmann@wst.edvz.sbg.ac.at> who made further work possible during his lecture. shoutout to Anton, absolute legend 🌈

πŸ’€ real talk though: this page is from version 3.0.cm.alpha-2, dated May 29, 1997, under the FTN mailer banner. ancient. iconic. still valid. that's the vibe check, and she passed ✨

and that's the whole page, bestie β€” go patch that nodelist πŸ’…πŸŽ€πŸ’–