---
name: "lgsend"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/lgsend"
---

# lgsend(1)

ION Load/Go command program

## NAME

lgsend - ION Load/Go command program

## SYNOPSIS

**lgsend** *command\_file\_name* *own\_endpoint\_ID* *destination\_endpoint\_ID*

## DESCRIPTION

ION Load/Go is a system for management of an ION-based network, enabling the execution of ION administrative programs at remote nodes.  The system comprises two programs, **lgsend** and **lgagent**.

The **lgsend** program reads a Load/Go source file from a local file system, encapsulates the text of that source file in a bundle, and sends the bundle to an **lgagent** task that is waiting for data at a designated DTN endpoint on the remote node.

To do so, it first reads all lines of the Load/Go source file identified by *command\_file\_name* into a temporary buffer in ION's SDR data store, concatenating the lines of the file and retaining all newline characters. Then it invokes the *bp\_send()* function to create and send a bundle whose payload is this temporary buffer, whose destination is *destination\_endpoint\_ID*, and whose source endpoint ID is *own\_endpoint\_ID*.  Then it terminates.

## EXIT STATUS

- "0"

  Load/Go file transmission succeeded.

- "1"

  Load/Go file transmission failed.  Examine **ion.log** to determine the cause of the failure, then re-run.

## FILES

**lgfile** contains the Load/Go file capsules and directive that are to be sent to the remote node.

## ENVIRONMENT

No environment variables apply.

## DIAGNOSTICS

The following diagnostics may be issued to the **ion.log** log file:

- lgsend: can't attach to BP.

  Bundle Protocol is not running on this computer.  Run [*bpadmin*(1)](/bpadmin/1.md) to start BP.

- lgsend: can't open own endpoint.

  *own\_endpoint\_ID* is not a declared endpoint on the local ION node. Run [*bpadmin*(1)](/bpadmin/1.md) to add it.

- lgsend: can't open file of LG commands: *error description*

  *command\_file\_name* doesn't identify a file that can be opened.  Correct spelling of file name or file's access permissions.

- lgsend: can't get size of LG command file: *error description*

  Operating system problem.  Investigate and correct before rerunning.

- lgsend: LG cmd file size \> 64000.

  Load/Go command file is too large.  Split it into multiple files if possible.

- lgsend: no space for application data unit.

  ION system problem: have exhausted available SDR data store reserves.

- 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.

- lgsend: can't send bundle.

  ION system problem.  Investigate and correct before rerunning.

## BUGS

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

## SEE ALSO

[*lgagent*(1)](/lgagent/1.md), [*lgfile*(5)](/lgfile/5.md)