ACSLIST(1)

📦 version 3.2.1, in ubuntu jammy

✨ ACSLIST(1) ✨

BP executables 🎀

💖 NAME 💖

okay bestie, the name is acslist 🦋, an Aggregate Custody Signals (ACS) utility for checking custody IDs. ngl the name says it all ✨

🧚 SYNOPSIS 🧚

acslist [-s|--stdout]

🌸 DESCRIPTION 🌸

okay so acslist is a utility program that lists every mapping from bundle ID to custody ID currently sitting 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 can map to a bundle ID, so it can aggregate and compress custody signals. it's giving efficiency 🔥

The format for mappings looks like this:

(ipn:13.1,333823688,95,0,0)->(26)

While listing, acslist also runs a self-consistency check on the custody ID database 🙈. If it finds any errors, it prints a line starting with "Mismatch:" and describes the error, so you'll know exactly what's up.

  • -s|--stdout — tells acslist to print results to stdout 🖨️, instead of the ION log. no cap, this is the one to use if you want to see the output right in your terminal 💜

👑 EXIT STATUS 👑

  • "0" — acslist terminated after verifying the consistency of the custody ID database. ✅ slay
  • "1" — acslist was unable to attach to the ACS database, or it detected an inconsistency. 💀

🦋 FILES 🦋

no configuration files needed, literally nothing to set up 🫶

🌈 ENVIRONMENT 🌈

no environment variables apply here 💅

🚨 DIAGNOSTICS 🚨

the following diagnostics may be issued, so keep an eye out 👀:

  • Can't attach to ACS. — acsadmin has not yet initialized ACS operations. go get it started first, bestie 🧚
  • Mismatch: (description of the mismatch) — acslist detected an inconsistency in the database. this is a bug in ACS 😭

🐛 BUGS 🐛

ugh, if you find a bug, report it to <ion-bugs@korgano.eecs.ohiou.edu> 🙏

🔗 SEE ALSO 🔗

check out acsadmin(1) and bplist(1) 💖, they're the main character sidekicks ✨

ok that's the whole tea 🍓 this page was last updated by perl v5.24.1 on 2016-07-07, filed under ACSLIST(1), iykyk 🌸💜

📦 where this page comes from