NAME

       udpclo - UDP-based BP convergence layer output task

SYNOPSIS

       udpclo

DESCRIPTION

       udpclo is a background "daemon" task that extracts bundles from the queues of bundles
       ready for transmission via UDP to remote bundle protocol agents, encapsulates them in UDP
       datagrams, and sends those datagrams to the appropriate remote UDP sockets as indicated by
       the host names and UDP port numbers (destination induct names) associated with the bundles
       by the routing daemons that enqueued them.

       Note that udpclo is a "promiscuous" CLO daemon, able to transmit bundles to any UDP
       destination induct.  Its duct name is '*' rather than the induct name of any single UDP
       destination induct to which it might be dedicated, so scheme configuration directives that
       cite this outduct must provide destination induct IDs.  For the UDP convergence-layer
       protocol, destination induct IDs are identical to induct names, i.e., they are of the form
       local_hostname[:local_port_nbr].

       udpclo is spawned automatically by bpadmin in response to the 's' (START) command that
       starts operation of the Bundle Protocol, and it is terminated by bpadmin in response to an
       'x' (STOP) command.  udpclo 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" udpclo 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 udpclo.

       "1" udpclo 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 udpclo.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

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

       udpclo can't attach to BP.
           bpadmin has not yet initialized Bundle Protocol operations.

       No memory for UDP buffer in udpclo.
           ION system error.  Check errtext, correct problem, and restart UDP.

       No such udp duct.
           No UDP outduct with duct name '*' has been added to the BP database.  Use bpadmin to
           stop the UDP convergence-layer protocol, add the outduct, and then restart the UDP
           protocol.

       CLO task is already started for this engine.
           Redundant initiation of udpclo.

       CLO can't open UDP socket
           Operating system error.  Check errtext, correct problem, and restart udpclo.

       CLO write() error on socket
           Operating system error.  Check errtext, correct problem, and restart udpclo.

       Bundle is too big for UDP CLA.
           Configuration error: bundles that are too large for UDP transmission (i.e., larger
           than 65535 bytes) are being enqueued for udpclo.  Change routing.

BUGS

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

SEE ALSO

       bpadmin(1), bprc(5), udpcli(1)