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)