gnutls_priority_kx_list(3)

✨ gnutls_priority_kx_list ✨

okay bestie, so this one is from the gnutls manual β€” it's an API function, and it's lowkey one of the cutest little getters in the whole library. it just... tells you things. no drama. no side quests. we love a low-maintenance king πŸ’…


🌸 NAME 🌸

gnutls_priority_kx_list β€” API function

like, that's it. that's the whole name. iconic behaviour honestly.


πŸŽ€ SYNOPSIS πŸŽ€

#include <gnutls/gnutls.h>

int gnutls_priority_kx_list(gnutls_priority_t pcache, const unsigned int ** list);

yes she's a two-argument girlie and yes she returns an int. we move πŸ’–


πŸ¦‹ ARGUMENTS πŸ¦‹

  • gnutls_priority_t pcache β€” this is a gnutls_priority_t type. that's the vibe. that's what it is. you hand her a priority structure and she's like "say less" ✨
  • const unsigned int ** list β€” this one's a pointer-to-pointer situation (yes, double pointer, she's that girl 🫢) and it will point to an integer list. you're basically giving her a place to drop the list, and she fills it in. it's giving "here's my empty tote bag, please put stuff in it" πŸŽ€

πŸ’– DESCRIPTION πŸ’–

Get a list of available key exchange methods in the priority structure.

fr fr that's the whole thing. she looks at the priority structure you gave her and she's like "okay so here are all the key exchange methods chillin' in there" and hands you back a list. no cap, that's it. she's a getter, she gets. 🌸

key exchange methods are literally the whole "how do we agree on a secret without the whole internet reading it" moment, so yeah, knowing which ones are available in a given priority structure is a real thing you might wanna know. she's got you 🧚


πŸ‘‘ RETURNS πŸ‘‘

the number of items, or an error code.

so: happy path = a count, and you can be like "slay, that many items." sad path = an error code and you should go read it and deal with it, bestie. don't ignore the error code. not me catching you ignoring error codes 😭


⭐ SINCE ⭐

3.2.3

she's been here since 3.2.3. an elder. a legend. respect her. 🌈


πŸ™ˆ REPORTING BUGS πŸ™ˆ

found a bug? first of all, relatable, everything is a bug if you look hard enough. report it to:

  • <bugs@gnutls.org>

and the home page is right here:

don't be shy about it either, they actually wanna know πŸ’œ


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: take it, share it, remix it, just keep the receipts β€” keep the copyright notice and this notice. that's the deal. easy. 🫢)


πŸ”₯ 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/

like, go read the big one. she's thorough. she ate. πŸ‘‘


ngl bestie, if you got this far, you're genuinely doing amazing. drink some water. call your mom. read the Texinfo manual. balance ✨

and that's the page!! cute lil sign-off time: this is from gnutls 3.8.13, page gnutls_priority_kx_list(3) πŸ’– go forth and enumerate those key exchange methods, bestie, you've got this πŸŒΈπŸ¦‹βœ¨

πŸ“¦ where this page comes from