gnutls_x509_crt_set_subject_alt_name(3)

gnutls_x509_crt_set_subject_alt_name3

Api function

Usage

#include <gnutls/x509.h>

int gnutls_x509_crt_set_subject_alt_name(gnutls_x509_crt_t crt, gnutls_x509_subject_alt_name_t type, const void * data, unsigned int data_size, unsigned int flags);

Arguments

gnutls_x509_crt_t crt

a certificate of type gnutls_x509_crt_t

gnutls_x509_subject_alt_name_t type

is one of the gnutls_x509_subject_alt_name_t enumerations

const void * data

The data to be set

unsigned int data_size

The size of data to be set

unsigned int flags

GNUTLS_FSAN_SET to clear previous data or GNUTLS_FSAN_APPEND to append.

Overview

This function will set the subject alternative name certificate extension. It can set the following types: GNUTLS_SAN_DNSNAME as a text string, GNUTLS_SAN_RFC822NAME as a text string, GNUTLS_SAN_URI as a text string, GNUTLS_SAN_IPADDRESS as a binary IP address (4 or 16 bytes), GNUTLS_SAN_OTHERNAME_XMPP as a UTF8 string (since 3.5.0).

Since version 3.5.7 the GNUTLS_SAN_RFC822NAME, GNUTLS_SAN_DNSNAME, and GNUTLS_SAN_OTHERNAME_XMPP are converted to ACE format when necessary.

Returns

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

Since

2.6.0

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 7 times.

  1. 6.0
  2. 8
  3. 9
  4. 10
  5. 11
  6. 12
  7. 13
  8. Arch

Reporting bugs

Report bugs to <[email protected]>.
Home page: https://www.gnutls.org

From gnutls 3.8.13-3 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.