shishi_des(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_des(3) ✨

okay bestie, welcome to the shishi manual, section 3 🎀 this one's about shishi_des — an API function, and yes it's giving cryptography main character energy 💅

🌸 NAME 🌸

shishi_des — it's an API function, bestie. that's the whole name. short, sweet, iconic. 👑

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_des(Shishi * handle, int decryptp, const char key[8], const
char iv[8], char * ivout[8], const char * in, size_t inlen, char **
out);

like. look at that signature. so many args. so much power. 😭✨

💖 ARGUMENTS 💖

  • Shishi * handle — your shishi handle, the one you got from shishi_init(). it's the whole vibe, you need it.
  • int decryptp — the direction switch 🔀. 0 means we're encrypting, non-0 means we're decrypting. that's it, that's the toggle.
  • const char key[8] — input character array holding the key you wanna use. 8 bytes of pure secret, no cap 🔐
  • const char iv[8] — input character array with the initialization vector to use, or NULL if you don't have one. your choice, bestie.
  • char * ivout[8] — output character array where the updated initialization vector lands, or NULL if you don't care. literally optional.
  • const char * in — input character array of the data you want to encrypt/decrypt. the actual tea ☕
  • size_t inlen — length of that input character array. gotta tell it how much, fr fr.
  • char ** out — newly allocated character array with the encrypted/decrypted data. newly allocated, so yes, you're responsible for it. 🙈

🌈 DESCRIPTION 🌈

so what does it DO. okay so: it encrypts or decrypts data (whichever one you asked for with decryptp) using DES in CBC mode. that's the whole thing. 💫

and listen — the out buffer must be deallocated by the caller. that means YOU. don't leave it hanging, that's a memory leak and we don't do that here. 🫶

⭐ RETURN VALUE ⭐

it returns SHISHI_OK iff successful. that's the only good outcome, bestie. anything else? not it. 💀

🐛 REPORTING BUGS 🐛

found a bug? (gasp 😭) report it to <bug-shishi@gnu.org>. like actually email them, they wanna know.

GNU Shishi home page: http://www.gnu.org/software/shishi/

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. so go forth, share the love, just keep the receipts 💖

🧚 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. iykyk 📖✨

and that's the whole page, bestie!! this was shishi version 1.0.3, and the page is shishi_des(3) — dated like that, forever iconic. slay, stay encrypted, deallocate your buffers 💅🌸🦋

📦 where this page comes from