Name

gnutls_privkey_sign_hash — API function

Synopsis

#include <gnutls/gnutls.h>
int gnutls_privkey_sign_hash( gnutls_privkey_t signer,
  gnutls_digest_algorithm_t hash_algo,
  unsigned int flags,
  const gnutls_datum_t * hash_data,
  gnutls_datum_t * signature);
 

ARGUMENTS

gnutls_privkey_t signer

Holds the signer's key

gnutls_digest_algorithm_t hash_algo

The hash algorithm used

unsigned int flags

zero for now

const gnutls_datum_t * hash_data

holds the data to be signed

gnutls_datum_t * signature

will contain newly allocated signature

DESCRIPTION

This function will sign the given hashed data using a signature algorithm supported by the private key. Signature algorithms are always used together with a hash functions. Different hash functions may be used for the RSA algorithm, but only SHA−XXX for the DSA keys.

Use gnutls_pubkey_get_preferred_hash_algorithm() to determine the hash algorithm.

RETURNS

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

SINCE

2.12.0

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/

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.

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.