Movatterモバイル変換

gnutls_pkcs11_privkey_generate3(3) — Linux manual page

gnutls_pkcs11...vkey_generate3(3) gnutlsgnutls_pkcs11...vkey_generate3(3)

NAME        top

       gnutls_pkcs11_privkey_generate3 - API function

SYNOPSIS        top

#include <gnutls/pkcs11.h>int gnutls_pkcs11_privkey_generate3(const char *url,gnutls_pk_algorithm_tpk, unsigned intbits, const char *label,const gnutls_datum_t *cid, gnutls_x509_crt_fmt_tfmt,gnutls_datum_t *pubkey, unsigned intkey_usage, unsigned intflags);

ARGUMENTS        top

       const char * url                   a token URL       gnutls_pk_algorithm_t pk                   the public key algorithm       unsigned int bits                   the security bits       const char * label                   a label       const gnutls_datum_t * cid                   The CKA_ID to use for the new object       gnutls_x509_crt_fmt_t fmt                   the format of output params. PEM or DER       gnutls_datum_t * pubkey                   will hold the public key (may beNULL)       unsigned int key_usage                   One of GNUTLS_KEY_*       unsigned int flags                   zero or an OR'ed sequence ofGNUTLS_PKCS11_OBJ_FLAGs

DESCRIPTION        top

       This function will generate a private key in the specified by theurl token. The private key will be generate within the token and       will not be exportable. This function will store the DER-encoded       public key in the SubjectPublicKeyInfo format inpubkey . Thepubkey should be deinitialized usinggnutls_free().       Note that when generating an elliptic curve key, the curve can be       substituted in the place of the bits parameter using theGNUTLS_CURVE_TO_BITS()macro.       Since 3.6.3 the objects are marked as sensitive by default unlessGNUTLS_PKCS11_OBJ_FLAG_MARK_NOT_SENSITIVEis specified.

RETURNS        top

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

SINCE        top

       3.4.0

REPORTING BUGS        top

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

COPYRIGHT        top

       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        top

       The full documentation forgnutlsis maintained as a Texinfo       manual.  If the /usr/share/doc/gnutls/ directory does not contain       the HTML form visithttps://www.gnutls.org/manual/

COLOPHON        top

       This page is part of theGnuTLS (GnuTLS Transport Layer Security       Library) project.  Information about the project can be found at       ⟨http://www.gnutls.org/⟩.  If you have a bug report for this       manual page, send it to bugs@gnutls.org.  This page was obtained       from the tarball fetched from       ⟨https://www.gnupg.org/ftp/gcrypt/gnutls/⟩ on 2025-08-11.  If you       discover any rendering problems in this HTML version of the page,       or you believe there is a better or more up-to-date source for the       page, or you have corrections or improvements to the information       in this COLOPHON (which isnot part of the original manual page),       send a mail to man-pages@man7.orggnutls                            3.8.10gnutls_pkcs11...vkey_generate3(3)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.