NAME

acslist - Aggregate Custody Signals (ACS) utility for checking custody IDs.

SYNOPSIS

acslist [-s|--stdout]

DESCRIPTION

acslist is a utility program that lists all mappings from bundle ID to custody ID currently in the local bundle agent's ACS ID database, in no specific order. A bundle ID (defined in RFC5050) is the tuple of (source EID, creation time, creation count, fragment offset, fragment length). A custody ID (defined in draft-jenkins-aggregate-custody-signals) is an integer that the local bundle agent will be able to map to a bundle ID for the purposes of aggregating and compressing custody signals.

The format for mappings is:

(ipn:13.1,333823688,95,0,0)->(26)

While listing, acslist also checks the custody ID database for self-consistency, and if it detects any errors it will print a line starting with "Mismatch:" and describing the error.

-s|--stdout tells acslist to print results to stdout, rather than to the ION log.

EXIT STATUS

"0"

acslist terminated after verifying the consistency of the custody ID database.
"1"

acslist was unable to attach to the ACS database, or it detected an inconsistency.

FILES

No configuration files are needed.

ENVIRONMENT

No environment variables apply.

DIAGNOSTICS

The following diagnostics may be issued:

Can't attach to ACS.

acsadmin has not yet initialized ACS operations.
Mismatch: (description of the mismatch)

acslist detected an inconsistency in the database; this is a bug in ACS.

BUGS

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