---
name: "acslist"
section: "1"
platform: "linux"
package: "ion"
version: "3.2.1+dfsg-1.1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/acslist"
---

# acslist(1)

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

## 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)](/acsadmin/1.md), [*bplist*(1)](/bplist/1.md)