1gnutls_x509_crt_get_key_usage(3)    gnutls    gnutls_x509_crt_get_key_usage(3)
2
3
4

NAME

6       gnutls_x509_crt_get_key_usage - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int  gnutls_x509_crt_get_key_usage(gnutls_x509_crt_t cert, unsigned int
12       * key_usage, unsigned int * critical);
13

ARGUMENTS

15       gnutls_x509_crt_t cert
16                   should contain a gnutls_x509_crt_t type
17
18       unsigned int * key_usage
19                   where the key usage bits will be stored
20
21       unsigned int * critical
22                   will be non-zero if the extension is marked as critical
23

DESCRIPTION

25       This function will return  certificate's  key  usage,  by  reading  the
26       keyUsage  X.509  extension  (2.5.29.15).  The key usage value will ORed
27       values of  the:  GNUTLS_KEY_DIGITAL_SIGNATURE,  GNUTLS_KEY_NON_REPUDIA‐
28       TION,     GNUTLS_KEY_KEY_ENCIPHERMENT,    GNUTLS_KEY_DATA_ENCIPHERMENT,
29       GNUTLS_KEY_KEY_AGREEMENT,                     GNUTLS_KEY_KEY_CERT_SIGN,
30       GNUTLS_KEY_CRL_SIGN,     GNUTLS_KEY_ENCIPHER_ONLY,     GNUTLS_KEY_DECI‐
31       PHER_ONLY.
32

RETURNS

34       zero on success, or a negative error code in case of parsing error.  If
35       the  certificate  does  not contain the keyUsage extension GNUTLS_E_RE‐
36       QUESTED_DATA_NOT_AVAILABLE will be returned.
37

REPORTING BUGS

39       Report bugs to <bugs@gnutls.org>.
40       Home page: https://www.gnutls.org
41
42
44       Copyright © 2001-2023 Free Software Foundation, Inc., and others.
45       Copying and distribution of this file, with  or  without  modification,
46       are  permitted in any medium without royalty provided the copyright no‐
47       tice and this notice are preserved.
48

SEE ALSO

50       The full documentation for gnutls is maintained as  a  Texinfo  manual.
51       If  the /usr/share/doc/gnutls/ directory does not contain the HTML form
52       visit
53
54       https://www.gnutls.org/manual/
55
56gnutls                               3.8.2    gnutls_x509_crt_get_key_usage(3)
Impressum