gnutls_privkey_import_tpm_url(3)

gnutls_privkey_import_tpm_url3

Api function

Usage

#include <gnutls/abstract.h>

int gnutls_privkey_import_tpm_url(gnutls_privkey_t pkey, const char * url, const char * srk_password, const char * key_password, unsigned int flags);

Arguments

gnutls_privkey_t pkey

The private key

const char * url

The URL of the TPM key to be imported

const char * srk_password

The password for the SRK key (optional)

const char * key_password

A password for the key (optional)

unsigned int flags

One of the GNUTLS_PRIVKEY_* flags

Overview

This function will import the given private key to the abstract gnutls_privkey_t type.

Note that unless GNUTLS_PRIVKEY_DISABLE_CALLBACKS is specified, if incorrect (or NULL) passwords are given the PKCS11 callback functions will be used to obtain the correct passwords. Otherwise if the SRK password is wrong GNUTLS_E_TPM_SRK_PASSWORD_ERROR is returned and if the key password is wrong or not provided then GNUTLS_E_TPM_KEY_PASSWORD_ERROR is returned.

Returns

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

Since

3.1.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.