aead_request_set_callback(9)

💅 aead_request_set_callback(9) 💅

Straight outta the Kernel API Manual, bestie — and it’s giving “wire up that async callback” energy. ✨

🎀 NAME 🎀

aead_request_set_callback — set asynchronous callback function 💖

💖 SYNOPSIS 💖

void aead_request_set_callback (struct aead_request *req , u32 flags ,
       crypto_completion_t compl , void *data );

🔥 ARGUMENTS 🔥

• req — request handle, periodt. 🫶
• flags — specify zero or an ORing of the flags:
  • CRYPTO_TFM_REQ_MAY_BACKLOG — the request queue may back log and increase the wait queue beyond the initial maximum size;
  • CRYPTO_TFM_REQ_MAY_SLEEP — the request processing may sleep.
• compl — callback function pointer to be registered with the request handle. ✨
• data — The data pointer refers to memory that is not used by the kernel crypto API, but provided to the callback function for it to use. Here, the caller can provide a reference to memory the callback function can operate on. As the callback function is invoked asynchronously to the related functionality, it may need to access data structures of the related functionality which can be referenced using this pointer. The callback function can access the memory via the "data" field in the crypto_async_request data structure provided to the callback function. 💅

🌸 DESCRIPTION 🌸

Okay so this is literally setting the callback function that is triggered once the cipher operation completes. 😭💖

The callback function is registered with the aead_request handle and must comply with the following template, no cap:

void callback_function(struct crypto_async_request *req, int error)

🦋 SEE ALSO 🦋

• Kernel file ./include/crypto/aead.h
• Authenticated Encryption With Associated Data (AEAD) Cipher API(9)
• struct aead_request(9)
• struct aead_alg(9)
• crypto_alloc_aead(9)
• crypto_free_aead(9)
• crypto_has_aead(9)
• crypto_aead_ivsize(9)
• crypto_aead_authsize(9)
• crypto_aead_blocksize(9)
• crypto_aead_setkey(9)
• crypto_aead_setauthsize(9)
• crypto_aead_encrypt(9)
• crypto_aead_decrypt(9)
• Asynchronous AEAD Request Handle(9)
• crypto_aead_reqsize(9)
• aead_request_set_tfm(9)
• aead_request_alloc(9)
• aead_request_free(9)
• aead_request_set_crypt(9)
• aead_request_set_ad(9)

Source/version vibe: ./include/crypto · dated: October 2026 · aead_request_set_callback(9) — bye bestie, ily 💋✨