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

FreeBSD Manual Pages

  
 
  

home | help
gnutls_privkey_sign_hash2(3)	    gnutls	  gnutls_privkey_sign_hash2(3)

NAME
       gnutls_privkey_sign_hash2 - API function

SYNOPSIS
       #include	<gnutls/abstract.h>

       int  gnutls_privkey_sign_hash2(gnutls_privkey_t signer, gnutls_sign_al-
       gorithm_t 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_sign_algorithm_t algo
		   The signature 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 the	specified sig-
       nature	algorithm.   This    function	 is    an    enhancement    of
       gnutls_privkey_sign_hash(), as it allows	utilizing a alternative	signa-
       ture algorithm where possible (e.g, use an RSA key with RSA-PSS).

       The  flags may be GNUTLS_PRIVKEY_SIGN_FLAG_TLS1_RSA.  In	that case this
       function	will ignore  hash_algo and  perform  a	raw  PKCS1  signature.
       Note that this flag is supported	since 3.6.9.

       Note  also that,	not all	algorithm support signing already hashed data.
       When signing with Ed25519, gnutls_privkey_sign_data2() should  be  used
       instead.

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

SINCE
       3.6.0

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

COPYRIGHT
       Copyright (C) 2001-2023 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/local/share/doc/gnutls/ directory does not contain the HTML
       form visit

       https://www.gnutls.org/manual/

gnutls				     3.8.9	  gnutls_privkey_sign_hash2(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gnutls_privkey_sign_hash2&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help