gnutls_pkcs11_token_get_url(3)

💖 gnutls_pkcs11_token_get_url 💖

okay bestie, so this is a page from the gnutls manual — the whole gnutls manpage collection, the PKCS#11 corner of it anyway — and we're gonna talk about one tiny little function that goes and fetches URLs for the tokens hanging out on your system. no cap, it's short. let's go 🦋

---

🌸 NAME 🌸

gnutls_pkcs11_token_get_url — literally just an API function, that's the whole job description 💅

---

✨ SYNOPSIS ✨

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_token_get_url(unsigned int seq,
gnutls_pkcs11_url_type_t detailed, char ** url);

---

🎀 ARGUMENTS 🎀

• unsigned int seq — the sequence number, and it starts counting from 0 like a good little zero-indexed girlie ✨
• gnutls_pkcs11_url_type_t detailed — if this is non zero, you're asking for a detailed URL, periodt
• char ** url — this bad boy will contain an allocated url when the function is done with it 👑

---

💜 DESCRIPTION 💜

so this function will return the URL for each token available in system. that's it, that's the vibe 🌈

and listen — the url has to be released using gnutls_free(). don't forget. don't ghost your memory allocations, bestie, that's not the energy we're bringing into this repo 😭

---

🔥 RETURNS 🔥

• On success, GNUTLS_E_SUCCESS (0) is returned 💖
• GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the sequence number exceeds the available tokens 🙈
• otherwise, a negative error value 💀

---

⭐ SINCE ⭐

2.12.0 — oldie but a goodie, she's been iconic since day one 👑

---

🫶 REPORTING BUGS 🫶

found a bug? don't be shy, report bugs to <bugs@gnutls.org>.

Home page: https://www.gnutls.org 🌐

---

📜 COPYRIGHT 📜

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, fr fr, you can copy it, just keep the receipts 🧾✨)

---

🌈 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/ 💫

---

that's the whole page babes 🎀 this was gnutls 3.8.13, the gnutls_pkcs11_token_get_url(3) entry, and it's giving "short, sweet, and fully documented." slay 💅✨🦋