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)