crypto_alloc_shash(9)

💖 crypto_alloc_shash(9) — Kernel API Manual 💖

okay so bestie, welcome to the Kernel API Manual page for crypto_alloc_shash(9) — it's the moment you finally get your hands on a message digest handle and honestly? iconic. 💅

---

🌸 NAME 🌸

crypto_alloc_shash — allocate message digest handle

---

✨ SYNOPSIS ✨

struct crypto_shash * crypto_alloc_shash (const char *alg_name , u32
       type , u32 mask );

Like, that's the whole vibe: you hand it a name, a type and a mask, and it hands you back a pointer to a struct crypto_shash. 🫶

---

🎀 ARGUMENTS 🎀

• alg_name — this is the cra_name / name or the cra_driver_name / driver name of the message digest cipher. so like, whichever of those two naming schemes you're feeling, it works 💫
• type — specifies the type of the cipher 👑
• mask — specifies the mask for the cipher 🦋

---

💜 DESCRIPTION 💜

Allocate a cipher handle for a message digest. The returned struct crypto_shash is the cipher handle that is required for any subsequent API invocation for that message digest. no cap — that handle is your main character, you literally cannot do the follow-up calls without it. 🔥

---

⭐ RETURN ⭐

• allocated cipher handle in case of success ✨
• IS_ERR is true in case of an error, and PTR_ERR returns the error code 😭

so yeah, vibe check your pointer before you go wild with it, bestie. 🙈

---

🌈 SEE ALSO 🌈

feel free to go down this absolute rabbit hole, iykyk 💀:

• Kernel file ./include/crypto/hash.h Message Digest Algorithm Definitions(9)
• struct ahash_alg(9)
• struct shash_alg(9)
• Asynchronous Message Digest API(9)
• crypto_alloc_ahash(9)
• crypto_free_ahash(9)
• crypto_has_ahash(9)
• crypto_ahash_blocksize(9)
• crypto_ahash_digestsize(9)
• crypto_ahash_statesize(9)
• crypto_ahash_reqtfm(9)
• crypto_ahash_reqsize(9)
• crypto_ahash_setkey(9)
• crypto_ahash_finup(9)
• crypto_ahash_final(9)
• crypto_ahash_digest(9)
• crypto_ahash_export(9)
• crypto_ahash_import(9)
• crypto_ahash_init(9)
• crypto_ahash_update(9)
• Asynchronous Hash Request Handle(9)
• ahash_request_set_tfm(9)
• ahash_request_alloc(9)
• ahash_request_free(9)
• ahash_request_set_callback(9)
• ahash_request_set_crypt(9)
• ahash_request_set_virt(9)
• Synchronous Message Digest API(9)
• crypto_free_shash(9)
• crypto_shash_blocksize(9)
• crypto_shash_digestsize(9)
• crypto_shash_descsize(9)
• crypto_shash_setkey(9)
• crypto_shash_digest(9)
• crypto_shash_tfm_digest(9)
• crypto_shash_export(9)
• crypto_shash_import(9)
• crypto_shash_init(9)
• crypto_shash_finup(9)
• crypto_shash_update(9)
• crypto_shash_final(9)

---

and that's the whole page, bestie 🧚💖 this gem lives in ./include/crypto, it's dated October 2026, and yes it's still titled crypto_alloc_shash(9). go forth and digest, periodt. 💅🎀