GNUTLS_X509_CRT_SET_ISSUER_ALT_OTHERNAME(3)

✨ gnutls_x509_crt_set_issuer_alt_othername ✨

okay bestie, welcome to the gnutls section 3 manual, this one's about gnutls_x509_crt_set_issuer_alt_othername 💖 it lives in the gnutls man pages and it's literally the glow-up your certificate's issuer alt name needed. no cap.

---

🎀 NAME 🎀

gnutls_x509_crt_set_issuer_alt_othername — API function 💅

(it's giving "very specific little helper" and honestly? obsessed.)

---

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crt_set_issuer_alt_othername(gnutls_x509_crt_t crt,
const char * oid, const void * data, unsigned int data_size, unsigned
int flags);

yes queen, that's the whole signature, keep it exactly like that 🫶

---

🦋 ARGUMENTS 🦋

• gnutls_x509_crt_t crt — a certificate of type gnutls_x509_crt_t. this is the main character, the cert we're decorating ✨
• const char * oid — The other name OID. it's the ID that says which othername situation we're doing 🌈
• const void * data — The data to be set. this is the actual payload, bestie 📦
• unsigned int data_size — The size of data to be set. gotta tell it how big the payload is or it's just guessing, and we don't guess 🔥
• unsigned int flags — GNUTLS_FSAN_SET to clear previous data or GNUTLS_FSAN_APPEND to append. pick your fighter 💅

---

💜 DESCRIPTION 💜

so what does this do? This function will set an "othername" to the issuer alternative name certificate extension. that's it, that's the job. iconic behaviour, truly.

here's the tea though: The values set are set as binary values and are expected to have the proper DER encoding. so like, it's not gonna hold your hand and turn your cute little string into DER, you gotta bring DER yourself 🧚

BUT — for convenience the flags GNUTLS_FSAN_ENCODE_OCTET_STRING and GNUTLS_FSAN_ENCODE_UTF8_STRING can be used to encode the provided data. so if you're feeling lazy (valid), those two will do the encoding for you. slay 💅✨

---

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

so like, zero means we ate. anything negative means something went sideways 😭 check it, always.

---

🌈 SINCE 🌈

3.5.0 — she's been here a minute, respect the elders 👑

---

🙈 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. (basically: keep the receipts, be respectful, and you're free to share 🫶)

---

🔥 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/

---

ngl that's the whole page, no skipped sections, no missing flags, all facts intact 💀

okay bye bestie, go set those othernames, this was the gnutls manual, version 3.8.13 — gnutls_x509_crt_set_issuer_alt_othername(3), periodt 💖✨🎀🦋🌸💅