cpacf_kma(9)

πŸ“¦ version 7.3.1, in nixpkgs unstable

πŸ’… cpacf_kma(9) β€” KMA instruction, but make it make sense πŸ’…

Okay bestie, welcome to the Kernel API Manual entry for cpacf_kma β€” no cap, this is the function that executes the KMA (CIPHER MESSAGE WITH AUTHENTICATION) instruction. It’s giving kernel crypto, and honestly? Iconic. 🫢✨


✨ NAME ✨

cpacf_kma β€” executes the KMA (CIPHER MESSAGE WITH AUTHENTICATION) instruction. Periodt. πŸ’–


πŸ¦‹ SYNOPSIS πŸ¦‹

void cpacf_kma (unsigned long func , void *param , u8 *dest , const u8
       *src , unsigned long src_len , const u8 *aad , unsigned long aad_len );

Exact signature, copy-paste ready, protected by vibes. ✨


🌸 ARGUMENTS 🌸

Okay these are the little cuties you pass in:

  • func β€” the function code passed to KMA; see the CPACF_KMA_xxx defines. This is literally the β€œwhat are we doing” knob. πŸ‘‘
  • param β€” address of the parameter block; see POP for details on each func. Your parameter-block bestie lives here. πŸŽ€
  • dest β€” address of the destination memory area. This is the destination address, bestie. πŸ’…
  • src β€” address of the source memory area. This is the source address, fr fr. πŸ¦‹
  • src_len β€” length of the src operand in bytes. Count those bytes, no cap. πŸ”’
  • aad β€” address of the additional authenticated data memory area. AAD said β€œI’m the moment.” 🌟
  • aad_len β€” length of the aad operand in bytes. Another byte count, another slay. πŸ’–

πŸ’€ SEE ALSO πŸ’€

Kernel file ./arch/s390/include/asm/cpacf.h and the whole cpacf friend group:


🌸 Cute sign-off: source/version ./arch/s390/include/asm, date October 2026, page cpacf_kma(9) β€” mwah, go forth and KMA responsibly πŸ’‹βœ¨

πŸ“¦ where this page comes from