shisa_principal_add(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

✨ shisa_principal_add ✨

okay bestie, welcome to the shishi manual, section 3 💅 this one's a function, and it's literally called shisa_principal_add — yes, that's the whole vibe.

🌸 NAME 🌸

shisa_principal_add — an API function 🎀 (she's a function, she does API things, that's the whole name, no notes)

🦋 SYNOPSIS 🦋

#include <shisa.h>

int shisa_principal_add(Shisa * dbh, const char * realm, const char *
principal, const Shisa_principal * ph, const Shisa_key * key);

💖 ARGUMENTS 💖

  • Shisa * dbh — your Shisa library handle, the one you got from shisa(). she's your girl, hold onto her 🫶
  • const char * realm — the name of the realm that this principal belongs to.
  • const char * principal — the name of the principal you wanna add. and listen, plot twist: if you set this to NULL, then only the realm realm gets created. that's it. that's the whole job.
  • const Shisa_principal * ph — a pointer to a principal structure, holding all the info you want stored in the database.
  • const Shisa_key * key — a pointer to a key structure, with the info you want stored in the database.

🌈 DESCRIPTION 🌈

She inserts the info you handed her into the database for the principal PRINCIPAL@REALM ✨

and if principal is NULL? then ph and key don't get used at all — literally not touched — so the only thing getting added to the database is the realm. that's the whole behavior, no cap 💅

⭐ RETURN VALUE ⭐

Returns SHISA_OK if everything got added successfully 🎉 or an error code otherwise (in which case, bestie, something went sideways 😭).

🙈 REPORTING BUGS 🙈

Report bugs to <bug-shishi@gnu.org>. GNU Shishi home page: http://www.gnu.org/software/shishi/ — and for general help using GNU software: http://www.gnu.org/gethelp/ 🐛

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. (slay, that's a very chill license fr fr 💜)

🧚 SEE ALSO 🧚

The full documentation for shishi is maintained as a Texinfo manual. If the info and shishi programs are properly installed at your site, the command

info shishi

should give you access to the complete manual. go read it, it's giving main character energy 📚✨

and that's a wrap on shisa_principal_add(3) from the shishi manual, version 1.0.3 — thanks for reading, bestie, go add some principals 💅🎀🦋

📦 where this page comes from