gnutls_dtls_cookie_verify(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

okay bestie, welcome to the gnutls manual, page for gnutls_dtls_cookie_verify — yes it's an API function, yes it's from the gnutls manual, and yes we're gonna get through it together 🫶

✨ NAME ✨

gnutls_dtls_cookie_verify — the API function that does a lil vibe check on a DTLS cookie 🔥

🌸 SYNOPSIS 🌸

#include <gnutls/dtls.h>

int gnutls_dtls_cookie_verify(gnutls_datum_t * key, void * client_data,
size_t client_data_size, void * _msg, size_t msg_size,
gnutls_dtls_prestate_st * prestate);

🎀 ARGUMENTS 🎀

  • gnutls_datum_t * key — bestie, this is a random key, and it's the one you use when you generate the cookie 🍪
  • void * client_data — this holds the data that identifies the client (so like, their address, iykyk)
  • size_t client_data_size — the size of the client's data, literally just how big it is
  • void * _msg — an incoming message that initiates a connection 👀
  • size_t msg_size — the size of the message. that's it, that's the whole job
  • gnutls_dtls_prestate_st * prestate — the cookie of this client 🍪💅

💜 DESCRIPTION 💜

so what does this icon actually DO? it will verify the received message for a valid cookie ✨ and if a valid cookie comes back, then it should be associated with the session using gnutls_dtls_prestate_set(); — no cap, that's the move.

🚨 also, important, don't skip this: this function must be called after gnutls_dtls_cookie_send().

🌈 RETURNS 🌈

GNUTLS_E_SUCCESS (which is 0, slay) on success, or a negative error code 😭 if it's not it.

⭐ SINCE ⭐

3.0 — she's been iconic since 3.0, periodt 👑

🦋 REPORTING BUGS 🦋

found a bug? don't be shy, report it to <bugs@gnutls.org> 💌

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

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. 🫶

💅 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 whole page babes 🌸 this was gnutls_dtls_cookie_verify(3) from the gnutls manual, version 3.8.13, and the footer said gnutls_dtls_cookie_verify(3) — so go forth, verify those cookies, and stay iconic 💖✨🎀

📦 where this page comes from