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>