libcanlock(3)

📦
version 3.3.3 · 3 versions
, in epel 10

💅 libcanlock — the cl_split era 💅

okay so real talk, this whole page is about libcanlock (version 3.3.3 manual, bestie, write that down) and specifically about one little function that does one little job and does it flawlessly. no cap.

✨ NAME ✨

cl_split — splits a Cancel-Key or Cancel-Lock, with libcanlock doing the heavy lifting 🫶

🌸 SYNOPSIS 🌸

#include <libcanlock-3/canlock.h>

cl_hash_version cl_split(char *input, char **klstring);

and the possible return values, straight from version 3.0.0 of libcanlock, no edits:

CL_INVALID CL_SHA1 CL_SHA224 CL_SHA256 CL_SHA384 CL_SHA512

like. look at that lineup. iconic. 👑

🦋 DESCRIPTION 🦋

so cl_split() takes a <c-key> or a <c-lock> element and splits it, exactly per RFC 8315. that's the whole gig. it's giving "one job, done right."

what happens is: the hash algorithm for <scheme> gets extracted out, and the matching ID for it gets returned. slay. 💅

but bestie, listen — if that hash algorithm is not found or not supported, you get CL_INVALID back. no exceptions. that's the vibe check failing, sorry.

on success, a pointer to the <c-key-string> or <c-lock-string> element (whichever one applies) gets written to klstring. and here's the cute part: that pointer points inside the string input, so no additional memory is allocated at all. zero. none. it's just pointing at what's already there, which is honestly so efficient of it. 🧚

on error? NULL gets written to klstring. that's it. that's the whole story. 😭

⭐ RETURN VALUE ⭐

the hash algorithm ID. and on error, CL_INVALID. periodt. 🔥

🎀 AUTHORS 🎀

Michael Baeuerle 💖

(based in part on lock_strip_alpha() written by G. J. Andruk for Version 2 — shoutout to the ancestors, fr fr 🫡)

🙈 REPORTING BUGS 🙈

found a bug? report it to <mailto:michael.baeuerle@gmx.net>. be nice about it, bestie. 💀

🌈 STANDARDS 🌈

libcanlock tries to comply with these, and honestly? it ate:

🔥 SEE ALSO 🔥

the whole friend group:

and that's the page!! 💜 this was the libcanlock 3.3.3 manual, dated 2026-07-06, brought to you by Unix — mwah, go split some elements responsibly, ily 🍓✨

📦 where this page comes from