Путеводитель по Руководству Linux

  User  |  Syst  |  Libr  |  Device  |  Files  |  Other  |  Admin  |  Head  |



   gnutls_privkey_sign_hash    ( 3 )

Функции 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/