gnutls_fingerprint(3)

1gnutls_fingerprint(3)               gnutls               gnutls_fingerprint(3)
2
3
4

NAME

6       gnutls_fingerprint - API function
7

SYNOPSIS

9       #include <gnutls/gnutls.h>
10
11       int     gnutls_fingerprint(gnutls_digest_algorithm_t     algo,    const
12       gnutls_datum_t * data, void * result, size_t * result_size);
13

ARGUMENTS

15       gnutls_digest_algorithm_t algo
16                   is a digest algorithm
17
18       const gnutls_datum_t * data
19                   is the data
20
21       void * result
22                   is the place where the result will be copied (may be null).
23
24       size_t * result_size
25                   should hold the size of the result. The actual size of  the
26                   returned result will also be copied there.
27

DESCRIPTION

29       This  function  will  calculate a fingerprint (actually a hash), of the
30       given data.  The result is not printable data.  You should  convert  it
31       to hex, or to something else printable.
32
33       This  is  the  usual  way  to  calculate  a fingerprint of an X.509 DER
34       encoded certificate.  Note however that the fingerprint of  an  OpenPGP
35       is not just a hash and cannot be calculated with this function.
36

RETURNS

38       On  success,  GNUTLS_E_SUCCESS (0) is returned, otherwise an error code
39       is returned.
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

COPYRIGHT

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