.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" 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 >0, 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
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\"
.\" 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 "LGAGENT 1"
.TH LGAGENT 1 "2016-07-07" "perl v5.24.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"
lgagent \- ION Load/Go remote agent program
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBlgagent\fR \fIown_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 \fBlgagent\fR task on a given node opens the indicated \s-1ION\s0 endpoint
for bundle reception, receives the extracted payloads of Load/Go bundles
sent to it by \fBlgsend\fR as run on one or more remote nodes, and processes
those payloads, which are the text of Load/Go source files.
.PP
Load/Go source file content is limited to newline-terminated lines of \s-1ASCII\s0
characters.  More specifically, the text of any Load/Go source file is a
sequence of \fIline sets\fR of two types: \fIfile capsules\fR and \fIdirectives\fR.
Any Load/Go source file may contain any number of file capsules and any
number of directives, freely intermingled in any order, but the typical
structure of a Load/Go source file is simply a single file capsule
followed by a single directive.
.PP
When \fBlgagent\fR identifies a file capsule, it copies all of the capsule's
text lines to a new file that it creates in the current working directory.
When \fBlgagent\fR identifies a directive, it executes the directive by
passing the text of the directive to the \fIpseudoshell()\fR function
(see \fIplatform\fR\|(3)).  \fBlgagent\fR processes the line sets of a Load/Go source
file in the order in which they appear in the file, so the text
of a directive may reference a file that was created as the result of
processing a prior file capsule in the same source file.
.SH "EXIT STATUS"
.IX Header "EXIT STATUS"
.ie n .IP """0""" 4
.el .IP "``0''" 4
.IX Item "0"
Load/Go remote agent processing has terminated.
.SH "FILES"
.IX Header "FILES"
\&\fBlgfile\fR contains the Load/Go file capsules and directives that are to be
processed.
.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 "lgagent: can't attach to \s-1BP.\s0" 4
.IX Item "lgagent: can't attach to BP."
Bundle Protocol is not running on this computer.  Run \fIbpadmin\fR\|(1) to start \s-1BP.\s0
.IP "lgagent: can't open own endpoint." 4
.IX Item "lgagent: 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 "lgagent: bundle reception failed." 4
.IX Item "lgagent: bundle reception failed."
\&\s-1ION\s0 system problem.  Investigate and correct before restarting.
.IP "lgagent cannot continue." 4
.IX Item "lgagent cannot continue."
lgagent processing problem.  See earlier diagnostic messages for details.
Investigate and correct before restarting.
.IP "lgagent: no space for bundle content." 4
.IX Item "lgagent: no space for bundle content."
\&\s-1ION\s0 system problem: have exhausted available \s-1SDR\s0 data store reserves.
.IP "lgagent: can't receive bundle content." 4
.IX Item "lgagent: can't receive bundle content."
\&\s-1ION\s0 system problem: have exhausted available \s-1SDR\s0 data store reserves.
.IP "lgagent: can't handle bundle delivery." 4
.IX Item "lgagent: can't handle bundle delivery."
\&\s-1ION\s0 system problem.  Investigate and correct before restarting.
.IP "lgagent: pseudoshell failed." 4
.IX Item "lgagent: pseudoshell failed."
Error in directive line, usually an attempt to execute a non-existent
administration program (e.g., a misspelled program name).  Terminates
processing of source file content.
.PP
A variety of other diagnostics noting source file parsing problems may also
be reported.  These errors are non-fatal but they terminate the processing
of the source file content from the most recently received bundle.
.SH "BUGS"
.IX Header "BUGS"
Report bugs to <ion\-bugs@korgano.eecs.ohiou.edu>
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIlgsend\fR\|(1), \fIlgfile\fR\|(5)