shishi_md5(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ shishi_md5(3) — the MD5 girlie of the shishi fam ✨

okay bestie, pull up a chair 🪑 because we're about to talk about shishi_md5, a lil function living in the shishi manual, section 3 (that's the library-calls girlies, iykyk 💅). she hashes things. that's her whole job. and she does it immaculately. let's get into it 🫶

🌸 NAME 🌸

shishi_md5 — it's an API function, bestie. that's the whole name. short, sweet, iconic 👑

🎀 SYNOPSIS 🎀

#include <shishi.h>

int shishi_md5(Shishi * handle, const char * in, size_t inlen, char *
out[16]);

like yes, that second line wraps weirdly in the original, and yes, we're keeping it exactly as it is because that's the whole point of a synopsis 💖

🦋 ARGUMENTS 🦋

  • Shishi * handle — the shishi handle, and no you can't just make one up out of vibes, it's allocated by shishi_init(). she needs her handle, periodt.
  • const char * in — the input character array. it's the data you want to hash. that's it. that's the tea 🍓
  • size_t inlen — the length of that input character array of data to hash. yes, you have to tell her how long it is. she's not a mind reader, bestie 😭
  • char * out[16] — a newly allocated character array holding the hash of the data. and heads up: the caller is on deallocation duty here, so don't be out here leaking, that's not the vibe 🙈

💜 DESCRIPTION 💜

so what does she actually do? she computes the hash of your data using MD5. that's the function. that's the assignment. she ate and left no crumbs 🔥

⚠️ and this is the important bit so listen up: the out buffer must be deallocated by the caller. like, by you. that's a you problem, not a her problem. don't forget it or you're gonna be leaking memory in the group chat and everyone's gonna see 💀

⭐ RETURN VALUE ⭐

she returns SHISHI_OK iff successful. and only iff. so like, if you get SHISHI_OK back, congratulations, you slayed 💅 if you didn't… well. check your inputs, bestie.

🌈 REPORTING BUGS 🌈

found a bug? first of all, relatable. second of all, report it to <bug-shishi@gnu.org>. they wanna hear about it, fr fr 🐛

don't be shy, they literally made a whole email address for it 🫶

Copyright © 2002-2022 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.

like… go off, that's genuinely so generous of him 🥹 no royalty, any medium, just keep the notice. we love a permissive king 💖

🧚 SEE ALSO 🧚

The full documentation for shishi is maintained as a Texinfo manual. so if info and the shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. go read it, she's thorough 🌸

okay that's the whole page!! 💜 sending you off with the details you actually need: this was from the shishi manual, version 1.0.3, and the page itself is shishi_md5(3). now go hash something responsibly, bestie — and deallocate that buffer 😭✨🫶

📦 where this page comes from