KCAPI_AEAD_AUTHSIZE(3)

πŸ’– KCAPI_AEAD_AUTHSIZE β€” ok so bestie, meet your new fave function πŸ’–

Like, this is a page from the libkcapi manual (section 3, the library-functions girlies ✨), and it's all about one little function that tells you how big your authentication tag can get. Short page, big vibes, let's go πŸŽ€


✨ NAME ✨

kcapi_aead_authsize β€” return the maximum size of the tag 🏷️


🌸 SYNOPSIS 🌸

uint32_t kcapi_aead_authsize(struct kcapi_handle * handle);

πŸ¦‹ ARGUMENTS πŸ¦‹

  • handle β€” [in] the cipher handle, aka your little passport to the cipher world 🫢

πŸ‘‘ DESCRIPTION πŸ‘‘

okay so here's the tea β˜• β€” what this function hands back to you is the maximum: like, the biggest size of the authentication tag that your AEAD cipher can possibly produce πŸ’…

And bestie, "maximum" is doing real work in that sentence, because smaller tag sizes may be chosen depending on the AEAD cipher type 🌈. So don't come for this function expecting the exact size you'll use β€” it's giving ceiling, not destiny ✨

What it returns, fr fr:

  • > 0 β€” specifying the block size πŸ‘‘
  • 0 β€” on error πŸ’€
no cap, if you get a 0 back, something went wrong β€” that's not a size, that's a vibe check that failed 😭

πŸ’œ AUTHOR πŸ’œ

Stephan Mueller <smueller@chronox.de> β€” author. icon, legend, the moment πŸ‘‘


That's all she wrote, bestie πŸŽ€ This page is from the libkcapi Manual, version 1.5.0, dated July 2025, and you'll find it filed under KCAPI_AEAD_AUTHSIZE(3) πŸ’–

go forth and authsize, you absolute main character πŸ¦‹βœ¨

πŸ“¦ where this page comes from