NAME

       gnutls_x509_privkey_import2 - API function

SYNOPSIS

       #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

DESCRIPTION

       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.

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/