xenial (1) acslist.1.gz

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)