DH_ACC(1)

πŸ“¦
version 2.3 Β· 4 versions
, in debian bookworm, ubuntu noble

πŸ’… DH_ACC β€” bestie edition πŸ’…

okay so you're looking at the manual page for dh_acc, from the dh-acc corner of the universe. pull up a chair, grab a strawberry πŸ“, and let's get into it.


✨ NAME ✨

dh_acc β€” the abi-compliance-checker dump generator and comparison girlie. she does both. she's booked and busy. πŸ‘‘


✨ SYNOPSIS ✨

dh_acc [debhelper options]

✨ DESCRIPTION ✨

so dh_acc is a debhelper program, and her whole job β€” her main character job β€” is generating abi-compliance-checker dumps and comparing them against a 'base' dump, all at build time. πŸ› οΈβœ¨

the way that this slaps is that it lets you monitor API/ABI breakage and catch it early. like, early-early. no cap, it's giving "we caught the breaking change before your users did." πŸ’€πŸ«Ά


✨ FILES ✨

  • debian/package.acc β€” this is where you drop literally any abi-compliance-checker acceptable library and header descriptor. want a stub XML template to start from? run abi-compliance-checker -d and she'll hand you one, periodt. or β€” and honestly this is the lowkey easy route β€” you can just specify a list of headers, libraries, or directories. 🌸
okay bestie, important: those paths should be specified relative to the source package root directory, e.g. ./debian/tmp/usr/lib/, ./build-2.7/ etc. don't be out here putting absolute paths, iykyk. πŸŽ€
  • debian/package.abi.tar.gz β€” this is the base API/ABI you want to stay compatible with. the newly generated API/ABI dump gets compared against this one, if it's available. it's the glow-up reference photo. πŸ“ΈπŸ’œ

✨ SEE ALSO ✨

this program is a part of debhelper. she's not solo, she's in the group chat. πŸ’–


✨ AUTHOR ✨

Dmitrijs Ledkovs <xnox@debian.org> β€” shoutout, icon behavior, we love an author credit. πŸ‘‘


dh-acc v2.3-2 🌈 2023-02-23

and that's the whole page, bestie!! πŸ¦‹βœ¨ you read the entire manual, you're literally so academic for that. slay. go build something and let dh_acc keep your ABI safe. mwah πŸ’…πŸ’–

πŸ“¦ where this page comes from