centos man page for gnutls_x509_crt_get_key_id

gnutls_x509_crt_get_key_id(3)					      gnutls					     gnutls_x509_crt_get_key_id(3)

NAME
       gnutls_x509_crt_get_key_id - API function

SYNOPSIS
       #include <gnutls/x509.h>

       int gnutls_x509_crt_get_key_id(gnutls_x509_crt_t crt, unsigned int flags, unsigned char * output_data, size_t * output_data_size);

ARGUMENTS
       gnutls_x509_crt_t crt
		   Holds the certificate

       unsigned int flags
		   should be 0 for now

       unsigned char * output_data
		   will contain the key ID

       size_t * output_data_size
		   holds the size of output_data (and will be replaced by the actual size of parameters)

DESCRIPTION
       This function will return a unique ID that depends on the public key parameters. This ID can be used in checking whether a certificate cor-
       responds to the given private key.

       If the buffer provided is not long enough to hold the output, then *output_data_size is updated and  GNUTLS_E_SHORT_MEMORY_BUFFER  will	be
       returned.  The output will normally be a SHA-1 hash output, which is 20 bytes.

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

REPORTING BUGS
       Report bugs to <bug-gnutls@gnu.org>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GnuTLS home page: http://www.gnu.org/software/gnutls/

COPYRIGHT
       Copyright (C) 2012 Free Software Foundation, Inc..
       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 info and gnutls programs are properly installed at your  site,
       the command

	      info gnutls

       should give you access to the complete manual.  As an alternative you may obtain the manual from:

	      http://www.gnu.org/software/gnutls/manual/

gnutls								      3.1.15					     gnutls_x509_crt_get_key_id(3)