Debian Codegraph @

doc/functions/dane_verify_session_crt

raw
1
2
3
4
5 @deftypefun {int} {dane_verify_session_crt} (dane_state_t @var{s}, gnutls_session_t @var{session}, const char * @var{hostname}, const char * @var{proto}, unsigned int @var{port}, unsigned int @var{sflags}, unsigned int @var{vflags}, unsigned int * @var{verify})
6 @var{s}: A DANE state structure (may be NULL)
7
8 @var{session}: A gnutls session
9
10 @var{hostname}: The hostname associated with the chain
11
12 @var{proto}: The protocol of the service connecting (e.g. tcp)
13
14 @var{port}: The port of the service connecting (e.g. 443)
15
16 @var{sflags}: Flags for the initialization of @code{s} (if NULL)
17
18 @var{vflags}: Verification flags; an OR'ed list of @code{dane_verify_flags_t} .
19
20 @var{verify}: An OR'ed list of @code{dane_verify_status_t} .
21
22 This function will verify session's certificate chain against the
23 CA constrains and/or the certificate available via DANE.
24 See @code{dane_verify_crt()} for more information.
25
26 This will not verify the chain for validity; unless the DANE
27 verification is restricted to end certificates, this must be
28 be performed separately using @code{gnutls_certificate_verify_peers3()} .
29
30 @strong{Returns:} a negative error code on error and @code{DANE_E_SUCCESS} (0)
31 when the DANE entries were successfully parsed, irrespective of
32 whether they were verified (see @code{verify} for that information). If
33 no usable entries were encountered @code{DANE_E_REQUESTED_DATA_NOT_AVAILABLE}
34 will be returned.
35 @end deftypefun