BSSFW(1)

📦 version 3.2.1, in ubuntu jammy

💖 BSSFW(1) 💖

okay so bestie, welcome to the bssfw page — that's the BP executables manual, section 1, and honestly? she's a whole vibe. sit down, grab a boba, let's get into it ✨

🌸 NAME 🌸

bssfw — bundle route computation task for the IPN scheme, adapted for Bundle Streaming Service

like... that's the girl. that's the whole job description. no cap 💅

🎀 SYNOPSIS 🎀

that's it. that's the synopsis. no flags, no args, she just is. main character energy fr fr 👑

🦋 DESCRIPTION 🦋

okay so bssfw is a background "daemon" task. and when I say background I mean she's back there doing the most, quietly, while everybody else is loud. what she does is: she pops bundles from the queue of bundles destined for IPN-scheme endpoints, computes proximate destinations for those bundles, and then appends those bundles to the appropriate queues of bundles pending transmission to those computed proximate destinations. she's literally the group chat admin of bundle routing. 💖

so here's the tea on the queues. for each possible proximate destination (that's a neighboring node, bestie, the node next door), there is a separate queue for each possible level of bundle priority: 0, 1, 2. and each outbound bundle gets appended to the queue matching the bundle's designated priority. three tiers, three queues per neighbor. it's giving organized. it's giving spreadsheet girlie. 📊

now, proximate destination computation is affected by static and default routes as configured by bssadmin(1) and by contact graphs as managed by ionadmin(1) and rfxclock(1). so she's not just vibing, she's consulting the sources.

and here's the part where bssfw differs from ipnfw — and it's the whole point, iykyk: a bundle that is destined for an endpoint associated with a BSS application (as registered in an "entry" passed to bssadmin(1) in a bssrc(5) command) is forwarded via a duct identified in a separately defined real-time or playback duct expression, rather than the standard duct that is used for non-BSS traffic. BSS traffic gets the special lane. the VIP entrance. 💅✨

and how does she get born and how does she get yeeted? bssfw is spawned automatically by bpadmin in response to the 's' (START) command that starts operation of Bundle Protocol on the local ION node, and it is terminated by bpadmin in response to an 'x' (STOP) command. bssfw can also be spawned and terminated in response to START and STOP commands that pertain specifically to the IPN scheme. so like, two different ways in, two different ways out. she's flexible like that. 🦋

⭐ EXIT STATUS ⭐

  • "0" — bssfw terminated, for reasons noted in the ion.log log file. and bestie, if this termination was not commanded, investigate and solve the problem identified in the log file and use bpadmin to restart bssfw. like don't just shrug at it. 🚨
  • "1" — bssfw could not commence operations, for reasons noted in the ion.log log file. Investigate and solve the problem identified in the log file, then use bpadmin to restart bssfw. she couldn't even start. tragic. fix the log situation, then bring her back. 😭

🌈 FILES 🌈

No configuration files are needed.

she needs nothing from you. she comes pre-slaying. 💜

🧚 ENVIRONMENT 🧚

No environment variables apply.

zero. none. not a single one. the environment could never influence her. ✨

💀 DIAGNOSTICS 💀

The following diagnostics may be issued to the ion.log log file — so when she's got something to say, it goes here:

  • bssfw can't attach to BP. — bpadmin has not yet initialized BP operations. like, she's knocking and nobody's home. 😭
  • bssfw can't load routing database. — bssadmin has not yet initialized the IPN scheme. the database isn't ready, so neither is she. 🙈
  • Can't create lists for route computation. — An unrecoverable database error was encountered. bssfw terminates. this one's serious, she's out. 💀
  • 'bss' scheme is unknown. — The IPN scheme was not added when bpadmin initialized BP operations. Use bpadmin to add and start the scheme. she doesn't know who that is and honestly, you didn't introduce them. 🎀
  • Can't take forwarder semaphore. — ION system error. bssfw terminates. yeah that's an ION problem and she is gone. 🔥
  • Can't exclude sender from routes. — An unrecoverable database error was encountered. bssfw terminates. again. unrecoverable. she's leaving. 😭
  • Can't enqueue bundle. — An unrecoverable database error was encountered. bssfw terminates. same energy. same ending. 💀

🍓 BUGS 🍓

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

bestie if you find a bug, tell the email. don't just post about it. 🫶

👑 SEE ALSO 👑

bpadmin(1), bssadmin(1), bprc(5), bssrc(5).

go read those too, they're all connected, it's a whole cinematic universe. 🌸

okay that's the page!! perl v5.24.1, dated 2016-07-07 — vintage but still ate, no crumbs left, periodt 💖✨
📦 where this page comes from