BSSRECV(1)

📦 version 3.2.1, in ubuntu jammy

💖 BSSRECV(1) — the bssrecv page, but make it cute

okay bestie, welcome to bssrecv, one of the BSS executables. it's a reception test program. yes it's from the BSS manual, no we're not being boring about it. 💅

✨ NAME ✨

bssrecv — Bundle Streaming Service reception test program 🛰️

✨ SYNOPSIS ✨

bssrecv

that's it. that's the whole synopsis. no flags, no arguments, just vibes. 🫶

✨ DESCRIPTION ✨

bssrecv uses BSS to acquire streaming data from bssStreamingApp. that's the whole point of it, that's its little purpose in life. 🌸

it's a menu-driven interactive test program, and you run it from the operating system shell prompt. like, you just type it and it opens a menu. iconic behavior honestly.

here's what it lets you do:

  • begin and end a session of BSS data acquisition from bssStreamingApp, displaying the data as it arrives in real time ⏱️
  • replay data acquired during the current session 🔁
  • replay data acquired during a prior session 🔁

🌈 the three parameters bestie, you gotta know these

to initiate the acquisition or replay of data from bssStreamingApp, the user must provide values for three parameters. three! count them! 🎀

  • BSS database name — all data acquired by the BSS session thread gets written to a BSS "database" comprising three files: table, list, and data. the name of the database is the root name that is common to the three files — like, for example, db3.tbl, db3.lst, db3.dat would be the three files making up the db3 BSS database. so the root name is db3. you see the vision. 👑
  • path name — all three files of the selected BSS database must reside in the same directory of the file system. no splitting them up, they're a package deal. the path name of that directory is required. 📁
  • endpoint ID — to acquire streaming data issued by bssStreamingApp, the bssrecv session thread must open the BP endpoint to which that data is directed. for this purpose, the ID of that endpoint is needed. that's it, that's the endpoint ID. 🛰️

🎀 the menu (the main character of this whole page)

bssrecv offers the following menu options:

  1. Open BSS Receiver in playback mode — bssrecv prompts the user for the three parameter values noted above, then opens the indicated BSS database for replay of the data in that database. 💿
  2. Start BSS receiving thread — bssrecv prompts the user for the three parameter values noted above, then starts a background session thread to acquire data into the indicated database. every bundle that gets acquired is passed to a display function that prints a single line consisting of N consecutive '*' characters, where N is computed as the data number at the start of the bundle's payload data, modulo 150. so it's like a little asterisk bar chart, kind of a slay. ✨ <br> > heads up though: the database is not open for replay at this time. 🚫
  3. Run BSS receiver thread — bssrecv prompts the user for the three parameter values noted above, then starts a background session thread to acquire data into the indicated database (displaying the data as described for option 2 above) and also opens the database for replay. best of both worlds, she contains multitudes. 💅
  4. Close current playback session — bssrecv closes the indicated BSS database, terminating replay access. bye bye playback 👋
  5. Stop BSS receiving thread — bssrecv terminates the current background session thread. replay access to the BSS database, if currently open, is not terminated. so the thread stops but the replay keeps vibing. 🦋
  6. Stop BSS Receiver — bssrecv terminates the current background session thread. replay access to the BSS database, if currently open, is also terminated. this one takes everything out. 💀
  7. Replay session — bssrecv prompts the user for the start and end times bounding the reception interval that is to be replayed, then displays all data within that interval in both forward and reverse time order. the display function performed for this purpose is the same one that is exercised during real-time acquisition of streaming data. yes, same display function, consistent queen. 👑
  8. Exit — bssrecv terminates. that's the door. go home. 🚪

✨ EXIT STATUS ✨

  • "0" — bssrecv has terminated. zero, as in zero problems, as in we're done here. ✅

✨ FILES ✨

no configuration files are needed. none. zero. nothing to set up, we love a low-maintenance icon. 🙈

✨ ENVIRONMENT ✨

no environment variables apply. the environment said "not my business" and honestly, respect. 🌈

✨ BUGS ✨

report bugs to <ion-bugs@korgano.eecs.ohiou.edu>. like actually report them, don't just complain in the group chat. 😭

✨ SEE ALSO ✨

💖 bestie note: this page was brought to you by perl v5.24.1, dated 2016-07-07. yes she's a 2016 baby and she's still serving. periodt. 🎀✨
📦 where this page comes from