hcrypto_misc(3)

✨ NAME ✨

hcrypto_misc — the hcrypto miscellaneous functions, aka the little grab-bag of crypto goodies that didn't fit anywhere else 💖

---

🌸 SYNOPSIS 🌸

Functions

int PKCS5_PBKDF2_HMAC (const void *password, size_t password_len,
    const void *salt, size_t salt_len, unsigned long iter,
    const EVP_MD *md, size_t keylen, void *key)
int PKCS5_PBKDF2_HMAC_SHA1 (const void *password, size_t password_len,
    const void *salt, size_t salt_len, unsigned long iter,
    size_t keylen, void *key)

---

💅 Detailed Description 💅

okay so bestie, this page is the home of the key-derivation girlies. two functions, both doing the PKCS5 thing: you hand over a password, a salt and an iteration counter, and it hands you back a shiny crypto key. no cap, that's the whole vibe. 👑

---

👑 Function Documentation 👑

int PKCS5_PBKDF2_HMAC (const void * password, size_t password_len, const void * salt, size_t salt_len, unsigned long iter, const EVP_MD * md, size_t keylen, void * key)

literally exactly what PKCS5 says on the tin: take a password, a salt and an iteration counter, and turn them into a crypto key. the digest function is yours to pick here, which is the main character energy move of this one. ✨

Parameters

• password — the password. 🍓
• password_len — how long that password is.
• salt — the salt. (yes, just salt. iconic.)
• salt_len — how long the salt is.
• iter — the iteration counter.
• md — the digest function.
• keylen — the output key length.
• key — the output key itself. the glow-up destination 💖

Returns

1 on success, anything that isn't 1 on failure. simple as that, fr fr.

---

int PKCS5_PBKDF2_HMAC_SHA1 (const void * password, size_t password_len, const void * salt, size_t salt_len, unsigned long iter, size_t keylen, void * key)

same energy, same deal: per PKCS5, it converts a password, a salt and an iteration counter into a crypto key. the difference? this one already knows the digest — it's the SHA1 flavor, so there's no md to pass in. lowkey convenient 🎀

Parameters

• password — the password. 🦋
• password_len — length of the password.
• salt — salt.
• salt_len — length of the salt.
• iter — iteration counter.
• keylen — the output key length.
• key — the output key. 🫶

Returns

1 on success, non-1 on failure. periodt.

---

🧚 Author 🧚

this one was generated automatically by Doxygen for the Heimdal crypto library, straight from the source code. not me having a ghostwriter 😭

---

Version 7.8.0, dated Tue Nov 15 2022 — that's the whole footer, bestie, and this page is officially wrapped 💜 bye!!