GNUTLS_X509_CRQ_SET_SUBJECT_ALT_NAME(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

💖 NAME 💖

gnutls_x509_crq_set_subject_alt_name — okay so this is an API function, bestie, and it lives in the gnutls manual (section 3, the library functions section, iykyk). It sets the subject alternative name extension on a certificate request. That's the whole vibe. ✨

🌸 SYNOPSIS 🌸

#include <gnutls/x509.h>

int gnutls_x509_crq_set_subject_alt_name(gnutls_x509_crq_t crq,
gnutls_x509_subject_alt_name_t nt, const void * data, unsigned int
data_size, unsigned int flags);

Like… look at that signature. Five whole arguments. She's doing a lot but she's slaying it. 💅

🎀 ARGUMENTS 🎀

  • gnutls_x509_crq_t crq — a certificate request of type gnutls_x509_crq_t. That's the thing you're decorating, bestie. The main character, honestly. 👑
  • gnutls_x509_subject_alt_name_t nt — this one is one of the gnutls_x509_subject_alt_name_t enumerations. Pick your fighter. 🌈
  • const void * data — the data to be set. Just raw data, no notes, no explanation, she's mysterious like that. 💜
  • unsigned int data_size — the size of the data to be set. Gotta tell her how big it is or she's lost fr. 😭
  • unsigned int flags — your two options are GNUTLS_FSAN_SET, which clears previous data, or GNUTLS_FSAN_APPEND, which appends. So like, fresh start or pile it on. Choose wisely. ✨

🦋 DESCRIPTION 🦋

Okay so the way that this function sets the subject alternative name certificate extension. That's her job. That's what she does.

It can set the following types:

…and that's literally where the list ends in this manpage, bestie. Just a colon and vibes. We move. 🫶

⭐ RETURNS ⭐

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. So if you get a 0, she ate and left no crumbs. If you get a negative number, something is not giving and you should probably go read the error. 💀

🌟 SINCE 🌟

2.8.0 — she's been around since 2.8.0, so she's lowkey a legend at this point. Respect the elders. 👑

🙈 REPORTING BUGS 🙈

Found something cursed? Report bugs to <bugs@gnutls.org>. 📧

Home page: https://www.gnutls.org — go say hi. 🏠

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, share it, remix it, no cap, 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/

Okay that's the whole page, bestie!! Every flag, every argument, every return value, preserved in full and looking cute. This was page gnutls_x509_crq_set_subject_alt_name(3) from the gnutls manual, version 3.8.13. Now go forth and set those subject alternative names, main character. 💅✨🦋

📦 where this page comes from