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 MD5 or SHA1

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

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

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

home | help