gnutls_x509_crq_sign2(3) — Linux manual page

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | RETURNS | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON

gnutls_x509_crq_sign2(3)         gnutls         gnutls_x509_crq_sign2(3)

NAME         top

       gnutls_x509_crq_sign2 - API function

SYNOPSIS         top

       #include <gnutls/x509.h>

       int gnutls_x509_crq_sign2(gnutls_x509_crq_t crq,
       gnutls_x509_privkey_t key, gnutls_digest_algorithm_t dig,
       unsigned int flags);

ARGUMENTS         top

       gnutls_x509_crq_t crq
                   should contain a gnutls_x509_crq_t type

       gnutls_x509_privkey_t key
                   holds a private key

       gnutls_digest_algorithm_t dig
                   The message digest to use, i.e., GNUTLS_DIG_SHA256

       unsigned int flags
                   must be 0

DESCRIPTION         top

       This function will sign the certificate request with a private
       key.  This must be the same key as the one used in
       gnutls_x509_crt_set_key() since a certificate request is self
       signed.

       This must be the last step in a certificate request generation
       since all the previously set parameters are now signed.

       A known limitation of this function is, that a newly-signed
       request will not be fully functional (e.g., for signature
       verification), until it is exported an re-imported.

       After GnuTLS 3.6.1 the value of  dig may be GNUTLS_DIG_UNKNOWN,
       and in that case, a suitable but reasonable for the key algorithm
       will be selected.

RETURNS         top

       GNUTLS_E_SUCCESS on success, otherwise a negative error code.
       GNUTLS_E_ASN1_VALUE_NOT_FOUND is returned if you didn't set all
       information in the certificate request (e.g., the version using
       gnutls_x509_crq_set_version()).

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

COLOPHON         top

       This page is part of the GnuTLS (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 gnutls-3.8.5.tar.xz fetched from
       ⟨http://www.gnutls.org/download.html⟩ on 2024-06-14.  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 is not part of the original
       manual page), send a mail to man-pages@man7.org

gnutls                            3.8.5         gnutls_x509_crq_sign2(3)