rc_check(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(3) 💖

okay so bestie, we're in the Radius client library (radcli) and today's main character is rc_check. she's a (3) — a library function, iykyk — and she is literally the vibe-check girl for your RADIUS server. let's get into it 🌸

✨ NAME ✨

rc_check — and that's it. the description line in the original is blank, no cap. iconic minimalism, she said nothing and left. 🎀

🦋 SYNOPSIS 🦋

#include <radcli/radcli.h>

int rc_check(
    rc_handle     *rh,
    char          *host,
    char          *secret,
    unsigned short port,
    char          *msg
);

🌈 DESCRIPTION 🌈

so what does she do? she asks the server hostname on the specified port for a status message. that's the whole plot. she knocks on the door, she says "hey bestie, status?", and she comes back with whatever the server hands over. lowkey iconic, highkey useful. 💅

🍓 PARAMETERS 🍓

  • rh — a handle to parsed configuration. your whole setup lives in here, she's the main character energy of the arg list. 👑
  • host — the name of the server. who we're calling. ✨
  • secret — the secret used by the server. yes it's a secret, no we don't gossip about it. 🙈
  • port — the server's port number. unsigned short, so mind your range, bestie. 🔥
  • msg — must be an array of PW_MAX_MSG_SIZE or NULL; will contain the concatenation of any PW_REPLY_MESSAGE received. so if you pass a buffer, she's gonna fill it, and everything the server said back gets glued together in there. if you pass NULL, you get nothing back — no notes, that's the deal. 💖

⭐ RETURN VALUE ⭐

OK_RC (0) on success, negative on failure as return value.

so: 0 means slay, anything negative means not slay. periodt. 😭

🧚 SEE ALSO 🧚

bestie, this list is long. she's got a whole group chat and everyone's invited. no skipping, we're listing every single one: 💜

(yes, rc_check(3) is in her own SEE ALSO list. self-love. we stan. 💅)

reminder bestie: every flag, every param, every number stayed exactly where it was. the vibe is new, the facts are untouched. no cap. 🫶

and that's the page!! brought to you by radcli, dated 2023-01-29, closing out with rc_check(3) — she said status message, she said OK_RC, she said bye. mwah. 💖✨🎀🦋🌸

📦 where this page comes from