ACSLIST(1) BP executables ACSLIST(1)
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 <ion-bugs@korgano.eecs.ohiou.edu>
SEE ALSO
acsadmin(1), bplist(1)
perl v5.14.2 2012-05-25 ACSLIST(1)