gnutls_pcert_import_x509_raw(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_pcert_import_x509_raw(3) ✨

okay bestie, so this one lives in the gnutls manual and it's literally called gnutls_pcert_import_x509_raw — like, the name says it all, we're importing a raw x509 cert into a pcert. sit down, hydrate, let's go 🫶

🌸 NAME 🌸

gnutls_pcert_import_x509_raw — it's an API function, bestie. that's the whole name. short, sweet, iconic 👑

🎀 SYNOPSIS 🎀

#include <gnutls/abstract.h>

int gnutls_pcert_import_x509_raw(gnutls_pcert_st * pcert, const
gnutls_datum_t * cert, gnutls_x509_crt_fmt_t format, unsigned int
flags);

there she is. four args, one int return, zero drama 💅

🦋 ARGUMENTS 🦋

  • gnutls_pcert_st * pcert — the pcert structure, aka the lil container where your cert is gonna live. this is the destination, the main character of the operation ✨
  • const gnutls_datum_t * cert — the raw certificate that's getting imported. raw, unfiltered, no cap 🍓
  • gnutls_x509_crt_fmt_t format — the format of the certificate. gotta tell it what kind of cert you're handing over, it can't just guess 😭
  • unsigned int flags — zero for now. that's it. zero. for now. (iykyk, future-proofing behavior 💀)

💖 DESCRIPTION 💖

so this is a convenience function — meaning it's here to make your life easier, you're welcome — and what it does is import the given certificate straight into a gnutls_pcert_st structure.

⚠️ okay important part, do NOT skip this: the structure must be deinitialized afterwards using gnutls_pcert_deinit(); — like, you have to clean up after yourself, bestie. no leaving your cert structure just sitting there with no deinit. that's not the vibe 🙈

🌈 RETURNS 🌈

on success, GNUTLS_E_SUCCESS (0) comes back at you like a little reward sticker ⭐ — otherwise you get a negative error value, which is the code's way of saying "girl, something went wrong" 💀

🧚 SINCE 🧚

3.0 — she's been around, she's a legacy icon, respect her 👑

🎀 REPORTING BUGS 🎀

found a bug? don't suffer in silence, tell the 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. slay, honestly — free to share, 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, go visit:

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

and that's the whole page, bestie 💖 this was gnutls 3.8.13 dropping gnutls_pcert_import_x509_raw(3) into your terminal — go forth, import those certs, and don't forget the gnutls_pcert_deinit(); or I will know 😤✨

📦 where this page comes from