Skip to content

NAME

ltpdriver - LTP transmission test program

SYNOPSIS

ltpdriver remoteEngineNbr clientId nbrOfCycles greenLength [ totalLength]

DESCRIPTION

ltpdriver uses LTP to send nbrOfCycles service data units of length indicated by totalLength, of which the trailing greenLength bytes are sent unreliably, to the ltpcounter client service process for client service number clientId attached to the remote LTP engine identified by remoteEngineNbr. If omitted, length defaults to 60000. If length is 1, the sizes of the transmitted service data units will be randomly selected multiples of 1024 in the range 1024 to 62464.

Whenever the size of the transmitted service data unit is less than or equal to greenLength, the entire SDU is sent unreliably.

When all copies of the file have been sent, ltpdriver prints a performance report.

EXIT STATUS

  • "0"

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

  • "1"

    ltpdriver was unable to start, because it could not attach to the LTP protocol on the local node. Run ltpadmin to start LTP, then try again.

FILES

The service data units transmitted by ltpdriver are sequences of text obtained from a file in the current working directory named "ltpdriverAduFile", which ltpdriver creates automatically.

ENVIRONMENT

No environment variables apply.

DIAGNOSTICS

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

  • ltpdriver can't initialize LTP.

    ltpadmin has not yet initialized LTP protocol operations.

  • Can't create ADU file

    Operating system error. Check errtext, correct problem, and rerun.

  • Error writing to ADU file

    Operating system error. Check errtext, correct problem, and rerun.

  • ltpdriver can't create file ref.

    ION system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

  • ltpdriver can't create ZCO.

    ION system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

  • ltpdriver can't send message.

    LTP span to the remote engine has been stopped.

  • ltp_send failed.

    LTP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

BUGS

Report bugs to <https://github.com/nasa-jpl/ION-DTN/issues>

SEE ALSO

ltpadmin(1), ltpcounter(1), ltp(3)