gnutls_subject_alt_names_get(3)

1gnutls_subject_alt_names_get(3)     gnutls     gnutls_subject_alt_names_get(3)
2
3
4

NAME

6       gnutls_subject_alt_names_get - API function
7

SYNOPSIS

9       #include <gnutls/x509-ext.h>
10
11       int  gnutls_subject_alt_names_get(gnutls_subject_alt_names_t  sans, un‐
12       signed  int  seq,  unsigned  int  *  san_type,  gnutls_datum_t  *  san,
13       gnutls_datum_t * othername_oid);
14

ARGUMENTS

16       gnutls_subject_alt_names_t sans
17                   The alternative names
18
19       unsigned int seq
20                   The index of the name to get
21
22       unsigned int * san_type
23                   Will   hold   the   type   of   the  name  (of  gnutls_sub‐
24                   ject_alt_names_t)
25
26       gnutls_datum_t * san
27                   The alternative name data (should be treated as constant)
28
29       gnutls_datum_t * othername_oid
30                   The object identifier if  san_type is  GNUTLS_SAN_OTHERNAME
31                   (should be treated as constant)
32

DESCRIPTION

34       This  function will return a specific alternative name as stored in the
35       sans type. The returned values should be treated as constant and  valid
36       for the lifetime of  sans .
37

RETURNS

39       On    success,   GNUTLS_E_SUCCESS   [22m(0)   is   returned,   GNUTLS_E_RE‐
40       QUESTED_DATA_NOT_AVAILABLE if the index is out of bounds,  otherwise  a
41       negative error value.
42

SINCE

44       3.3.0
45

REPORTING BUGS

47       Report bugs to <bugs@gnutls.org>.
48       Home page: https://www.gnutls.org
49
50

COPYRIGHT

52       Copyright © 2001- Free Software Foundation, Inc., and others.
53       Copying  and  distribution  of this file, with or without modification,
54       are permitted in any medium without royalty provided the copyright  no‐
55       tice and this notice are preserved.
56