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

✨ NAME ✨

gnutls_psk_set_server_credentials_file — it's an API function, bestie 💅 (from the gnutls manual, in case you were wondering)

🦋 SYNOPSIS 🦋

#include <gnutls/gnutls.h>

int
gnutls_psk_set_server_credentials_file(gnutls_psk_server_credentials_t
res, const char * password_file);

🎀 ARGUMENTS 🎀

  • gnutls_psk_server_credentials_t res — okay so this one is a gnutls_psk_server_credentials_t</p> type. that's the whole vibe of it. 💖
  • const char * password_file — this is the PSK password file, and yes the classic name for it is passwd.psk. she's the one holding the receipts. 🍓

🌸 DESCRIPTION 🌸

So this function sets the password file, inside a gnutls_psk_server_credentials_t type. no cap. 🫶

That password file is where the usernames and keys live, and it's literally what gets used for PSK authentication. it's giving "the whole guest list, right here". 👑

Each entry in the file goes like this: a username, followed by a colon (':'), and then a hex-encoded key. iconic format, honestly.

And if the username contains a colon, or literally any other special character, it can be hex-encoded preceded by a

💀 not me getting to the end of that sentence and it just... stops. that's genuinely how the page reads, bestie — I'm not about to invent an ending for it, that would be a whole lie. so: "preceded by a" and that's the sentence. the mystery continues. 🙈

⭐ RETURNS ⭐

When it works, you get GNUTLS_E_SUCCESS (0) back. slay. ✨

When it doesn't, you get an error code. periodt. 💅

🐛 REPORTING BUGS 🐛

Found a bug? 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. (yes, you can share it — just keep the receipt. 💜)

🌈 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, you ate it, go forth and authenticate 🧚

this was gnutls_psk_set_...redentials_file(3) from the gnutls manual, version 3.8.13 — mwah, take care bestie 💖✨

📦 where this page comes from