DTLSV1_HANDLE_TIMEOUT(3ossl)

📦 version 3.5.0, in opensuse-leap 16.0

🌸 NAME 🌸

okay so hi bestie 💖 this is DTLSv1_handle_timeout from the 3ossl manual, and it’s literally the little helper that deals with a timeout event that’s gone pending on a DTLS or QUIC SSL object. iconic behavior, no cap.

✨ SYNOPSIS ✨

#include <openssl/ssl.h>

int DTLSv1_handle_timeout(SSL *ssl);

🎀 DESCRIPTION 🎀

So DTLSv1_handle_timeout() handles any timeout events that have become pending on a DTLS or QUIC SSL object. That’s the whole vibe: pending timeout? handled. 🫶

To figure out when you should call it, use DTLSv1_get_timeout(3) or SSL_get_event_timeout(3). They’re the ones giving you the timing tea ☕.

This function is only applicable to DTLS or QUIC SSL objects, fr fr. If you call it on any other kind of SSL object, it returns 0 — like, it is not the main character for that object 💀.

Also important: SSL_handle_events(3) supersedes all use cases for this function and may be used instead of it. So yeah, that call ate and left no crumbs 👑.

💅 RETURN VALUES 💅

  • 1 — there was a pending timeout event, and it was handled successfully. slay ✨
  • 0 — there was no pending timeout event, or the SSL object is not a DTLS or QUIC object. no timeout, no problem.
  • -1 — there was a pending timeout event, but it could not be handled successfully. 😭 not the successful ending we wanted.

🔥 SEE ALSO 🔥

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 <https://www.openssl.org/source/license.html>.

okay that’s the page, bestie 🎀 — OpenSSL 3.5.0, dated 2026-09-25, 3ossl manual, signing off with kisses 💜 periodt.

📦 where this page comes from