table of contents
| 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)| 2016-07-07 | perl v5.24.1 |