---
name: "gnutls_pkcs8_info"
section: "3"
platform: "linux"
package: "gnutls"
version: "3.8.13-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gnutls_pkcs8_info"
---

# gnutls\_pkcs8\_info(3)

API function

## NAME

gnutls\_pkcs8\_info - API function

## SYNOPSIS

**#include \<gnutls/x509.h\>**

**int gnutls\_pkcs8\_info(const gnutls\_datum\_t \*** *data***, gnutls\_x509\_crt\_fmt\_t** *format***, unsigned int \*** *schema***, unsigned int \*** *cipher***, void \*** *salt***, unsigned int \*** *salt\_size***, unsigned int \*** *iter\_count***, char \*\*** *oid***);**

## ARGUMENTS

- const gnutls\_datum\_t \* data

  Holds the PKCS **8** data

- gnutls\_x509\_crt\_fmt\_t format

  the format of the PKCS **8** data

- unsigned int \* schema

  indicate the schema as one of **gnutls\_pkcs\_encrypt\_flags\_t**

- unsigned int \* cipher

  the cipher used as **gnutls\_cipher\_algorithm\_t**

- void \* salt

  PBKDF2 salt (if non-NULL then  *salt\_size* initially holds its size)

- unsigned int \* salt\_size

  PBKDF2 salt size

- unsigned int \* iter\_count

  PBKDF2 iteration count

- char \*\* oid

  if non-NULL it will contain an allocated null-terminated variable with the OID

## DESCRIPTION

This function will provide information on the algorithms used in a particular PKCS **8** structure. If the structure algorithms are unknown the code **GNUTLS\_E\_UNKNOWN\_CIPHER\_TYPE** will be returned, and only  *oid* , will be set. That is,  *oid* will be set on encrypted PKCS **8** structures whether supported or not. It must be deinitialized using **gnutls\_free()**. The other variables are only set on supported structures.

## RETURNS

**GNUTLS\_E\_INVALID\_REQUEST** if the provided structure isn't an encrypted key, **GNUTLS\_E\_UNKNOWN\_CIPHER\_TYPE** if the structure's encryption isn't supported, or another negative error code in case of a failure. Zero on success.

## SINCE

3\.4.0

## REPORTING BUGS

Report bugs to \<bugs@gnutls.org\>.\
 Home page: https://www.gnutls.org

## COPYRIGHT

Copyright © 2001-2023 Free Software Foundation, Inc., and others.\
 Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

## 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

- https://www.gnutls.org/manual/