gnutls_fingerprint

Section: gnutls (3)
Updated: 2.8.5
Index Return to Main Contents
 

NAME

gnutls_fingerprint - calculate the fingerprint of the given data  

SYNOPSIS

#include <gnutls/gnutls.h>

int gnutls_fingerprint(gnutls_digest_algorithm_t algo, const gnutls_datum_t * data, void * result, size_t * result_size);  

ARGUMENTS

gnutls_digest_algorithm_t algo
is a digest algorithm
const gnutls_datum_t * data
is the data
void * result
is the place where the result will be copied (may be null).
size_t * result_size
should hold the size of the result. The actual size of the returned result will also be copied there.
 

DESCRIPTION

This function will calculate a fingerprint (actually a hash), of the given data. The result is not printable data. You should convert it to hex, or to something else printable.

This is the usual way to calculate a fingerprint of an X.509 DER encoded certificate. Note however that the fingerprint of an OpenPGP is not just a hash and cannot be calculated with this function.  

RETURNS

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise an error code is returned.  

REPORTING BUGS

Report bugs to <bug-gnutls@gnu.org>. GnuTLS home page: http://www.gnu.org/software/gnutls/ General help using GNU software: http://www.gnu.org/gethelp/  

COPYRIGHT

Copyright © 2008 Free Software Foundation.
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.