gnutls_x509_crq_get_key_id(3)

1gnutls_x509_crq_get_key_id(3)       gnutls       gnutls_x509_crq_get_key_id(3)
2
3
4

NAME

6       gnutls_x509_crq_get_key_id - API function
7

SYNOPSIS

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

ARGUMENTS

15       gnutls_x509_crq_t crq
16                   a certificate of type gnutls_x509_crq_t
17
18       unsigned int flags
19                   should be one of the flags from gnutls_keyid_flags_t
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 that 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

RETURNS

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

SINCE

43       2.8.0
44

REPORTING BUGS

46       Report bugs to <bugs@gnutls.org>.
47       Home page: https://www.gnutls.org
48
49

COPYRIGHT

51       Copyright © 2001- Free Software Foundation, Inc., and others.
52       Copying  and  distribution  of this file, with or without modification,
53       are permitted in any medium without royalty provided the copyright  no‐
54       tice and this notice are preserved.
55