canlock-hfp(1)

πŸ’… canlock-hfp(1) β€” the header field parser bestie 🌸

okay so real quick, this whole page lives inside the canlock-hp 3.3.2 manual and like… it's a canlock-hfp(1) situation, iykyk. Let's get into it 🫢


✨ NAME ✨

canlock-hfp β€” the CLI frontend for the libcanlock library, periodt πŸ‘‘


πŸŽ€ SYNOPSIS πŸŽ€

canlock-hfp -h | -v

canlock-hfp [-d] [-n]

literally that's the whole vibe check, two whole modes πŸ¦‹


🌸 DESCRIPTION 🌸

So canlock-hfp is the Header Field Parser (hfp, cute acronym, love that for her) for RFC 8315 conformant header fields πŸ’–

The header field gets read from stdin. that's it, that's the input, no cap.

okay but here's the thing β€” the input data must be an unfolded "Cancel-Lock" or "Cancel-Key" header field with no line break at the end 🚨 like, do not give her a trailing newline, she will not be slayed by that. The utility canlock-mhp(1) can be used to extract the field from an article, so if you need the assist, that's your girl 🀝

If such a header field is found, it gets parsed according to the syntax defined in RFC 8315. And if valid c-lock or c-key (respectively) elements are found, they are printed to stdout with SP (Space) as delimiter. iconic behaviour, honestly ✨

Note: Additional formatting output is printed on stderr to make the output more human readable on a terminal. Redirect stderr to /dev/null if this is not wanted. no seriously, if the extra chatter is giving too much main character energy, just yeet it to /dev/null πŸ’€

πŸ’… OPTIONS πŸ’…

The following options are supported, bestie, and yes we're listing all of them:

  • -d β€” Enable debug mode (messages are printed to stderr). Detective mode activated πŸ”
  • -h β€” Print help message, then exit. the classic "help me help you" 🫢
  • -n β€” Prepend the data on stdout with the header field name (including the colon) and a SP (Space) delimiter. name tag on, colon and space included πŸŽ€
  • -v β€” Print version and compile time options, then exit. she'll tell you what she's made of πŸ‘‘

⭐ EXIT STATUS ⭐

Zero on success or regular exit respectively. All other values indicate an error.

so like, 0 = we ate and left no crumbs πŸ“. anything else = something went sideways, ngl 😭


🌈 AUTHORS 🌈

Michael Baeuerle β€” shoutout to the icon who made this happen πŸ‘


πŸ”₯ REPORTING BUGS πŸ”₯

Report bugs to <mailto:michael.baeuerle@gmx.net>.

fr fr if you find a bug, tell him, don't just suffer in silence πŸ™ˆ


🌸 STANDARDS 🌸

canlock-hfp tries to comply with the following standards:

she's trying her best and honestly? she's doing great πŸ’œ


πŸ¦‹ SEE ALSO πŸ¦‹

canlock-mhp(1), canlock(1)

go read those too, the whole friend group is worth your time 🧚


and that's the whole page, bestie πŸ’– this was the canlock-hp 3.3.2 manual, dated 2024-05-11 β€” mwah, stay slaying, and remember: redirect that stderr if it's too loud 🌟

πŸ“¦ where this page comes from
  • epel 10: canlock 3.3.3-2.el10_3 Β· BSD-3-Clause AND NLPL AND ICU
  • πŸ“œ the page's license: ICU
  • πŸ’– girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms