BSSPADMIN(1)

📦 version 3.2.1, in ubuntu jammy

👑 BSSPADMIN(1) — the BSSP admin glow-up ✨

okay bestie, so this is bsspadmin, and it lives in the BSSP executables fam (Bundle Streaming Service Protocol, iykyk). it's the administration interface and honestly? it's giving main character energy for your local ION node. let's get into it 💅

🌸 NAME 🌸

bsspadmin — the Bundle Streaming Service Protocol (BSSP) administration interface. that's it, that's the girl. 🎀

✨ SYNOPSIS ✨

bsspadmin [ commands_filename | . ]

💖 DESCRIPTION 💖

so what does she actually do? bsspadmin configures, starts, manages, and stops BSSP operations for the local ION node. all four. she does it all, no cap. 👑

she operates in response to BSSP configuration commands found in the file commands_filename, if you hand her one. if you don't? she just prints a lil simple prompt (:) so you can type commands straight into standard input. very demure, very direct. 🫶

and here's the plot twist: if commands_filename is a period (.), the effect is the exact same as if you'd passed a command file containing the single command x to bsspadmin — meaning the ION node's bsspclock task and link service adapter tasks get stopped. periodt. 💀

wanna know the format of the commands for commands_filename? you can literally just ask her — hit the h or ? commands at the prompt and she'll tell you. the commands themselves are documented over in bssprc(5). go look, bestie, it's all there. 📖

🔥 EXIT STATUS 🔥

  • 0 — successful completion of BSSP administration. slay. ✅

🌈 EXAMPLES 🌈

  • bsspadmin enter interactive BSSP configuration command entry mode. you and her, one-on-one, typing away. 💬
  • bsspadmin host1.bssp execute all configuration commands in host1.bssp, then terminate immediately. she's in, she's out, no lingering. 🦋
  • bsspadmin . stop all BSSP operations on the local node. the . is the dramatic exit. 🎬

🎀 FILES 🎀

see bssprc(5) for the details of the BSSP configuration commands. that's where all the lore lives. 📚

🧚 ENVIRONMENT 🧚

no environment variables apply. nope, none, zero, nada. she doesn't need them and she doesn't want them. 🙈

⭐ DIAGNOSTICS ⭐

note, and this is important bestie: all ION administration utilities expect source file input to be lines of ASCII text that are NL-delimited. so if you edited the bssprc file on a Windows machine?? please, please use dos2unix to convert it to Unix text format before presenting it to bsspadmin. otherwise bsspadmin will detect syntax errors and will not function satisfactorily. we do not want that vibe. 😭

the following diagnostics may be issued to the logfile ion.log:

  • bsspadmin can't attach to ION. there is no SDR data store for bsspadmin to use. you should run ionadmin(1) first, to set up an SDR data store for ION. she can't attach to something that isn't there, girl. 💀
  • Can't open command file... the commands_filename specified in the command line doesn't exist. file's not there. can't read what isn't real. 🫠
  • various errors that don't cause bsspadmin 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 bssprc(5) for details. 🔍

💀 BUGS 💀

report bugs to <ion-bugs@korgano.eecs.ohiou.edu>. tell them the girlies sent you. 💌

🌟 SEE ALSO 🌟

and that's the whole page, bestie!! 🥳 this manual page came to you from perl v5.24.1, dated 2016-07-07, and it's the BSSPADMIN(1) page from the BSSP executables collection. vintage but iconic. mwah. 💋✨🎀

📦 where this page comes from