manpagez: man pages & more
man gnutls_x509_privkey_sign_data(3)
Home | html | info | man
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>

       gnutls_x509_privkey_sign_data(3)      key,
       gnutls_digest_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
       together 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
       returned.

       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
       error 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
       notice 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.14    gnutls_x509_privkey_sign_data(3)

gnutls 3.5.15 - Generated Mon Aug 21 18:44:01 CDT 2017
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.