gsasl_hmac_md5(3)

📦 version 1.10.0, in ubuntu jammy

💖 gsasl_hmac_md5 — the glow-up page 💖

okay bestie, we're in the gsasl manual, and today's main character is gsasl_hmac_md5. it's an API function. that's the whole NAME situation, no notes. 🎀

✨ SYNOPSIS ✨

#include <gsasl.h>

int gsasl_hmac_md5(const char * key, size_t keylen, const char * in,
size_t inlen, char * [] outhash);

that's the whole thing, she's serving signature realness. 💅

🫶 ARGUMENTS 🫶

  • const char * key — the input character array holding the key you wanna use. like, your little secret. 🗝️
  • size_t keylen — the length of that input character array with the key to use. gotta tell her how long the secret is, she's not a mind reader. 💀
  • const char * in — the input character array of data you want hashed. the stuff getting the glow-up. ✨
  • size_t inlen — the length of that input character array of data to hash. yes, lengths matter, we're not out here guessing. 🌸
  • char * [] outhash — a newly allocated 16-byte character array containing the keyed hash of your data. sixteen bytes. iconic. she's brand new and she's yours. 👑

🌈 DESCRIPTION 🌈

so what does she do. she computes the keyed checksum of data using HMAC-MD5. that's it, that's the job, and she does it well. 💜

important bestie: the outhash buffer must be deallocated by the caller. that means you, boo. she allocates it, you free it. it's giving shared custody. don't leave her hanging, that's a leak and leaks are not the vibe. 😭

Return value: returns GSASL_OK iff successful. that's the green flag, the "we ate", the everything-worked-out moment. 🫶

💀 DEPRECATED 💀

okay so this is the part where I hold your hand: use a crypto library. that's the whole note. she's deprecated, she's retired from the spotlight, she's living her soft life now. no cap, don't build new stuff on her. 🙈

🐛 REPORTING BUGS 🐛

found a bug? first of all, thank you for your service. report it to <bug-gsasl@gnu.org>. 🦋

general guidelines for reporting bugs live here: http://www.gnu.org/gethelp/

and the GNU SASL home page is right here: http://www.gnu.org/software/gsasl/

Copyright © 2002-2021 Simon Josefsson.

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. literally just keep the receipt, bestie, that's all she asks. 💖

🌸 SEE ALSO 🌸

the full documentation for gsasl is maintained as a Texinfo manual. if the info and gsasl programs are properly installed at your site, the command

info gsasl

should give you access to the complete manual. the whole thing. the full lore. 📚

as an alternative you may obtain the manual from:

http://www.gnu.org/software/gsasl/manual/

and that's the page, bestie!! 🎀✨

this was gsasl_hmac_md5(3) from the gsasl manual, version 1.10.0 — go free your outhash buffers and stay hydrated, mwah 💅💖

📦 where this page comes from