1gnutls_x509_crt_get_name_constraints(g3n)utglnsutls_x509_crt_get_name_constraints(3)
2
3
4

NAME

6       gnutls_x509_crt_get_name_constraints - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int     gnutls_x509_crt_get_name_constraints(gnutls_x509_crt_t     crt,
12       gnutls_x509_name_constraints_t nc, unsigned int flags, unsigned  int  *
13       critical);
14

ARGUMENTS

16       gnutls_x509_crt_t crt
17                   should contain a gnutls_x509_crt_t type
18
19       gnutls_x509_name_constraints_t nc
20                   The nameconstraints intermediate type
21
22       unsigned int flags
23                   zero or GNUTLS_EXT_FLAG_APPEND
24
25       unsigned int * critical
26                   the extension status
27

DESCRIPTION

29       This function will return an intermediate type containing the name con‐
30       straints of the provided CA certificate. That structure can be used  in
31       combination with gnutls_x509_name_constraints_check() to verify whether
32       a server's name is in accordance with the constraints.
33
34       When the  flags is set  to  GNUTLS_EXT_FLAG_APPEND,  then  if  the   nc
35       structure is empty this function will behave identically as if the flag
36       was not set.  Otherwise if there are elements in the  nc structure then
37       the  constraints will be merged with the existing constraints following
38       RFC5280 p6.1.4 (excluded constraints will be appended,  permitted  will
39       be intersected).
40
41       Note that  nc must be initialized prior to calling this function.
42

RETURNS

44       On       success,      GNUTLS_E_SUCCESS      (0)      is      returned,
45       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE if the extension is not  present,
46       otherwise a negative error value.
47

SINCE

49       3.3.0
50

REPORTING BUGS

52       Report bugs to <bugs@gnutls.org>.
53       Home page: https://www.gnutls.org
54
55

57       Copyright © 2001- Free Software Foundation, Inc., and others.
58       Copying  and  distribution  of this file, with or without modification,
59       are permitted in any medium  without  royalty  provided  the  copyright
60       notice and this notice are preserved.
61

SEE ALSO

63       The  full  documentation  for gnutls is maintained as a Texinfo manual.
64       If the /usr/share/doc/gnutls/ directory does not contain the HTML  form
65       visit
66
67       https://www.gnutls.org/manual/
68
69gnutls                              3.6.g1n5utls_x509_crt_get_name_constraints(3)
Impressum