=pod

=head1 NAME

DTLSv1_handle_timeout - handle a pending timeout event for a DTLS SSL object

=head1 SYNOPSIS

 #include <openssl/ssl.h>

 int DTLSv1_handle_timeout(SSL *ssl);

=head1 DESCRIPTION

DTLSv1_handle_timeout() handles any timeout events which have become pending
on a DTLS SSL object.

Use L<DTLSv1_get_timeout(3)> or L<SSL_get_tick_timeout(3)> to determine
when to call DTLSv1_handle_timeout().

This function is only applicable to DTLS objects. It returns 0 if called on
any other kind of SSL object.

L<SSL_tick(3)> supersedes all use cases for this this function and may be used
instead of it.

=head1 RETURN VALUES

Returns 1 if there was a pending timeout event and it was handled successfully.

Returns 0 if there was no pending timeout event, or if the SSL object is not a
DTLS object.

Returns -1 if there was a pending timeout event but it could not be handled
successfully.

=head1 SEE ALSO

L<DTLSv1_get_timeout(3)>, L<SSL_tick(3)>, L<ssl(7)>

=head1 COPYRIGHT

Copyright 2023 The OpenSSL Project Authors. All Rights Reserved.

Licensed under the Apache License 2.0 (the "License").  You may not use
this file except in compliance with the License.  You can obtain a copy
in the file LICENSE in the source distribution or at
L<https://www.openssl.org/source/license.html>.

=cut