gnutls_certificate_type_get2(3) — Linux manual page

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

gnutls_certificate_type_get2(3)  gnutls  gnutls_certificate_type_get2(3)

NAME         top

       gnutls_certificate_type_get2 - API function

SYNOPSIS         top

       #include <gnutls/gnutls.h>

       gnutls_certificate_type_t
       gnutls_certificate_type_get2(gnutls_session_t session,
       gnutls_ctype_target_t target);

ARGUMENTS         top

       gnutls_session_t session
                   is a gnutls_session_t type.

       gnutls_ctype_target_t target
                   is a gnutls_ctype_target_t type.

DESCRIPTION         top

       This function returns the type of the certificate that a side is
       negotiated to use.  The certificate type is by default X.509,
       unless an alternative certificate type is enabled by
       gnutls_init() and negotiated during the session.

       The  target parameter specifies whether to request the negotiated
       certificate type for the client (GNUTLS_CTYPE_CLIENT), or for the
       server (GNUTLS_CTYPE_SERVER). Additionally, in P2P mode
       connection set up where you don't know in advance who will be
       client and who will be server you can use the flag
       (GNUTLS_CTYPE_OURS) and (GNUTLS_CTYPE_PEERS) to retrieve the
       corresponding certificate types.

       Resumed sessions will return the certificate type that was
       negotiated and used in the original session. That is, this
       function can be used to reliably determine the type of the
       certificate returned by gnutls_certificate_get_peers().

RETURNS         top

       the currently used gnutls_certificate_type_t certificate type for
       the client or the server.

SINCE         top

       3.6.4

REPORTING BUGS         top

       Report bugs to <[email protected]>.
       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 [email protected].  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 [email protected]

gnutls                            3.8.5  gnutls_certificate_type_get2(3)