BPSTATS2(1)

📦 version 3.2.1, in ubuntu jammy

✨ bpstats2 — the stats girlie 💅

okay bestie, listen up: bpstats2 is a Bundle Protocol (BP) processing statistics query utility — but the way it works is via bundles. yes, bundles. it's giving "I ask nicely and the numbers come to me" energy and honestly? iconic.

🌸 SYNOPSIS 🌸

bpstats2 sourceEID [default destEID] [ct]

🦋 DESCRIPTION 🦋

so here's the tea. bpstats2 creates bundles that are literally stuffed with the current values of all BP processing statistics accumulators. no cap. and it makes these bundles when one of these two things happens:

  • an interrogation bundle is delivered to sourceEID — the contents of that bundle get discarded (we don't read them, we don't care, the format is irrelevant, periodt), a brand new statistics bundle is generated, and it's sent straight back to the source of the interrogation bundle. the vibe of the interrogation bundle literally does not matter. 🫶
  • a SIGUSR1 signal is delivered to the bpstats2 application — a new statistics bundle gets generated and sent to default destEID. it's giving main character energy, one signal and the stats are out the door. ✨

💖 EXIT STATUS 💖

  • "0" — bpstats2 has terminated. any problems encountered during operation will be noted in the ion.log log file. (she's fine, she's just logging 📝)
  • "1" — bpstats2 failed to start up or receive bundles. go diagnose the issue reported in the ion.log file and try again, bestie. 😭

✨ OPTIONS ✨

  • [ct] — if the string "ct" is appended as the last argument, then statistics bundles will be sent with custody transfer requested. that's it, that's the whole option list. one option. she's lowkey minimalist and I respect it. 💅

🎀 FILES 🎀

No configuration files are needed. not a single one. she's self-sufficient, she's thriving. 🌈

💜 ENVIRONMENT 💜

No environment variables apply. nope, none, zero, nada. ✨

🔥 DIAGNOSTICS 🔥

these are the diagnostics that may be issued to the ion.log log file. buckle up, there's a few:

  • bpstats2 can't bp_attach(). — bpadmin has not yet initialized BP operations. (she's knocking on the door and nobody's home 🚪)
  • bpstats2 can't open own endpoint. — another BP application has opened that endpoint. close it and try again. (endpoint is taken, it's giving "seat's saved" energy 😤)
  • No space for ZCO extent. — ION system error. check for earlier diagnostic messages describing the cause of the error; correct the problem and rerun.
  • Can't create ZCO extent. — ION system error. check for earlier diagnostic messages describing the cause of the error; correct the problem and rerun.
  • bpstats2 can't send stats bundle. — Bundle Protocol service to the remote endpoint has been stopped. 💀
  • Can't send stats: bad dest EID (dest EID) — the destination EID printed is an invalid destination EID. the destination EID may be specified in default destEID or the source EID of the interrogation bundle. make sure default destEID is an EID that is valid for ION, and that the interrogator is a source EID that is also a valid destination EID. and note this one closely: "dtn:none" is not a valid destination EID, but it is a valid source EID. iykyk. 🙈

🌟 NOTES 🌟

a very simple interrogator is bpchat, which can repeatedly interrogate bpstats2 by just striking the enter key. yes bestie, enter key spam is a valid interrogation strategy. obsessed. ⌨️💖

😭 BUGS 😭

Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>. she's not perfect, she's just trying her best. 🫶

👑 SEE ALSO 👑

and that's the whole page, bestie!! 🎀 this manual was served up by perl v5.24.1 on 2016-07-07, and it lives in the BP executables section of the manual. slay, stay hydrated, and always read your ion.log. 💖✨🦋

📦 where this page comes from