Provided by: gnutls-doc_3.0.11+really2.12.14-5ubuntu3_all bug

NAME

       gnutls_x509_crt_get_basic_constraints - API function

SYNOPSIS

       #include <gnutls/x509.h>

       int gnutls_x509_crt_get_basic_constraints(gnutls_x509_crt_t cert, unsigned int * critical,
       int * ca, int * pathlen);

ARGUMENTS

       gnutls_x509_crt_t cert
                   should contain a gnutls_x509_crt_t structure

       unsigned int * critical
                   will be non zero if the extension is marked as critical

       int * ca    pointer to output integer indicating CA status, may be NULL, value is 1 if the
                   certificate CA flag is set, 0 otherwise.

       int * pathlen
                   pointer  to  output integer indicating path length (may be NULL), non-negative
                   values indicate a present pathLenConstraint field and  the  actual  value,  -1
                   indicate that the field is absent.

DESCRIPTION

       This  function  will read the certificate's basic constraints, and return the certificates
       CA status.  It reads the basicConstraints X.509 extension (2.5.29.19).

RETURN VALUE

       If the certificate is a CA a positive value will be returned, or zero if  the  certificate
       does  not  have  CA flag set.  A negative value may be returned in case of errors.  If the
       certificate      does      not      contain      the      basicConstraints       extension
       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.

REPORTING BUGS

       Report       bugs       to       <bug-gnutls@gnu.org>.        GnuTLS       home      page:
       http://www.gnu.org/software/gnutls/     General     help     using      GNU      software:
       http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright © 2008 Free Software Foundation.
       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.

SEE ALSO

       The full documentation for gnutls is maintained as a Texinfo  manual.   If  the  info  and
       gnutls programs are properly installed at your site, the command

              info gnutls

       should give you access to the complete manual.