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 structure
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       the certificate key usage, or a  negative  value  in  case  of  parsing
35       error.   If  the  certificate  does  not contain the keyUsage extension
36       GNUTLS_E_REQUESTED_DATA_NOT_AVAILABLE will be returned.
37

REPORTING BUGS

39       Report   bugs   to    <bug-gnutls@gnu.org>.     GnuTLS    home    page:
40       http://www.gnu.org/software/gnutls/  General  help  using GNU software:
41       http://www.gnu.org/gethelp/
42
44       Copyright © 2008 Free Software Foundation.
45       Copying and distribution of this file, with  or  without  modification,
46       are  permitted  in  any  medium  without royalty provided the copyright
47       notice and this notice are preserved.
48

SEE ALSO

50       The full documentation for gnutls is maintained as  a  Texinfo  manual.
51       If  the  info  and gnutls programs are properly installed at your site,
52       the command
53
54              info gnutls
55
56       should give you access to the complete manual.
57
58
59
60gnutls                             2.12.6.1   gnutls_x509_crt_get_key_usage(3)
Impressum