GNUTLS_TDB_SET_STORE_COMMITMENT_FUNC(3)

πŸ’– gnutls_tdb_set_store_commitment_func β€” bestie edition πŸ’–

okay so this is a page from the gnutls manual, and it's about one very specific little function. sit down, hydrate, let's get into it 🫢


✨ NAME ✨

gnutls_tdb_set_store_commitment_func β€” literally just an API function, that's the whole name, no notes πŸ’…


✨ SYNOPSIS ✨

#include <gnutls/gnutls.h>

void gnutls_tdb_set_store_commitment_func(gnutls_tdb_t tdb,
gnutls_tdb_store_commitment_func cstore);

yes bestie, she returns void. she does her thing and she leaves. iconic behaviour honestly πŸ‘‘


✨ ARGUMENTS ✨

  • gnutls_tdb_t tdb β€” the trust storage. that's the thing we're attaching stuff to, she's the main character here 🌟
  • gnutls_tdb_store_commitment_func cstore β€” the commitment storage function. the little callback we're introducing to tdb, like a plus-one at the function party πŸŽ€

✨ DESCRIPTION ✨

so what this function does is associate a commitment (hash) storage function with the trust storage structure. matching besties, but for storage. no cap. πŸ”₯

and the function you're passing in? it's shaped like this, exactly:

int gnutls_tdb_store_commitment_func(const char* db_name, const char*
host, const char* service, time_t expiration, gnutls_digest_algorithm_t,
const gnutls_datum_t* hash);

and the tea on db_name: it should be used to pass any private data to this function. so if you were wondering where your secret little extras go β€” that's the slot, bestie πŸ™ˆβœ¨


✨ REPORTING BUGS ✨

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


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: you can share this, just keep the receipts, 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, visit:

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

and that's the whole vibe check, bestie πŸ¦‹ go forth and store those commitments. this was page gnutls 3.8.13, from the gnutls manual set, and yes it's giving classic manpage energy. mwah πŸ’‹πŸ’–

πŸ“¦ where this page comes from