gnutls_pkcs11_copy_x509_privkey2 man page

gnutls_pkcs11_copy_x509_privkey2 — API function

Synopsis

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_x509_privkey2(const char * token_url, gnutls_x509_privkey_t key, const char * label, const gnutls_datum_t * cid, unsigned int key_usage, unsigned int flags);

Arguments

const char * token_url
A PKCS 11 URL specifying a token
gnutls_x509_privkey_t key
A private key
const char * label
A name to be used for the stored data
const gnutls_datum_t * cid
The CKA_ID to set for the object -if NULL, the ID will be derived from the public key
unsigned int key_usage
One of GNUTLS_KEY_*
unsigned int flags
One of GNUTLS_PKCS11_OBJ_* flags

Description

This function will copy a private key into a PKCS 11 token specified by a URL. It is highly recommended flags to contain GNUTLS_PKCS11_OBJ_FLAG_MARK_SENSITIVE unless there is a strong reason not to.

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