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) 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) 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),
lgfile(5)