Функции API (API function)
Имя (Name)
gnutls_privkey_sign_hash - API function
Синопсис (Synopsis)
#include <gnutls/abstract.h>
int gnutls_privkey_sign_hash(gnutls_privkey_t signer,
gnutls_digest_algorithm_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
algorithm 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.
The flags may be GNUTLS_PRIVKEY_SIGN_FLAG_TLS1_RSA or
GNUTLS_PRIVKEY_SIGN_FLAG_RSA_PSS. In the former case this
function will ignore hash_algo and perform a raw PKCS1
signature, and in the latter an RSA-PSS signature will be
generated.
Note that, not all algorithm support signing already hashed data.
When signing with Ed25519, gnutls_privkey_sign_data() should be
used.
Возвращаемое значение (Return value)
On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a
negative error value.
Сообщение об ошибках (Reporting bugs)
Report bugs to <bugs@gnutls.org>.
Home page: https://www.gnutls.org
Смотри также (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
https://www.gnutls.org/manual/
