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

✨ gnutls_tpm_key_list_get_url ✨

okay so bestie, welcome to the gnutls manual page for gnutls_tpm_key_list_get_url — yes the name is a mouthful, yes it's iconic, no we're not changing it 💅 this is page three of the gnutls manual, section 3, and it's literally all about pulling a URL out of a TPM key list. stay with me, it's giving very niche but very useful 🦋

🌸 SYNOPSIS 🌸

#include <gnutls/tpm.h>

int gnutls_tpm_key_list_get_url(gnutls_tpm_key_list_t list, unsigned int
idx, char ** url, unsigned int flags);

like, that's the whole vibe. one function, four args, zero drama 🎀

🫶 ARGUMENTS 🫶

  • gnutls_tpm_key_list_t list — a list of the keys. yes, THE list. the one with the keys in it 💖
  • unsigned int idx — the index of the key you want. and bestie, it starts from zero. 0 is the first one, not 1. classic zero-indexed behaviour, no cap.
  • char ** url — the URL to be returned. this is where the function drops the goods 📬
  • unsigned int flags — should be zero. that's it. that's the whole requirement. zero, bestie 🙈

👑 DESCRIPTION 👑

so here's the tea: this function will return, for each given index, a URL of the corresponding key. one index in, one URL out. simple, clean, slay ✨

and if you hand it an index that's out of bounds? not it. it returns GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE instead. so like, vibe check your index before you call, fr fr 💀

🌈 RETURNS 🌈

on success, GNUTLS_E_SUCCESS (which is 0, queen of numbers) is returned 💚 otherwise you get a negative error value — so if the number is negative, something went sideways and you should probably go look at it 😭

⭐ SINCE ⭐

3.1.0 — she's been here since 3.1.0 and she's not going anywhere 🫶

🐛 REPORTING BUGS 🐛

found a bug? don't just scream into the group chat, actually 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. so like, share it, remix it, whatever — just keep the receipts, bestie 🧚

🔥 SEE ALSO 🔥

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

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

iykyk 📚

lowkey reminder: flags should be zero. i'm not saying it twice. okay i literally just said it twice. anyway 🎀

and that's the page!! this was gnutls version 3.8.13, manual page gnutls_tpm_key_list_get_url in section 3 — thanks for reading the whole thing, you ate that 💅✨💖

📦 where this page comes from