gnutls_x509_crt_import_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_x509_crt_import_url — the API function ✨

okay bestie, sit down, hydrate, and let me tell you about this lil function from the gnutls manual. no cap, it's a good one. 🎀

🌸 NAME 🌸

gnutls_x509_crt_import_url — it's an API function, bestie. that's the whole name, that's the whole vibe. 💅

🦋 SYNOPSIS 🦋

like, here's how you actually call it. copy it exactly, don't freestyle:

#include <gnutls/x509.h>

int gnutls_x509_crt_import_url(gnutls_x509_crt_t crt, const char * url,
unsigned int flags);

💖 ARGUMENTS 💖

three of them. count 'em. we love a tidy signature.

  • gnutls_x509_crt_t crt — a certificate of type gnutls_x509_crt_t. that's your little certificate girlie, she's the one getting the glow-up here.
  • const char * url — a PKCS 11 url. yes, a url. the certificate lives somewhere and this is the address, iykyk.
  • unsigned int flags — one of the GNUTLS_PKCS11_OBJ_* flags, but only if you're doing PKCS11 URLs. otherwise? just pass zero and move on with your life. ✨

💜 DESCRIPTION 💜

so the way this works is: this function will import a certificate that's hanging out in a PKCS11 token, or honestly in any type of back-end that supports URLs. it's flexible like that. main character energy, truly. 👑

and here's a lil lore drop for the history girlies: in previous versions of gnutls, this function was named gnutls_x509_crt_import_pkcs11_url. the old name is still out there, and it's just an alias to this one. so if you see the old name in the wild, don't panic — it's the same girl, different era. 🦋

⭐ RETURNS ⭐

  • on success: GNUTLS_E_SUCCESS (which is 0) is returned. we love a zero. 🥳
  • otherwise: a negative error value. not a vibe, but at least it's honest.

🎀 SINCE 🎀

3.4.0 — she's been here a minute, she's not new. respect the elders. 💖

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, tell the gnutls girlies directly:

fr fr, reporting bugs is a public service. you're doing the community a solid. 🫶

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.

that means: keep the notice, keep the notice, and you're free to pass it around. slay. 💅

🌈 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 it. it's giving educational. 📚✨

and that's the page, bestie!! 🌸 this was gnutls 3.8.13, and the manual page is gnutls_x509_crt_import_url(3) — so if you ever need to cite it, that's your girl. go import a certificate, you're doing amazing, periodt. 💖🦋🎀🔥

📦 where this page comes from