LTPCOUNTER(1)							  LTP executables						     LTPCOUNTER(1)

NAME

       ltpcounter - LTP reception test program

SYNOPSIS

       ltpcounter client_ID [max_nbr_of_bytes]

DESCRIPTION

       ltpcounter uses LTP to receive service data units flagged with client service number client_ID from a remote ltpdriver client service
       process.  When the total number of bytes of client service data it has received exceeds max_nbr_of_bytes, it terminates and prints
       reception and cancellation statistics.  If max_nbr_of_bytes is omitted, the default limit is 2 billion bytes.

       While receiving data, ltpcounter prints a 'v' character every 5 seconds to indicate that it is still alive.

EXIT STATUS

       0   ltpcounter has terminated.  Any problems encountered during operation will be noted in the ion.log log file.

       1   ltpcounter was unable to start, because it could not attach to the LTP protocol on the local node or could not open access to client
	   service clientId.

	   In the former case, run ltpadmin to start LTP and try again.

	   In the latter case, some other client service task has already opened access to client service clientId.  If no such task is currently
	   running (e.g., it crashed while holding the client service open), use ltpadmin to stop and restart the LTP protocol.

FILES

       No configuration files are needed.

ENVIRONMENT

       No environment variables apply.

DIAGNOSTICS

       Diagnostic messages produced by ltpcounter are written to the ION log file ion.log.

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

       ltpcounter can't open client access.
	   Another task has opened access to service client clientId and has not yet relinquished it.

       Can't get LTP notice.
	   LTP system error.  Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

BUGS

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

SEE ALSO

       ltpadmin(1), ltpdriver(1), ltp(3)

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