gnutls_privkey_import_ext3 man page

gnutls_privkey_import_ext3 — API function

Synopsis

#include <gnutls/abstract.h>

int gnutls_privkey_import_ext3(gnutls_privkey_t pkey, void * userdata, gnutls_privkey_sign_func sign_fn, gnutls_privkey_decrypt_func decrypt_fn, gnutls_privkey_deinit_func deinit_fn, gnutls_privkey_info_func info_fn, unsigned int flags);

Arguments

gnutls_privkey_t pkey
The private key
void * userdata
private data to be provided to the callbacks
gnutls_privkey_sign_func sign_fn
callback for signature operations
gnutls_privkey_decrypt_func decrypt_fn
callback for decryption operations
gnutls_privkey_deinit_func deinit_fn
a deinitialization function
gnutls_privkey_info_func info_fn
returns info about the public key algorithm (should not be NULL)
unsigned int flags
Flags for the import

Description

This function will associate the given callbacks with the gnutls_privkey_t type. At least one of the two callbacks must be non-null. If a deinitialization function is provided then flags is assumed to contain GNUTLS_PRIVKEY_IMPORT_AUTO_RELEASE.

Note that the signing function is supposed to "raw" sign data, i.e., without any hashing or preprocessing. In case of RSA the DigestInfo will be provided, and the signing function is expected to do the PKCS 1 1.5 padding and the exponentiation.

The info_fn must provide information on the algorithms supported by this private key, and should support the flags GNUTLS_PRIVKEY_INFO_PK_ALGO and GNUTLS_PRIVKEY_INFO_SIGN_ALGO. It must return -1 on unknown flags.

Returns

On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value.

Since

3.4.0

Reporting Bugs

Report bugs to <bugs@gnutls.org>.
Home page: http://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

http://www.gnutls.org/manual/

Info

3.5.5 gnutls gnutls