DTLSV1_HANDLE_TIMEOUT(3ossl)

📦
version 3.5.9 · 8 versions
, in fedora 43, fedora 44

💅 DTLSV1_HANDLE_TIMEOUT 💅

okay bestie, gather round, because we're talking about DTLSv1_handle_timeout from the OpenSSL fam — manual section 3ossl, so you already know it's a library function and not some lil command-line thing. this is the one that deals with pending timeout events on a DTLS or QUIC SSL object. very "the clock is ticking and someone has to answer the door" energy. 🕰️✨

✨ NAME ✨

DTLSv1_handle_timeout — handle a pending timeout event for a DTLS or QUIC SSL object 🦋

🌸 SYNOPSIS 🌸

#include <openssl/ssl.h>

int DTLSv1_handle_timeout(SSL *ssl);

there she is. one include, one function call, one SSL *ssl and we're vibing. 💖

🎀 DESCRIPTION 🎀

so like, DTLSv1_handle_timeout() handles any timeout events which have become pending on a DTLS or QUIC SSL object. that's the whole job. it's giving "designated timekeeper of the friend group." 👑

and how do you know when to call her? bestie, that's what DTLSv1_get_timeout(3) and SSL_get_event_timeout(3) are for — they tell you when it's time to ring her up. no guessing, no "idk I'll just call it every 5 seconds and hope." we plan. we're organized. 💅

⚠️ important, no cap: this function is only applicable to DTLS or QUIC SSL objects. call it on any other kind of SSL object and it returns 0. she does not know those people. 🙈

alsooo, heads up: SSL_handle_events(3) supersedes all use cases for this function and may be used instead of it. so like, this one still works, but the newer girl handles everything she does. both iconic, just one's a bit more main character now. 🌈

🔥 RETURN VALUES 🔥

three possible outcomes, and honestly the range is real:

  • Returns 1 — yay! there was a pending timeout event and it was handled successfully. slay. ✅
  • Returns 0 — either there was no pending timeout event, or the SSL object is not a DTLS or QUIC object. basically "nothing to do here" or "wrong number, bestie." 💀
  • Returns -1 — oof 😭 there was a pending timeout event but it could not be handled successfully. she tried. it did not work. handle with care.

🦋 SEE ALSO 🦋

go read these too, they're all in the group chat:

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 whole page, bestie, you ate it 💖 this was OpenSSL version 3.5.9, dated 2026-09-29, and it lives in manual section 3ossl. go forth and handle those timeouts. periodt. 🎀🫶

📦 where this page comes from