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

FreeBSD Manual Pages

  
 
  

home | help 
gnutls_x509_privkey_sign_data(3)    gnutls    gnutls_x509_privkey_sign_data(3)

NAME
       gnutls_x509_privkey_sign_data - API function

SYNOPSIS
       #include	<gnutls/x509.h>

       int gnutls_x509_privkey_sign_data(gnutls_x509_privkey_t key, gnutls_di-
       gest_algorithm_t	 digest,  unsigned  int	 flags,	const gnutls_datum_t *
       data, void * signature, size_t *	signature_size);

ARGUMENTS
       gnutls_x509_privkey_t key
		   a key

       gnutls_digest_algorithm_t digest
		   should be a digest algorithm

       unsigned	int flags
		   should be 0 for now

       const gnutls_datum_t * data
		   holds the data to be	signed

       void * signature
		   will	contain	the signature

       size_t *	signature_size
		   holds the size of signature (and will be  replaced  by  the
		   new size)

DESCRIPTION
       This function will sign the given data using a signature	algorithm sup-
       ported  by  the	private	 key. Signature	algorithms are always used to-
       gether with a hash functions.  Different	hash functions may be used for
       the RSA algorithm, but only SHA-1 for the DSA keys.

       If the buffer provided is not long enough to hold the  output,  then  *
       signature_size  is updated and GNUTLS_E_SHORT_MEMORY_BUFFER will	be re-
       turned.

       Use  gnutls_x509_crt_get_preferred_hash_algorithm()  to	determine  the
       hash algorithm.

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

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_x509_privkey_sign_data(3)

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

home | help