Man Linux: Main Page and Category List

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.