Skip to content

NAME

bpsendtest - Bundle Protocol (BP) file-based throughput testing utility

SYNOPSIS

bpsendtest [-rep repetitions] [-ttl ttl] [-qos qos] [-nofile] srcEid destEid file

DESCRIPTION

NOTE: THIS UTILITY IS FOR TESTING PURPOSES ONLY

bpsendtest is a modified variant of bpsendfile and is intended to serve as the counterpart to bprecvtest. It first generates a minimal bundle with the contents "Go" to serve as a pilot bundle and inform bprecvtest to begin its timer. If -nofile is not specified, it then creates a bundle from the supplied file identified by file and sends that bundle a number of times equal to repetitions to the endpoint specified by destEid. If -nofile is specified, file is interpreted to be an integer describing the number of bytes to generate and send as a bundle. The bundle is sent once if repetitions is not supplied.

The bundle is sent with no custody transfer requested. When qos is omitted, the bundle is sent at standard priority; for details of the qos parameter, see bptrace(1) or run bpsendtest -h. ttl, if not specified, defaults to 300 seconds (5 minutes). NOTE that the final three arguments MUST be srcEid destEid file in their respective order.

EXIT STATUS

  • "0"

    bpsendtest has terminated.

FILES

No configuration files are needed.

ENVIRONMENT

No environment variables apply.

DIAGNOSTICS

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

  • Can't attach to BP.

    bpadmin has not yet initialized BP operations.

  • Can't open own endpoint.

    Another BP application task currently has srcEid open for bundle origination and reception. Try again after that task has terminated. If no such task exists, it may have crashed while still holding the endpoint open; the easiest workaround is to select a different source endpoint.

  • Can't stat the file

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

  • bpsendtest can't create file ref.

    Probably an unrecoverable database error, in which case the local ION node must be terminated and re-initialized.

  • bpsendtest can't create ZCO.

    Probably an unrecoverable database error, in which case the local ION node must be terminated and re-initialized.

  • bpsendtest can't send file in bundle.

    BP 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

bprecvtest(1), bpsendfile(1), bp(3)