NAME¶
udpcli - UDP-based BP convergence layer input task
SYNOPSIS¶
udpcli local_hostname[:
local_port_nbr]
DESCRIPTION¶
udpcli is a background "daemon" task that receives UDP
datagrams via a UDP socket bound to
local_hostname and
local_port_nbr, extracts bundles from those datagrams, and passes them
to the bundle protocol agent on the local ION node.
If not specified, port number defaults to 4556.
The convergence layer input task is spawned automatically by
bpadmin in
response to the 's' (START) command that starts operation of the Bundle
Protocol; the text of the command that is used to spawn the task must be
provided at the time the "udp" convergence layer protocol is added
to the BP database. The convergence layer input task is terminated by
bpadmin in response to an 'x' (STOP) command.
udpcli can also be
spawned and terminated in response to START and STOP commands that pertain
specifically to the UDP convergence layer protocol.
EXIT STATUS¶
- 0
- udpcli terminated normally, for reasons noted in the
ion.log file. If this termination was not commanded, investigate
and solve the problem identified in the log file and use bpadmin to
restart udpcli.
- 1
- udpcli terminated abnormally, for reasons noted in
the ion.log file. Investigate and solve the problem identified in
the log file, then use bpadmin to restart udpcli.
FILES¶
No configuration files are needed.
ENVIRONMENT¶
No environment variables apply.
DIAGNOSTICS¶
The following diagnostics may be issued to the
ion.log log file:
- udpcli can't attach to BP.
- bpadmin has not yet initialized Bundle Protocol
operations.
- No such udp duct.
- No UDP induct matching local_hostname and
local_port_nbr has been added to the BP database. Use
bpadmin to stop the UDP convergence-layer protocol, add the induct,
and then restart the UDP protocol.
- CLI task is already started for this duct.
- Redundant initiation of udpcli.
- Can't get IP address for host
- Operating system error. Check errtext, correct problem, and
restart UDP.
- Can't open UDP socket
- Operating system error. Check errtext, correct problem, and
restart UDP.
- Can't initialize socket
- Operating system error. Check errtext, correct problem, and
restart UDP.
- udpcli can't create receiver thread
- Operating system error. Check errtext, correct problem, and
restart UDP.
BUGS¶
Report bugs to <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO¶
bpadmin(1),
bprc(5),
udpclo(1)