NAME

       gnutls_x509_crt_get_key_usage - API function

SYNOPSIS

       #include <gnutls/x509.h>

       int   gnutls_x509_crt_get_key_usage(gnutls_x509_crt_t  cert,  unsigned  int  *  key_usage,
       unsigned int * critical);

ARGUMENTS

       gnutls_x509_crt_t cert
                   should contain a gnutls_x509_crt_t type

       unsigned int * key_usage
                   where the key usage bits will be stored

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

DESCRIPTION

       This function will return certificate's key usage, by reading the keyUsage X.509 extension
       (2.5.29.15).  The  key  usage value will ORed values of the: GNUTLS_KEY_DIGITAL_SIGNATURE,
       GNUTLS_KEY_NON_REPUDIATION,   GNUTLS_KEY_KEY_ENCIPHERMENT,   GNUTLS_KEY_DATA_ENCIPHERMENT,
       GNUTLS_KEY_KEY_AGREEMENT,          GNUTLS_KEY_KEY_CERT_SIGN,          GNUTLS_KEY_CRL_SIGN,
       GNUTLS_KEY_ENCIPHER_ONLY, GNUTLS_KEY_DECIPHER_ONLY.

RETURNS

       zero on success, or a negative error code in case of parsing error.   If  the  certificate
       does  not  contain  the  keyUsage  extension GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be
       returned.

REPORTING BUGS

       Report bugs to <bugs@gnutls.org>.
       Home page: https://www.gnutls.org

COPYRIGHT

       Copyright © 2001- 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.

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/