gsasl_random(3)

📦
version 2.2.4 · 6 versions
, in arch rolling, ubuntu stonking

💖 gsasl_random — the gsasl manual, bestie edition 💖

okay so bestie, we're in the gsasl corner of the manual pages rn and this one is literally called gsasl_random. iconic name, extremely on-the-nose, we love that for her. 💅

✨ NAME ✨

gsasl_random — an API function 🫶

✨ SYNOPSIS ✨

#include <gsasl.h>

int gsasl_random(char * data, size_t datalen);

like, that's the whole vibe. one include, one call. slay. ✨

✨ ARGUMENTS ✨

  • char * data — the output array, aka the little container you're handing over to get filled up with strong random data. she's the main character here, show her some respect. 👑
  • size_t datalen — the size of that output array. how much room you're giving her. no cap, this matters. 📏

✨ DESCRIPTION ✨

okay so here's the tea: gsasl_random stores cryptographically strong random data of the given size into the buffer you provided. that's it. that's the function. she fills your buffer with good, quality randomness — not the fake weak kind, the cryptographically strong kind, which is the whole point bestie. 🔥

Return value: returns GSASL_OK iff successful. that's it, that's the check. if you get GSASL_OK you're golden, if you don't… well, it's not successful, and you should probably pay attention to that. 😭

ngl the "iff" is doing real work in that sentence — successful means GSASL_OK, and GSASL_OK means successful. iffy in the mathematical sense, not the "maybe" sense. iykyk. 💜

✨ REPORTING BUGS ✨

found a bug?? not the vibe, but okay, let's handle it like adults. 🐛

Copyright © 2002-2026 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, free to copy, free to share, just keep the notice, periodt. 🎀

✨ 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, this command:

info gsasl

should give you access to the complete manual. go read it, bestie, it's giving ✨knowledge✨. 📚

as an alternative you may obtain the manual from:

https://www.gnu.org/software/libidn/gsasl/manual/

and that's a wrap on this page, angel. 🦋 this was gsasl version 2.2.4, from the gsasl_random(3) manual page — take care of your randomness and she'll take care of you. mwah. 💜🌸🧚

📦 where this page comes from