gnutls_pbkdf2(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ gnutls_pbkdf2 — the "turn ur password into a whole key" icon ✨

okay bestie, welcome to the gnutls manual 💖 this one's from the gnutls section of the manual pages, and it's literally just one function that does one extremely cool thing. buckle up 🎀

🌸 NAME 🌸

gnutls_pbkdf2 — API function. that's it. that's the name. iconic, honestly 👑

💅 SYNOPSIS 💅

#include <gnutls/crypto.h>

int gnutls_pbkdf2(gnutls_mac_algorithm_t mac, const gnutls_datum_t *
key, const gnutls_datum_t * salt, unsigned iter_count, void * output,
size_t length);

so you include <gnutls/crypto.h> and then you call it. easy. slay 🫶

🦋 ARGUMENTS 🦋

like, here's what you're feeding it, one by one:

  • gnutls_mac_algorithm_t mac — the mac algorithm that gets used internally 🧚 this is the engine room, the vibe-setter, the one doing the actual cryptographic lifting behind the scenes.
  • const gnutls_datum_t * key — the initial keying material. this is ur starting stuff, the raw ingredient, the main character of the whole operation 💜
  • const gnutls_datum_t * salt — the salt 🌸 yes, like actual seasoning. sprinkle it in so the output isn't predictable. it matters. no cap.
  • unsigned iter_count — the iteration count. how many times it goes around the loop. lowkey this is the "how hard should I make it for the attacker" dial 🔥
  • void * output — the output value. this is where the derived key lands when it's done, so like… make sure it's a real buffer, bestie 🙈
  • size_t length — the desired length of the output key ⭐ you literally get to pick how long you want it. dream come true energy.

🌈 DESCRIPTION 🌈

okay so the whole moment here: this function will derive a variable length keying material from a password according to PKCS 5 PBKDF2 ✨

that's the entire description. variable length keying material, from a password, per PKCS 5 PBKDF2. and the way that it does exactly what it says and nothing more?? perfection 💖

👑 RETURNS 👑

Zero or a negative error code on error.

so like: 0 means yay 🎉, anything negative means something went sideways and you should probably go look at it. periodt.

🎀 SINCE 🎀

3.6.13 — so it's been around a minute, it's not some brand new baby function, it's established. it ate. 💅

💀 REPORTING BUGS 💀

found something cursed? not me being the one to tell you, but like, do report it:

Copyright © 2001-2023 Free Software Foundation, Inc., and others.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

(translation: it's free, go wild, just don't delete the receipts 🧾✨)

🔥 SEE ALSO 🔥

the full documentation for gnutls is maintained as a Texinfo manual 📚 if the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit:

https://www.gnutls.org/manual/

iykyk — that's the place for the deep lore.

k byeeee 💜 this was gnutls_pbkdf2(3) from the gnutls manual, version 3.8.13 — go derive some keys bestie, you've got this 🌸🦋🎀

📦 where this page comes from