| 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 |