NAME

sendfile - Bundle Protocol (BP) file transmission utility utilizing a "metadata header" for file name, timestamp, versioning, and auxiliary command strings, enabling file naming at the recvfile utility. Encryption is enabled when a HMAC key path (or literal value) is included in the command execution string.

Note: encryption requires a suitable cryptographic library and interface (which is avaiable with the ITAR controlled ION NASA Baseline).

SYNOPSIS

sendfile own endpoint ID destination endpoint ID file name [-c|--class class of service] [-t|--ttl time to live (seconds)] [key file path | literal key value]

DESCRIPTION

sendfile employs bp_send() to transmit a single bundle to a specified destination endpoint, incorporating the file's contents detailed by file_name. The process concludes following the bundle's dispatch, without initiating a custody transfer. The absence of class_of_service implies a standard priority delivery. Refer to bptrace(1) for details on class_of_service. Without a specified time_to_live, a default of 300 seconds (5 minutes) is assumed. Encryption can be facilitated by including a valid HMAC key (either a path or a literal value) when operating within the ITAR controlled ION NASA Baseline (ION-INB), provided a compatible cryptographic library is installed.

EXIT STATUS

"0"

Successful termination of sendfile.

FILES

No configuration files are necessary.

ENVIRONMENT

Not applicable.

DIAGNOSTICS

Diagnostic messages to ion.log may include:

Can't attach to BP.

Signifies BP operations have yet to be initialized by bpadmin.
Can't open own endpoint.

Indicates own_endpoint_ID is currently in use. Retry after the current task has concluded or opt for a different endpoint if a previous task crashed.
Can't stat the file

Suggests an operating system error. Check errtext, address the issue, and attempt the operation again.
sendfile can't create file ref.

Points to a potential critical database problem, likely requiring a reboot of the local ION node.
sendfile can't create ZCO.

Implies a serious database error, necessitating a restart of the ION node.
sendfile can't send file in bundle.

Reflects a BP system malfunction. Review earlier diagnostic messages for possible solutions.

BUGS

Report bugs to <https://github.com/nasa-jpl/ION-DTN/issues>.