BPDRIVER(1)

💖 bpdriver — Bundle Protocol transmission test program 💖

okay bestie, welcome to the BP executables corner of the manual (you know, the (1) girlies) ✨ this one is a whole little test program and she is so specific about how you talk to her. let's get into it 🫶

---

🌸 NAME 🌸

bpdriver — Bundle Protocol transmission test program

---

✨ SYNOPSIS ✨

bpdriver nbrOfCycles ownEndpointId destinationEndpointId [length] [tTTL]

---

🦋 DESCRIPTION 🦋

so bpdriver uses Bundle Protocol to send nbrOfCycles application data units, each one with the length you picked, over to a counterpart application task that has opened the BP endpoint identified by destinationEndpointId. it's giving pen pal but the pen pal is another process 💌

if you just… don't give a length, she defaults to 60000. generous queen 👑

TTL is how many seconds the bundles are allowed to just vibe in the network undelivered before they get automatically destroyed. if you omit it, TTL defaults to 300 seconds. so yeah, 300 seconds of network time then poof 💀

bpdriver normally runs in "echo" mode: after sending each bundle she waits for an acknowledgment bundle before sending the next one. for this to work, your counterpart application task should be bpecho. no cap.

alternatively, bpdriver can run in "streaming" mode, meaning she doesn't expect or receive acknowledgments at all. main character, unbothered 💅 streaming mode turns on when length is specified as a negative number — in that case the additive inverse of length is used as the effective value of length. and for this mode, your counterpart application task should be bpcounter.

if the effective value of length is 1, then the sizes of the transmitted service data units will be randomly selected multiples of 1024 in the range 1024 to 62464. randomize slay 🌈

bpdriver normally runs with custody transfer disabled. if you want to request custody transfer for all bundles sent by bpdriver, specify nbrOfCycles as a negative number — the additive inverse of nbrOfCycles will be used as its effective value in that case. negative numbers are doing a LOT of heavy lifting here fr fr 😭

when all copies of the file have been sent, bpdriver prints a performance report. receipts! 📊

---

💅 EXIT STATUS 💅

• "0" — bpdriver has terminated. any problems encountered during operation will be noted in the ion.log log file.

---

🎀 FILES 🎀

the service data units transmitted by bpdriver are sequences of text obtained from a file in the current working directory named bpdriverAduFile, which bpdriver creates automatically. she makes her own file, independent icon 💖

---

🌈 ENVIRONMENT 🌈

No environment variables apply.

nope! not a single one. she doesn't read your environment, she reads your arguments. periodt.

---

🔥 DIAGNOSTICS 🔥

diagnostic messages produced by bpdriver are written to the ION log file ion.log.

• Can't attach to BP. — bpadmin has not yet initialized Bundle Protocol operations.
• Can't open own endpoint. — another application has already opened ownEndpointId. terminate that application and rerun.
• Can't create ADU file — operating system error. check errtext, correct problem, and rerun.
• Error writing to ADU file — operating system error. check errtext, correct problem, and rerun.
• bpdriver can't create file ref. — ION system error. check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
• bpdriver can't create ZCO. — ION system error. check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
• bpdriver can't send message — Bundle Protocol service to the remote endpoint has been stopped.
• bpdriver reception failed — bpdriver is in "echo" mode, and Bundle Protocol delivery service has been stopped.

---

😭 BUGS 😭

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

bestie if you find a bug, tell the korgano eecs ohiou email, not me, i am just the messenger 🫶

---

👑 SEE ALSO 👑

bpadmin(1), bpcounter(1), bpecho(1), bp(3)

---

and that's the whole page, bestie!! ✨ this manual page came from perl v5.24.1, dated 2016-07-07, and honestly? she aged like fine wine 💜 🎀🦋🌸