Blame doc/manpages/gnutls_certificate_type_get2.3

Packit aea12f
.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
Packit Service 991b93
.TH "gnutls_certificate_type_get2" 3 "3.6.14" "gnutls" "gnutls"
Packit aea12f
.SH NAME
Packit aea12f
gnutls_certificate_type_get2 \- API function
Packit aea12f
.SH SYNOPSIS
Packit aea12f
.B #include <gnutls/gnutls.h>
Packit aea12f
.sp
Packit aea12f
.BI "gnutls_certificate_type_t gnutls_certificate_type_get2(gnutls_session_t " session ", gnutls_ctype_target_t " target ");"
Packit aea12f
.SH ARGUMENTS
Packit aea12f
.IP "gnutls_session_t session" 12
Packit aea12f
is a \fBgnutls_session_t\fP type.
Packit aea12f
.IP "gnutls_ctype_target_t target" 12
Packit aea12f
is a \fBgnutls_ctype_target_t\fP type.
Packit aea12f
.SH "DESCRIPTION"
Packit aea12f
This function returns the type of the certificate that a side
Packit aea12f
is negotiated to use.  The certificate type is by default X.509,
Packit aea12f
unless an alternative certificate type is enabled by \fBgnutls_init()\fP and
Packit aea12f
negotiated during the session.
Packit aea12f
Packit aea12f
The  \fItarget\fP parameter specifies whether to request the negotiated
Packit aea12f
certificate type for the client (\fBGNUTLS_CTYPE_CLIENT\fP),
Packit aea12f
or for the server (\fBGNUTLS_CTYPE_SERVER\fP). Additionally, in P2P mode
Packit aea12f
connection set up where you don't know in advance who will be client
Packit aea12f
and who will be server you can use the flag (\fBGNUTLS_CTYPE_OURS\fP) and
Packit aea12f
(\fBGNUTLS_CTYPE_PEERS\fP) to retrieve the corresponding certificate types.
Packit aea12f
Packit aea12f
Resumed sessions will return the certificate type that was negotiated
Packit aea12f
and used in the original session. That is, this function can be used
Packit aea12f
to reliably determine the type of the certificate returned by
Packit aea12f
\fBgnutls_certificate_get_peers()\fP.
Packit aea12f
.SH "RETURNS"
Packit aea12f
the currently used \fBgnutls_certificate_type_t\fP certificate
Packit aea12f
type for the client or the server.
Packit aea12f
.SH "SINCE"
Packit aea12f
3.6.4
Packit aea12f
.SH "REPORTING BUGS"
Packit aea12f
Report bugs to <bugs@gnutls.org>.
Packit aea12f
.br
Packit aea12f
Home page: https://www.gnutls.org
Packit aea12f
Packit aea12f
.SH COPYRIGHT
Packit Service 991b93
Copyright \(co 2001- Free Software Foundation, Inc., and others.
Packit aea12f
.br
Packit aea12f
Copying and distribution of this file, with or without modification,
Packit aea12f
are permitted in any medium without royalty provided the copyright
Packit aea12f
notice and this notice are preserved.
Packit aea12f
.SH "SEE ALSO"
Packit aea12f
The full documentation for
Packit aea12f
.B gnutls
Packit aea12f
is maintained as a Texinfo manual.
Packit aea12f
If the /usr/share/doc/gnutls/
Packit aea12f
directory does not contain the HTML form visit
Packit aea12f
.B
Packit aea12f
.IP https://www.gnutls.org/manual/
Packit aea12f
.PP