Skip to content

NAME

recvfile - Bundle Protocol (BP) file reception utility

SYNOPSIS

recvfile own_endpoint_ID [-o|--overwrite] [key_file_path | literal_key_value]

DESCRIPTION

recvfile is intended to serve as the counterpart to sendfile. It uses bp_receive() to receive bundles containing the file content. The content of each bundle is written to a file and named using data extracted from the metadata header. The program's default behavior auto-encrements file names but this behavior can be disabled with the -o (or --overwrite) flag.

Additionally, if used with ION-NASA Baseline, recvfile allows for the decryption of encrypted files sent by sendfile. To enable decryption use the path to a valid HMAC key or a literal key value.

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

Use ^C to terminate the program at any time.

EXIT STATUS

  • "0"

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

  • recvfile bundle reception failed.

    BP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

  • recvfile: can't open test file

    File system error. recvfile terminates.

  • recvfile: can't receive bundle content.

    BP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

  • recvfile: can't write to test file

    File system error. recvfile terminates.

  • recvfile cannot continue.

    BP system error. Check for earlier diagnostic messages describing the cause of the error; correct problem and rerun.

  • recvfile: 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

sendfile(1), bp(3), metadata(3), secrypt(3)