1gnutls_x509_crt_get_key_id(3)       gnutls       gnutls_x509_crt_get_key_id(3)
2
3
4

NAME

6       gnutls_x509_crt_get_key_id - API function
7

SYNOPSIS

9       #include <gnutls/x509.h>
10
11       int   gnutls_x509_crt_get_key_id(gnutls_x509_crt_t  crt,  unsigned  int
12       flags, unsigned char * output_data, size_t * output_data_size);
13

ARGUMENTS

15       gnutls_x509_crt_t crt
16                   Holds the certificate
17
18       unsigned int flags
19                   should be 0 for now
20
21       unsigned char * output_data
22                   will contain the key ID
23
24       size_t * output_data_size
25                   holds the size of output_data (and will be replaced by  the
26                   actual size of parameters)
27

DESCRIPTION

29       This  function  will  return  a unique ID the depends on the public key
30       parameters. This ID can be used in checking whether a certificate  cor‐
31       responds to the given private key.
32
33       If  the  buffer  provided  is  not long enough to hold the output, then
34       *output_data_size is updated and GNUTLS_E_SHORT_MEMORY_BUFFER  will  be
35       returned.  The output will normally be a SHA-1 hash output, which is 20
36       bytes.
37

RETURN VALUE

39       In case of failure a negative value will be returned, and 0 on success.
40

REPORTING BUGS

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

SEE ALSO

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