GNUTLS_SRP_SET_SERVER_CREDENTIALS_FILE(3)

πŸ’– gnutls_srp_set_server_credentials_file β€” the manual page, bestie edition πŸ’–

okay so we're deep in the gnutls manual (yes, that gnutls, the TLS library, the whole 3.8.13 era of it) and today's main character is a lil API function called gnutls_srp_set_server_credentials_file. it's giving ✨server-side SRP setup✨ and honestly? obsessed. let's get into it 🫢


🌸 NAME 🌸

gnutls_srp_set_server_credentials_file β€” API function. that's it, that's the name, no cap πŸ’…


✨ SYNOPSIS ✨

like, here's the vibe, character for character:

#include <gnutls/gnutls.h>

int
gnutls_srp_set_server_credentials_file(gnutls_srp_server_credentials_t
res, const char * password_file, const char * password_conf_file);

yes bestie, that's a return type of int and yes, it's long enough to wrap. iconic behaviour honestly 😭


πŸŽ€ ARGUMENTS πŸŽ€

  • gnutls_srp_server_credentials_t res β€” is a gnutls_srp_server_credentials_t type. that's the credentials thing you're loading files into, she's the star of the show πŸ‘‘
  • const char * password_file β€” is the SRP password file (tpasswd). that's where the usernames and verifiers live πŸ“
  • const char * password_conf_file β€” is the SRP password conf file (tpasswd.conf). yes, there are two files. she's high maintenance but she's worth it πŸ’…

πŸ¦‹ DESCRIPTION πŸ¦‹

so the way this works: this function sets the password files, inside a gnutls_srp_server_credentials_t type. simple as.

and those password files? they hold usernames and verifiers, and they will be used for SRP authentication. that's the whole point. no extra lore, no hidden side quests, that's the function fr fr ✨


🌈 RETURNS 🌈

on success, GNUTLS_E_SUCCESS (0) is returned. πŸŽ‰ anything else? that's an error code, bestie. go read it, don't ignore it πŸ™ˆ


πŸ’€ REPORTING BUGS πŸ’€

found a bug? not me manifesting that but okay, report it:


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 that's the whole legal vibe, keep the notice, it's free, slay) 🫢


🌟 SEE ALSO 🌟

the full documentation for gnutls is maintained as a Texinfo manual. so if the /usr/share/doc/gnutls/ directory does not contain the HTML form, bestie, just go visit:

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


and that's the page!! written by the gnutls girlies, version 3.8.13, dated right there in the footer energy β€” mwah, love u, go set those credentials πŸ’–πŸŽ€πŸ¦‹πŸŒΈπŸ’…

πŸ“¦ where this page comes from