Skip to content

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)