Blame doc/functions/gnutls_session_set_verify_cert

Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
Packit Service 4684c1
@deftypefun {void} {gnutls_session_set_verify_cert} (gnutls_session_t @var{session}, const char * @var{hostname}, unsigned @var{flags})
Packit Service 4684c1
@var{session}: is a gnutls session
Packit Service 4684c1
Packit Service 4684c1
@var{hostname}: is the expected name of the peer; may be @code{NULL} 
Packit Service 4684c1
Packit Service 4684c1
@var{flags}: flags for certificate verification -- @code{gnutls_certificate_verify_flags} 
Packit Service 4684c1
Packit Service 4684c1
This function instructs GnuTLS to verify the peer's certificate
Packit Service 4684c1
using the provided hostname. If the verification fails the handshake
Packit Service 4684c1
will also fail with @code{GNUTLS_E_CERTIFICATE_VERIFICATION_ERROR} . In that
Packit Service 4684c1
case the verification result can be obtained using @code{gnutls_session_get_verify_cert_status()} .
Packit Service 4684c1
Packit Service 4684c1
The  @code{hostname} pointer provided must remain valid for the lifetime
Packit Service 4684c1
of the session. More precisely it should be available during any subsequent
Packit Service 4684c1
handshakes. If no hostname is provided, no hostname verification
Packit Service 4684c1
will be performed. For a more advanced verification function check
Packit Service 4684c1
@code{gnutls_session_set_verify_cert2()} .
Packit Service 4684c1
Packit Service 4684c1
If  @code{flags} is provided which contain a profile, this function should be
Packit Service 4684c1
called after any session priority setting functions.
Packit Service 4684c1
Packit Service 4684c1
The @code{gnutls_session_set_verify_cert()}  function is intended to be used by TLS
Packit Service 4684c1
clients to verify the server's certificate.
Packit Service 4684c1
Packit Service 4684c1
@strong{Since:} 3.4.6
Packit Service 4684c1
@end deftypefun