Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
gnutls_privkey_sign_hash(3)	    gnutls	   gnutls_privkey_sign_hash(3)

NAME
       gnutls_privkey_sign_hash	- API function

SYNOPSIS
       #include	<gnutls/abstract.h>

       int gnutls_privkey_sign_hash(gnutls_privkey_t signer, gnutls_digest_al-
       gorithm_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	or one of gnutls_privkey_flags_t

       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 algo-
       rithm 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.

       You may use gnutls_pubkey_get_preferred_hash_algorithm()	 to  determine
       the hash	algorithm.

       Note  that  if GNUTLS_PRIVKEY_SIGN_FLAG_TLS1_RSA	flag is	specified this
       function	will ignore  hash_algo and perform a raw PKCS1 signature.

RETURNS
       On success, GNUTLS_E_SUCCESS (0)	is returned, otherwise a negative  er-
       ror value.

SINCE
       2.12.0

REPORTING BUGS
       Report bugs to <bugs@gnutls.org>.
       Home page: http://www.gnutls.org

COPYRIGHT
       Copyright (C) 2001-2017 Free Software Foundation, Inc., and others.
       Copying	and  distribution  of this file, with or without modification,
       are permitted in	any medium without royalty provided the	copyright  no-
       tice and	this notice are	preserved.

SEE ALSO
       The  full  documentation	 for gnutls is maintained as a Texinfo manual.
       If the /usr/share/doc/gnutls/ directory does not	contain	the HTML  form
       visit

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

gnutls				    3.5.12	   gnutls_privkey_sign_hash(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | SINCE | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gnutls_privkey_sign_hash&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help