|
Packit |
aea12f |
.\" DO NOT MODIFY THIS FILE! It was generated by gdoc.
|
|
Packit Service |
991b93 |
.TH "gnutls_session_set_verify_cert" 3 "3.6.14" "gnutls" "gnutls"
|
|
Packit |
aea12f |
.SH NAME
|
|
Packit |
aea12f |
gnutls_session_set_verify_cert \- API function
|
|
Packit |
aea12f |
.SH SYNOPSIS
|
|
Packit |
aea12f |
.B #include <gnutls/gnutls.h>
|
|
Packit |
aea12f |
.sp
|
|
Packit |
aea12f |
.BI "void gnutls_session_set_verify_cert(gnutls_session_t " session ", const char * " hostname ", unsigned " flags ");"
|
|
Packit |
aea12f |
.SH ARGUMENTS
|
|
Packit |
aea12f |
.IP "gnutls_session_t session" 12
|
|
Packit |
aea12f |
is a gnutls session
|
|
Packit |
aea12f |
.IP "const char * hostname" 12
|
|
Packit |
aea12f |
is the expected name of the peer; may be \fBNULL\fP
|
|
Packit |
aea12f |
.IP "unsigned flags" 12
|
|
Packit |
aea12f |
flags for certificate verification \-\- \fBgnutls_certificate_verify_flags\fP
|
|
Packit |
aea12f |
.SH "DESCRIPTION"
|
|
Packit |
aea12f |
This function instructs GnuTLS to verify the peer's certificate
|
|
Packit |
aea12f |
using the provided hostname. If the verification fails the handshake
|
|
Packit |
aea12f |
will also fail with \fBGNUTLS_E_CERTIFICATE_VERIFICATION_ERROR\fP. In that
|
|
Packit |
aea12f |
case the verification result can be obtained using \fBgnutls_session_get_verify_cert_status()\fP.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
The \fIhostname\fP pointer provided must remain valid for the lifetime
|
|
Packit |
aea12f |
of the session. More precisely it should be available during any subsequent
|
|
Packit |
aea12f |
handshakes. If no hostname is provided, no hostname verification
|
|
Packit |
aea12f |
will be performed. For a more advanced verification function check
|
|
Packit |
aea12f |
\fBgnutls_session_set_verify_cert2()\fP.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
If \fIflags\fP is provided which contain a profile, this function should be
|
|
Packit |
aea12f |
called after any session priority setting functions.
|
|
Packit |
aea12f |
|
|
Packit |
aea12f |
The \fBgnutls_session_set_verify_cert()\fP function is intended to be used by TLS
|
|
Packit |
aea12f |
clients to verify the server's certificate.
|
|
Packit |
aea12f |
.SH "SINCE"
|
|
Packit |
aea12f |
3.4.6
|
|
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
|