gnutls_psk_set...tials_function2(3)

💖 gnutls_psk_set_server_credentials_function2 — like, the PSK server callback setter, but make it non-string ✨

okay bestie, welcome to the gnutls manual page for gnutls_psk_set_server_credentials_function2, which is an API function 🫶. this is the one where you tell your server how to look up PSK creds for a user — and unlike its sibling, it does not force usernames to be strings. iykyk. 💅

---

✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

void
gnutls_psk_set_server_credentials_function2(gnutls_psk_server_credentials_t
cred, gnutls_psk_server_credentials_function2 func);

like, that's the whole vibe. one include, one function, two args. slay. 🎀

---

🌸 ARGUMENTS 🌸

• gnutls_psk_server_credentials_t cred — bestie this is literally a gnutls_psk_server_credentials_t type. that's it, that's the arg. 👑
• gnutls_psk_server_credentials_function2 func — and this one is the callback function. the star of the show. the main character. 🌟

---

💜 DESCRIPTION 💜

so here's the tea: you can use this function to set a callback that retrieves the user's PSK credentials. literally that's its whole job. 🍓

the callback's function form is:

int (*callback)(gnutls_session_t, const gnutls_datum_t* username, gnutls_datum_t* key);

now, this callback function has the same semantics as the one from gnutls_psk_set_server_credentials_function(), BUT — and this is the iconic part — it lets you use non-string usernames. no cap. 🙈

• username contains the actual username. yes, fr fr, the real one.
• the key must be filled in using gnutls_malloc(). do not freestyle this, bestie, use gnutls_malloc(). 😭

⚠️ warning time: if the callback returns a negative number, gnutls will just assume the username does not exist. like, ghosted. 💀

also, the callback function will only be called once per handshake — so don't be out here expecting it to spam-call you, it's a one-and-done situation. ✨

return values, bestie, get them right:

• return 0 on success 💖
• return -1 to indicate an error 😭

---

🔥 REPORTING BUGS 🔥

found a bug? don't suffer in silence, tell the people:

• report bugs to <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. periodt. 💅

---

🦋 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, go visit:

https://www.gnutls.org/manual/

---

and that's a wrap on the gnutls manual, version 3.8.13, dated 3.8.13 💖✨ go forth and set your PSK server credentials callbacks, bestie, you're gonna ate. 🎀🫶🌈