shishi_authorize_strcmp(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 shishi_authorize_strcmp(3) 💖

okay bestie, so this is a page from the shishi manual — the GNU one, the Kerberos-adjacent cutie — and today we're doing shishi_authorize_strcmp, which is an API function. yes, an API function. nerd shit. we love it here. 🎀

✨ NAME ✨

shishi_authorize_strcmp — the API function that goes "are these two strings literally the same" and calls it authorization. simple. iconic. no cap.

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_authorize_strcmp(Shishi * handle, const char * principal,
       const char * authzname);

✨ ARGUMENTS ✨

  • Shishi * handle — the shishi handle, and it HAS to be one that got allocated by shishi_init(). like, that's the whole vibe. don't be passing random garbage in here fr fr.
  • const char * principal — a string holding the principal name you want. the desired one. the main character principal. 👑
  • const char * authzname — the authorization name. yes. that's the name. that's the one we're checking. 🦋

✨ DESCRIPTION ✨

so what this does is authorize authzname against the desired principal, according to "basic" authentication — which, lowkey, just means testing for identical strings. that's it. that's the whole thing. string equals string. if they match, congrats, you're authorized. if not, you're not. periodt 💅

it's giving "I have one job and I do it perfectly." not every function needs to be a whole dramatic saga, okay?

✨ RETURN VALUE ✨

  • 1 — returned if authzname is authorized for services by the encrypted principal 💖
  • 0 — returned otherwise. (yes, that means not authorized. sorry babe. 😭)

✨ REPORTING BUGS ✨

found a bug? do NOT just suffer in silence, bestie, that's not the move. report it to <bug-shishi@gnu.org>.

also here's the lore if you need it:

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. so like, go off, just keep the receipts. 🫶

✨ SEE ALSO ✨

the FULL documentation for shishi lives in a Texinfo manual (yes, a whole Texinfo manual, the way that it's maintained). if the info and shishi programs are properly installed at your site, this command:

info shishi

should give you access to the complete manual. go read it. it's right there. ✨

okay that's the page!! slay 💖 this was shishi version 1.0.3, from the shishi source, and it's the shishi_authorize_strcmp(3) page — thanks for coming to my ted talk, ily, drink some water 🌸🧚💜

📦 where this page comes from