gnutls_x509_aki_set_cert_issuer(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_aki_set_cert_issuer 💖

okay bestie, welcome to the gnutls girlies' corner 🌸 this one lives in section 3 of the manual (that's the library-functions girlies, iykyk), and it's literally just one tiny little function that goes SO hard. it's giving "I only do one thing but I do it flawlessly." periodt. 💅

✨ NAME ✨

gnutls_x509_aki_set_cert_issuer — no fr, it's an API function, that's the whole vibe 🎀

🦋 SYNOPSIS 🦋

#include <gnutls/x509-ext.h>

int gnutls_x509_aki_set_cert_issuer(gnutls_x509_aki_t aki, unsigned int
san_type, const gnutls_datum_t * san, const char * othername_oid, const
gnutls_datum_t * serial);

like. five whole arguments. she's a lot but she's worth it 💜

🌈 ARGUMENTS 🌈

  • gnutls_x509_aki_t aki — the authority key ID. that's the thing we're decorating, bestie, she's our main character 👑
  • unsigned int san_type — the type of the name (of gnutls_subject_alt_names_t), and lowkey it may be null 🙈
  • const gnutls_datum_t * san — the alternative name data. the actual goods. the moment. ✨
  • const char * othername_oid — the object identifier, but ONLY if san_type is GNUTLS_SAN_OTHERNAME. otherwise it's not her turn 💀
  • const gnutls_datum_t * serial — the authorityCertSerialNumber number (and yes, she may be null too) 🌸

💅 DESCRIPTION 💅

okay so here's the tea ☕ this function will set the authorityCertIssuer name AND the authorityCertSerialNumber so they get stored up in the aki type. that's the whole job. she ate. 🔥

now the important bit — when you're storing multiple names, the serial should be set on the first call, and then every subsequent call should use a NULL serial. like, the serial is a one-time thing, she said it once and that's enough, no need to repeat yourself bestie 😭

and since version 3.5.7, GNUTLS_SAN_RFC822NAME, GNUTLS_SAN_DNSNAME, and GNUTLS_SAN_OTHERNAME_XMPP get converted to ACE format when necessary. the way she just handles that for you? iconic behaviour, no notes 🧚

⭐ RETURNS ⭐

on success you get GNUTLS_E_SUCCESS (which is literally 0, cute) 🎀 otherwise you get a negative error value and you're gonna have to have a little sit-down about it 😭

🍓 SINCE 🍓

3.3.0 — an elder, a legend, been here since before it was cool 💜

🙈 REPORTING BUGS 🙈

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

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, and legally so 💅

🌸 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!! 🫶 go forth and set those cert issuers. this one's from gnutls 3.8.13, section 3, and yeah the footer is a whole mood but honestly so is she. mwah. 💖✨🎀

📦 where this page comes from