gnutls_x509_privkey_import2(3)

gnutls_x509_privkey_import23

Api function

Usage

#include <gnutls/x509.h>

int gnutls_x509_privkey_import2(gnutls_x509_privkey_t key, const gnutls_datum_t * data, gnutls_x509_crt_fmt_t format, const char * password, unsigned int flags);

Arguments

gnutls_x509_privkey_t key

The data to store the parsed key

const gnutls_datum_t * data

The DER or PEM encoded key.

gnutls_x509_crt_fmt_t format

One of DER or PEM

const char * password

A password (optional)

unsigned int flags

an ORed sequence of gnutls_pkcs_encrypt_flags_t

Overview

This function will import the given DER or PEM encoded key, to the native gnutls_x509_privkey_t format, irrespective of the input format. The input format is auto-detected.

The supported formats are basic unencrypted key, PKCS8, PKCS12, and the openssl format.

If the provided key is encrypted but no password was given, then GNUTLS_E_DECRYPTION_FAILED is returned. Since GnuTLS 3.4.0 this function will utilize the PIN callbacks if any.

Returns

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

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-01. Parsed by carta from the page's man source.