gnutls_pkcs11_copy_pubkey(3)

gnutls_pkcs11_copy_pubkey3

Api function

Usage

#include <gnutls/pkcs11.h>

int gnutls_pkcs11_copy_pubkey(const char * token_url, gnutls_pubkey_t pubkey, 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_pubkey_t pubkey

The public key to copy

const char * label

The 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_FLAG_*

Overview

This function will copy a public key object into a PKCS 11 token specified by a URL. Valid flags to mark the key: GNUTLS_PKCS11_OBJ_FLAG_MARK_TRUSTED, GNUTLS_PKCS11_OBJ_FLAG_MARK_PRIVATE, GNUTLS_PKCS11_OBJ_FLAG_MARK_CA, GNUTLS_PKCS11_OBJ_FLAG_MARK_ALWAYS_AUTH.

Returns

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

Since

3.4.6

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. 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-01. Parsed by carta from the page's man source.