gnutls_dh_get_pubkey(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_dh_get_pubkey — like, the manual page, bestie ✨

okay so we're in the gnutls manual (yes that gnutls, the 3.8.13 era one) and today's main character is gnutls_dh_get_pubkey, an API function. buckle up, it's giving cryptography but make it cute 🎀

🌸 NAME 🌸

gnutls_dh_get_pubkey — API function. that's the whole name section, she's concise 💅

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

int gnutls_dh_get_pubkey(gnutls_session_t session, gnutls_datum_t *
raw_key);

like, that's the whole vibe. include the header, call the function, live your truth 🦋

🎀 ARGUMENTS 🎀

  • gnutls_session_t session — bestie. it's a gnutls session. that's it, that's the arg 💖
  • gnutls_datum_t * raw_key — this one's gonna hold the public key. she's an output girlie, she doesn't come with anything, she leaves with everything ✨

💅 DESCRIPTION 💅

okay so listen. this function returns the peer's public key that got used in the last Diffie-Hellman key exchange. the last one. the most recent one. the one that just happened. iykyk 🔥

and the way it works for both anonymous and ephemeral Diffie-Hellman?? versatile queen. she does not discriminate. anonymous DH, ephemeral DH, she said "i got you either way" 👑

⚠️ okay important: the output parameters must be freed with gnutls_free(). not free(). not vibes. gnutls_free(). do not skip this, bestie, your memory will simply not slay 😭

and one more lil thing — no cap — the public key is exported as a non-negative integer, and it may include a leading zero byte. so if you see a sneaky little zero at the front, that's not a bug, that's just her being herself 🫶

⭐ RETURNS ⭐

  • on success, GNUTLS_E_SUCCESS (which is 0) is returned 🌈
  • otherwise? an error code. she'll tell you what went wrong, you just gotta look 💀

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, tell the gnutls girlies:

fr fr they wanna know 💜

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: copy it, share it, remix it, 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/

and that's the page!! this was gnutls 3.8.13, gnutls_dh_get_pubkey(3), served fresh with love — no date on the footer so i'm not gonna invent one, that would be a lie and lying is not iconic 💖✨ bye bestie, go free your gnutls_datum_t 🎀

📦 where this page comes from