BPCANCEL(1)

📦 version 3.2.1, in ubuntu jammy

💅 BPCANCEL — bestie's guide to yeeting a bundle 💅

okay so this is bpcancel, a BP executables manual page (that's manual section 1, babes), and it's about the Bundle Protocol (BP) bundle cancellation utility. no cap, that's literally what the NAME section says and i'm not gonna gatekeep it. 🦋

✨ SYNOPSIS ✨

bpcancel source_EID creation_seconds [creation_count [fragment_offset
[fragment_length]]]

look at those optional brackets, they're giving choose-your-own-adventure 📖✨

🌸 DESCRIPTION 🌸

so here's the tea: bpcancel hunts down the bundle that matches the values you typed on the command line, and then it destroys it. 💀 not by smashing anything, but by simulating an immediate time-to-live expiration — which is such a mood, honestly, like the bundle just woke up one day and decided it had lived long enough. it's iconic, it's dramatic, it's a whole vibe. 🔥

👑 EXIT STATUS 👑

  • "0" — bpcancel has terminated. that's it. that's the whole status. she came, she cancelled, she left. periodt. 💅

🎀 FILES 🎀

no configuration files are needed. zero. none. not a single one. your filesystem is safe, bestie, we're low-maintenance like that. 🫶

🌈 ENVIRONMENT 🌈

no environment variables apply. so don't go looking for some secret $BPCANCEL_WHATEVER, because she doesn't have one. she's mysterious like that. 🙈

⭐ DIAGNOSTICS ⭐

these lil messages might show up in the ion.log log file, so if something's feeling off, that's where the receipts live:

  • Can't attach to BP. bpadmin has not yet initialized BP operations. so like, the whole BP situation isn't even up yet, and you're out here asking for a cancellation?? ma'am. 😭
  • bpcancel failed finding bundle. no bundle identified by the command-line parameter values is present in the "timeline" list for the local bundle agent. basically she looked everywhere and the bundle said "not me". 💀
  • bpcancel failed destroying bundle. probably an unrecoverable database error, in which case the local ION node must be terminated and re-initialized. yeah. that's the bad one. no cap, that's a full reset situation. 🚨
  • bpcancel failed. probably an unrecoverable database error, in which case the local ION node must be terminated and re-initialized. same energy as above, just vaguer, and honestly? rude. 🙃

🐛 BUGS 🐛

found a bug? report bugs to <ion-bugs@korgano.eecs.ohiou.edu>. they want to hear from you, fr fr. be brave, send the email. 💌

🦋 SEE ALSO 🦋

  • bplist(1) — go look at your bundles before you cancel them, bestie, that's just self-care. 👑

and that's the whole page!! tysm for reading my little manual moment. this icon was brought to you by perl v5.24.1, dated 2016-07-07, under the BP executables umbrella — so yeah, she's been serving since 2016 and she still eats. 💖✨🌸

📦 where this page comes from