BSSADMIN(1)

📦 version 3.2.1, in ubuntu jammy

💖 BSSADMIN(1) — the BP executables era 💖

okay bestie, gather round, because this is bssadmin, and she is the Interplanetary Internet (IPN) scheme administration interface for use with Bundle Streaming Service. yes that's a mouthful. yes it's iconic. periodt. ✨

✨ SYNOPSIS ✨

bssadmin [ commands_filename ]

🌸 DESCRIPTION 🌸

so. bssadmin is basically the BSS-flavoured cousin of ipnadmin(1) — she's the one who configures your local ION node's routing of bundles to endpoints whose IDs conform to the ipn endpoint ID scheme. and ipn? she's CBHE-conformant, meaning every single endpoint ID in the ipn scheme is a string shaped like this:

"ipn:element_number.service_number"

where element_number is a CBHE "node number" (the main character) and service_number identifies a specific application processing point (her supportive bestie). 💅

here's the vibe: bssadmin operates in response to IPN scheme configuration commands found in the file commands_filename, if provided. if not? she just prints a simple prompt (:) so you can type commands straight into standard input like the boss you are. 🎀

and if you ever need to know the format of the commands for commands_filename, you can query it from bssadmin with the 'h' or '?' commands at the prompt. the commands themselves are documented in bssrc(5). iykyk. 🦋

🔥 EXIT STATUS 🔥

  • "0" — Successful completion of IPN scheme administration. slay. 👑
  • "1" — Unsuccessful completion of IPN scheme administration, due to inability to attach to the Bundle Protocol system or to initialize the IPN scheme. not slay. 😭

🌈 EXAMPLES 🌈

  1. bssadmin — Enter interactive IPN scheme configuration command entry mode.
  2. bssadmin host1.bssrc — Execute all configuration commands in host1.bssrc, then terminate immediately.

🍓 FILES 🍓

See bssrc(5) for details of the BSS configuration commands for the IPN scheme. that's the whole section bestie, go read it.

🧚 ENVIRONMENT 🧚

No environment variables apply. literally none. she's unbothered, she's free. 🙈

💀 DIAGNOSTICS 💀

Note: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited. If you edit the bssrc file on a Windows machine, be sure to use dos2unix to convert it to Unix text format before presenting it to bssadmin. Otherwise bssadmin will detect syntax errors and will not function satisfactorily.

okay so, no cap, that Windows line-ending thing will get you. the following diagnostics may be issued to the logfile ion.log:

  • bssadmin can't attach to BP. — Bundle Protocol has not been initialized on this computer. You need to run bpadmin(1) first. bestie. run it first. 🫶
  • bssadmin can't initialize routing database. — There is no SDR data store for dtnadmin to use. Please run ionadmin(1) to start the local ION node.
  • Can't open command file... — The commands_filename specified in the command line doesn't exist. 💀
  • Various errors that don't cause bssadmin to fail but are noted in the ion.log log file may be caused by improperly formatted commands given at the prompt or in the commands_filename file. Please see bssrc(5) for details.

😭 BUGS 😭

Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>

💜 SEE ALSO 💜

and that's the whole page, bestie — written up in perl v5.24.1, dated 2016-07-07, and filed under BSSADMIN(1). go configure those bundles, you absolute legend. mwah. 💖✨

📦 where this page comes from