.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "LGSEND 1"
.TH LGSEND 1 "2014-07-08" "perl v5.20.1" "BP executables"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
lgsend \- ION Load/Go command program
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBlgsend\fR \fIcommand_file_name\fR \fIown_endpoint_ID\fR \fIdestination_endpoint_ID\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\s-1ION\s0 Load/Go is a system for management of an ION-based network, enabling the
execution of \s-1ION\s0 administrative programs at remote nodes.  The system
comprises two programs, \fBlgsend\fR and \fBlgagent\fR.
.PP
The \fBlgsend\fR 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 \fBlgagent\fR task that is waiting for data at a designated \s-1DTN\s0 endpoint
on the remote node.
.PP
To do so, it first reads all lines of the Load/Go source file identified
by \fIcommand_file_name\fR into a temporary buffer in \s-1ION\s0's \s-1SDR\s0 data store,
concatenating the lines of the file and retaining all newline characters.
Then it invokes the \fIbp_send()\fR function to create and send a bundle whose
payload is this temporary buffer, whose destination is
\&\fIdestination_endpoint_ID\fR, and whose source endpoint \s-1ID\s0 is
\&\fIown_endpoint_ID\fR.  Then it terminates.
.SH "EXIT STATUS"
.IX Header "EXIT STATUS"
.ie n .IP """0""" 4
.el .IP "``0''" 4
.IX Item "0"
Load/Go file transmission succeeded.
.ie n .IP """1""" 4
.el .IP "``1''" 4
.IX Item "1"
Load/Go file transmission failed.  Examine \fBion.log\fR to determine the
cause of the failure, then re-run.
.SH "FILES"
.IX Header "FILES"
\&\fBlgfile\fR contains the Load/Go file capsules and directive that are to
be sent to the remote node.
.SH "ENVIRONMENT"
.IX Header "ENVIRONMENT"
No environment variables apply.
.SH "DIAGNOSTICS"
.IX Header "DIAGNOSTICS"
The following diagnostics may be issued to the \fBion.log\fR log file:
.IP "lgsend: can't attach to \s-1BP.\s0" 4
.IX Item "lgsend: can't attach to BP."
Bundle Protocol is not running on this computer.  Run \fIbpadmin\fR\|(1) to start \s-1BP.\s0
.IP "lgsend: can't open own endpoint." 4
.IX Item "lgsend: can't open own endpoint."
\&\fIown_endpoint_ID\fR is not a declared endpoint on the local \s-1ION\s0 node.
Run \fIbpadmin\fR\|(1) to add it.
.IP "lgsend: can't open file of \s-1LG\s0 commands: \fIerror description\fR" 4
.IX Item "lgsend: can't open file of LG commands: error description"
\&\fIcommand_file_name\fR doesn't identify a file that can be opened.  Correct
spelling of file name or file's access permissions.
.IP "lgsend: can't get size of \s-1LG\s0 command file: \fIerror description\fR" 4
.IX Item "lgsend: can't get size of LG command file: error description"
Operating system problem.  Investigate and correct before rerunning.
.IP "lgsend: \s-1LG\s0 cmd file size > 64000." 4
.IX Item "lgsend: LG cmd file size > 64000."
Load/Go command file is too large.  Split it into multiple files if possible.
.IP "lgsend: no space for application data unit." 4
.IX Item "lgsend: no space for application data unit."
\&\s-1ION\s0 system problem: have exhausted available \s-1SDR\s0 data store reserves.
.IP "lgsend: fgets failed: \fIerror description\fR" 4
.IX Item "lgsend: fgets failed: error description"
Operating system problem.  Investigate and correct before rerunning.
.IP "lgsend: can't create application data unit." 4
.IX Item "lgsend: can't create application data unit."
\&\s-1ION\s0 system problem: have exhausted available \s-1SDR\s0 data store reserves.
.IP "lgsend: can't send bundle." 4
.IX Item "lgsend: can't send bundle."
\&\s-1ION\s0 system problem.  Investigate and correct before rerunning.
.SH "BUGS"
.IX Header "BUGS"
Report bugs to <ion\-bugs@korgano.eecs.ohiou.edu>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIlgagent\fR\|(1), \fIlgfile\fR\|(5)