LGSEND(1)

📦 version 3.2.1, in ubuntu jammy

💅 LGSEND(1) — bestie edition 💅

okay so this is lgsend, the ION Load/Go command program, from the BP executables crew. pull up a chair, we're gonna send some files across a whole interplanetary network and it's gonna be adorable. 🦋

✨ SYNOPSIS ✨

lgsend command_file_name own_endpoint_ID destination_endpoint_ID

three lil args, one big slay. 💫

🌸 DESCRIPTION 🌸

So ION Load/Go is, like, a whole system for managing an ION-based network — it lets you run ION admin programs on remote nodes instead of physically trekking over there like it's the 1800s. 🚶‍♀️ And this system is just two programs, bestie: lgsend and lgagent. That's it. Power duo. Dynamic duo. the way that two programs run an entire remote admin pipeline… 💅

The lgsend program does the sending half. It reads a Load/Go source file off your local file system, wraps the text of that file up in a bundle (yes, like a lil gift 🎁), and ships that bundle off to an lgagent task that's sitting there waiting for data at a designated DTN endpoint on the remote node. patiently waiting. manifesting.

Here's the actual play-by-play, no cap:

  1. It reads all the lines of the Load/Go source file you named in command_file_name into a temporary buffer in ION's SDR data store — concatenating the lines and keeping every single newline character. all of them. every one. 🫶
  2. Then it invokes the bp_send() function to create and send a bundle whose payload is that temporary buffer, whose destination is destination_endpoint_ID, and whose source endpoint ID is own_endpoint_ID.
  3. Then it terminates. bye! 👋

🔥 EXIT STATUS 🔥

  • 0 — Load/Go file transmission succeeded. we ate!! 🎉
  • 1 — Load/Go file transmission failed. 😭 Examine ion.log to figure out what went wrong, then re-run. the log knows. the log always knows. 👀

🎀 FILES 🎀

  • lgfile — contains the Load/Go file capsules and directive that are to be sent to the remote node. it's giving very important cargo energy. 📦

🧚 ENVIRONMENT 🧚

No environment variables apply. nothing. zero. the environment is at peace. 🧘‍♀️

⭐ DIAGNOSTICS ⭐

The following diagnostics may be issued to the ion.log log file. aka the group chat where everything gets screenshotted 📱:

  • lgsend: can't attach to BP. Bundle Protocol is not running on this computer. Run bpadmin(1) to start BP. it's not here bestie. wake it up. ⏰
  • lgsend: can't open own endpoint. own_endpoint_ID is not a declared endpoint on the local ION node. Run bpadmin(1) to add it. declare it or it doesn't exist, that's the rule. 💅
  • lgsend: can't open file of LG commands: error description command_file_name doesn't identify a file that can be opened. Fix the spelling of the file name or the file's access permissions. typo check first, always. 🔍
  • lgsend: can't get size of LG command file: error description Operating system problem. Investigate and correct before rerunning. sounds like a whole situation ngl 😬
  • lgsend: LG cmd file size > 64000. Load/Go command file is too large. Split it into multiple files if possible. it's not a skill issue, it's a size issue. ✂️
  • lgsend: no space for application data unit. ION system problem: have exhausted available SDR data store reserves. the data store said "no more, I'm full" 😭
  • lgsend: fgets failed: error description Operating system problem. Investigate and correct before rerunning. 🛠️
  • lgsend: can't create application data unit. ION system problem: have exhausted available SDR data store reserves. same vibe, different function. 💀
  • lgsend: can't send bundle. ION system problem. Investigate and correct before rerunning. the bundle simply did not go. tragic. 🙈

🐛 BUGS 🐛

Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>. tell them everything, they wanna know 🫶

👑 SEE ALSO 👑

the whole friend group. go read them all. iykyk. 💖

and that's the tea, bestie — this page came from perl v5.24.1, dated 2016-07-07, under LGSEND(1). periodt. ✨💅

📦 where this page comes from