rc_check_tls(3)

📦
version 1.5.2 · 4 versions
, in alpine 3.24, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💖 rc_check_tls — the manual, but make it a vibe 💖

okay bestie, buckle up, we're looking at rc_check_tls(3) from the Radius client library — yes, the whole library, she's iconic like that. 🌈

✨ NAME ✨

rc_check_tls — and literally nothing else. no description. the manpage left it blank, so we're all just gonna have to keep reading like the main characters we are. 💅

🌸 SYNOPSIS 🌸

#include <radcli/radcli.h>

int rc_check_tls(
    rc_handle  *rh
);

look at her. one handle, one function call, zero drama. 😌

🦋 DESCRIPTION 🦋

so what does she do? she checks your established TLS/DTLS channels and makes sure they're actually operational. 🫶

this function will check whether the channel(s) established for TLS or DTLS are operational, and it will re-establish the channel if necessary. so if a connection ghosted you, she goes and gets it back. obsessed.

⚠️ but listen — if this function fails, then the TLS or DTLS state should be considered as disconnected. no cap. that's the whole mood. 💀

also, you have to call it at a time when the sessions are not in usage — like, in a different thread. don't be calling her mid-conversation, she needs the room to herself. 🙈

🎀 note: it is recommended to run this function periodically if you have a DTLS channel, because an undetected server reset may result to a black hole behavior of the server. yes, actual black hole. not metaphor. run it on a schedule, bestie, fr fr. 🕳️

💜 PARAMETERS 💜

  • rh — a handle to parsed configuration. that's it. that's the whole parameter. she's low-maintenance. 👑

⭐ RETURN VALUE ⭐

  • 0 on success ✨ (slay)
  • -1 on error 😭 (not slay)

🔥 SEE ALSO 🔥

the whole friend group, in order, no one left out, periodt:

and that's the whole page, babe. 💖 brought to you by radcli, dated 2023-01-29 — go forth, check your TLS, and stay operational. 🧚✨

📦 where this page comes from