gnutls_pkcs11_copy_secret_key(3)

gnutls_pkcs11_copy_secret_key3

Api function

Usage

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_secret_key(const char * token_url, gnutls_datum_t * key, const char * label, unsigned int key_usage, unsigned int flags);

Arguments

const char * token_url

A PKCS 11 URL specifying a token

gnutls_datum_t * key

The raw key

const char * label

A name to be used for the stored data

unsigned int key_usage

One of GNUTLS_KEY_*

unsigned int flags

One of GNUTLS_PKCS11_OBJ_FLAG_*

Overview

This function will copy a raw secret (symmetric) key into a PKCS 11 token specified by a URL. The key can be marked as sensitive or not.

Returns

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

Since

2.12.0

Releases

7 releases since Debian 8 (Jessie); the text changed 6 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12
  6. 13
  7. Arch

Reporting bugs

Report bugs to <[email protected]>.
Home page: https://www.gnutls.org

From gnutls 3.8.13-3 in Arch Linux 2026-11-07. Parsed by carta from the page's man source.