Skip to content

NAME

bpsendfile - Bundle Protocol (BP) file transmission utility

SYNOPSIS

bpsendfile own_endpoint_ID destination_endpoint_ID file_name [class_of_service [time_to_live (seconds) ]]

DESCRIPTION

bpsendfile uses bp_send() to issue a single bundle to a designated destination endpoint, containing the contents of the file identified by file_name, then terminates. The bundle is sent with no custody transfer requested. When class_of_service is omitted, the bundle is sent at standard priority; for details of the class_of_service parameter, see bptrace(1). time_to_live, if not specified, defaults to 300 seconds (5 minutes). NOTE that time_to_live is specified AFTER class_of_service, rather than before it as in bptrace(1).

EXIT STATUS

  • "0"

    bpsendfile 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.

  • Can't stat the file

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

  • bpsendfile can't create file ref.

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

  • bpsendfile can't create ZCO.

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

  • bpsendfile 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

bprecvfile(1), bp(3)