arm_cca_report_new(9)

✨ arm_cca_report_new(9) ✨

okay so this is a page straight out of the Kernel API Manual and bestie, it's giving "secret handshake with the hardware" energy 🔐 — let's get into it.

🎀 NAME 🎀

arm_cca_report_new — generate a new attestation token, periodt.

🌸 SYNOPSIS 🌸

int arm_cca_report_new (struct tsm_report *report , void *data );

🦋 ARGUMENTS 🦋

• report — pointer to the TSM report context information. literally the whole report vibe lives here.
• data — pointer to the context specific data for this module. this is the module's own little stash of info.

💅 DESCRIPTION 💅

So what it does: it initialises the attestation token generation using the challenge data that you passed in through the TSM descriptor. Then it allocates memory for the attestation token, and retrieves that attestation token on the same CPU where the token generation was initialised. no cap, same CPU, that's the rule 👑

About that challenge data — it must be at least 32 bytes and no more than 64 bytes. And if you hand over less than 64 bytes, it gets zero padded up to 64 bytes. so don't stress about hitting exactly 64, it'll top you off 🫶

🔥 RETURN 🔥

• 0 — attestation token generated successfully. slay, we ate 💅
• -EINVAL — a parameter was not valid. one of your args said something unhinged 😭
• -ENOMEM — out of memory. the RAM said "not today" 💀
• -EFAULT — failed to get IPA for memory page(s). the memory page(s) ghosted us 🙈

🌈 SEE ALSO 🌈

• Kernel file ./drivers/virt/coco/arm-cca-guest/arm-cca-guest.c struct arm_cca_token_info(9)
• arm_cca_attestation_continue(9)
• arm_cca_guest_init(9)
• arm_cca_guest_exit(9)

k that's the whole page bestie, go be iconic with it 🧚‍♀️ this one lives in ./drivers/virt/coco/arm-cca-guest, dated October 2026 — mwah, xoxo 💖