NAME
bprecvtest - Bundle Protocol (BP) file-based throughput testing utility
SYNOPSIS
bprecvtest own_endpoint_ID [max_files]
DESCRIPTION
NOTE: THIS UTILITY IS FOR TESTING PURPOSES ONLY
bprecvtest is a modified variant of bprecvfile and is intended to serve as the counterpart to bpsendtest. It uses bp_receive() to receive bundles containing file content. The content of each bundle is simply discarded upon full reception after counting the size of the recieved data.
If a max_files value of N (where N > 0) is provided, the program will terminate automatically upon completing its Nth file reception. Otherwise it will run indefinitely; use ^C to terminate the program.
Upon termination, the program will display the number of bytes recieved in files, the time between the reception of the pilot bundle and the final completed bundle, and the calculated throughput.
EXIT STATUS
-
"0"
bprecvtest 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 own_endpoint_ID 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.
-
bprecvtest bundle reception failed.
BP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
-
bprecvtest: can't open test file
File system error. bprecvtest terminates.
-
bprecvtest: can't receive bundle content.
BP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
-
bprecvtest: can't write to test file
File system error. bprecvtest terminates.
-
bprecvtest cannot continue.
BP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.
-
bprecvtest: can't handle bundle delivery.
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
bpsendtest(1), bprecvfile(1), bp(3)