UDPLSO(1)							  LTP executables							 UDPLSO(1)

NAME

       udplso - UDP-based LTP link service output task

SYNOPSIS

       udplso {remote_engine_hostname | @}[:remote_port_nbr] [txbps] remote_engine_nbr

DESCRIPTION

       udplso is a background "daemon" task that extracts LTP segments from the queue of segments bound for the indicated remote LTP engine,
       encapsulates them in UDP datagrams, and sends those datagrams to the indicated UDP port on the indicated host.  If not specified, port
       number defaults to 1113.

       UDP congestion can be controlled by setting udplso's rate of UDP datagram transmission txbps (transmission rate in bits per second) to the
       value that is supported by the underlying network.

       Each "span" of LTP data interchange between the local LTP engine and a neighboring LTP engine requires its own link service output task,
       such as udplso.	All link service output tasks are spawned automatically by ltpadmin in response to the 's' command that starts operation
       of the LTP protocol, and they are all terminated by ltpadmin in response to an 'x' (STOP) command.

EXIT STATUS

       0   udplso 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 ltpadmin to restart udplso.

       1   udplso terminated abnormally, for reasons noted in the ion.log file.  Investigate and solve the problem identified in the log file,
	   then use ltpadmin to restart udplso.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

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

       udplso can't initialize LTP.
	   ltpadmin has not yet initialized LTP protocol operations.

       No such engine in database.
	   remote_engine_nbr is invalid, or the applicable span has not yet been added to the LTP database by ltpadmin.

       LSO task is already started for this engine.
	   Redundant initiation of udplso.

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

       LSO can't connect UDP socket
	   Operating system error.  Check errtext, correct problem, and restart udplso.

       Segment is too big for UDP LSO.
	   Configuration error: segments that are too large for UDP transmission (i.e., larger than 65535 bytes) are being enqueued for udplso.
	   Use ltpadmin to change maximum segment size for this span.

BUGS

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

SEE ALSO

       ltpadmin(1), ltpmeter(1), udplsi(1), owltsim(1)

perl v5.14.2							    2012-05-25								 UDPLSO(1)