gnutls_x509_cr...t_alt_othername(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_crq_set_subject_alt_othername — API function 💖

okay bestie, so this page lives in the gnutls manual (that's the manual name, and yes it's giving cryptography main character energy 👑), and it's all about one very specific little function. let's get into it 🦋

✨ SYNOPSIS ✨

#include <gnutls/x509.h>

int gnutls_x509_crq_set_subject_alt_othername(gnutls_x509_crq_t crq,
const char * oid, const void * data, unsigned int data_size, unsigned
int flags);

like, five arguments, no notes. she's thorough 💅

🌸 ARGUMENTS 🌸

  • gnutls_x509_crq_t crq — a certificate request of type gnutls_x509_crq_t. yes the type is the same as the name, it's just like that, we don't question it 🙈
  • const char * oid — this is the othername OID. the little dotted identifier that says which othername we're talking about 🎀
  • const void * data — the data to be set. that's it, that's the data 💜
  • unsigned int data_size — the size of data to be set. gotta tell her how big it is, she's not psychic ✨
  • unsigned int flags — your vibe selector: GNUTLS_FSAN_SET to clear previous data, or GNUTLS_FSAN_APPEND to append. so like, fresh start or add-to-the-pile, pick one 🫶

🦋 DESCRIPTION 🦋

so this function will set the subject alternative name certificate extension. iconic behaviour, truly.

it can set the following types:

and then... nothing. the list is empty in the source text, bestie. the types are implied, the types are mysterious. iykyk 😭

the important part though, fr fr: the values set must be binary values and must be properly DER encoded. no cap. if you're handing her something that isn't binary and DER-encoded, that's not it, and she will not be slaying.

⭐ RETURNS ⭐

on success, GNUTLS_E_SUCCESS (that's 0) is returned 🎉

otherwise you get a negative error value. sad girl hours, but at least she tells you 💀

🌈 SINCE 🌈

3.5.0 — she's been around, she's got history, respect the elders 👑

💌 REPORTING BUGS 💌

found a bug? spill. report bugs to <bugs@gnutls.org>.

home page, for the girlies who like to browse: https://www.gnutls.org

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, go off, 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 your girl. she has everything 🌸

and that's the whole page, bestie 💅 this one's from gnutls version 3.8.13, dated alongside the gnutls_x509_cr...t_alt_othername(3) page — so go forth, set that othername, DER-encode responsibly, and stay slaying 🦋✨💖

📦 where this page comes from