gnutls_random_art(3)

✨ gnutls_random_art(3) ✨

okay bestie, so this one lives in the gnutls manual, and it's genuinely one of the cutest things in the whole library ngl 💖

---

🌸 NAME 🌸

gnutls_random_art — API function

like... it makes art. from a fingerprint. no cap 🎨

---

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

int gnutls_random_art(gnutls_random_art_t type, const char * key_type,
unsigned int key_size, void * fpr, size_t fpr_size, gnutls_datum_t *
art);

---

💅 ARGUMENTS 💅

• gnutls_random_art_t type — the vibe of the random art you want. rn the only one that's supported is GNUTLS_RANDOM_ART_OPENSSH, so that's the one, periodt ✨
• const char * key_type — what kind of key we're working with (RSA, DSA, etc.) 🔑
• unsigned int key_size — how big the key is, measured in bits
• void * fpr — the fingerprint of the key itself
• size_t fpr_size — how big that fingerprint is
• gnutls_datum_t * art — the random art that comes back out 🎀

---

🌈 DESCRIPTION 🌈

so the whole ~thing~ here: this function takes a fingerprint you hand it and converts it into an "artistic" image. iconic behaviour honestly 🫶

and important detail bestie: the returned image is allocated using gnutls_malloc(), and it is null-terminated — but art->size will not count that terminating null. so don't let that trip you up, iykyk 💀

---

⭐ RETURNS ⭐

if everything goes off without a hitch you get GNUTLS_E_SUCCESS (which is 0), and if not, you get an error code back. slay either way 💖

---

🐛 REPORTING BUGS 🐛

found a bug? tell the girlies at <bugs@gnutls.org> 💌

home page: https://www.gnutls.org

---

👑 COPYRIGHT 👑

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. so like, go off, just keep 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/

---

okay that's the whole page bestie, every last flag and fact, no notes 💅

and that's a wrap on the gnutls manual, version 3.8.13 — mwah, go make some random art, you absolute icon 🎀✨💜