gnutls_cipher_init(3)

📦
version 3.8.13 · 7 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, fedora 43, fedora 44, ubuntu stonking

✨ gnutls_cipher_init ✨

okay bestie, welcome to the gnutls manual page for gnutls_cipher_init(3) 💖 this is the one where we set up a whole encryption vibe, so grab a boba and let's get into it 🧋✨

🌸 NAME 🌸

gnutls_cipher_init — literally an API function, that's the whole name, periodt 💅

🦋 SYNOPSIS 🦋

#include <gnutls/crypto.h>

int gnutls_cipher_init(gnutls_cipher_hd_t * handle,
gnutls_cipher_algorithm_t cipher, const gnutls_datum_t * key, const
gnutls_datum_t * iv);

no cap, that's the exact signature, copy it character for character or the compiler will simply not 💀

🎀 ARGUMENTS 🎀

  • gnutls_cipher_hd_t * handle — bestie this is a gnutls_cipher_hd_t type, that's it, that's the whole description 🫶
  • gnutls_cipher_algorithm_t cipher — the encryption algorithm you wanna use, like the outfit you're picking for the function 👑
  • const gnutls_datum_t * key — the key that gets used for encryption/decryption 🔐 the main character of the whole operation fr fr
  • const gnutls_datum_t * iv — the IV to use, and lowkey important: if it's not applicable you set it to NULL 🙈

💜 DESCRIPTION 💜

so this function will initialize the handle context to be usable for encryption/decryption of data ✨ it's giving "get ready for the glow-up" energy.

and the way that it works? it will effectively use the current crypto backend in use by gnutls, or the cryptographic accelerator in use 🔥 so whichever backend is on deck, that's the one doing the math, iykyk.

🌈 RETURNS 🌈

Zero, or a negative error code on error 😭 so if you get zero you ate, and if you get a negative number... not me ignoring it, please check it bestie 💀

⭐ SINCE ⭐

2.10.0 — this icon has been iconic since way back, no notes 👑

🐛 REPORTING BUGS 🐛

Found a bug? spill, but to the right place: report bugs to <bugs@gnutls.org> 📧

Home page: https://www.gnutls.org 🏠

Copyright © 2001-2023 Free Software Foundation, Inc., and others. 💖

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 receipt 🧾

👀 SEE ALSO 👀

The full documentation for gnutls is maintained as a Texinfo manual 📚 If the /usr/share/doc/gnutls/ directory does not contain the HTML form, visit

https://www.gnutls.org/manual/
fr fr, that's the whole page — nothing skipped, nothing summarised, every flag, value, path and link is right there where it belongs 💅

okay bye bestie, this was the gnutls manual, version 3.8.13, and this page is gnutls_cipher_init(3) 🦋 go forth and encrypt responsibly, mwah 💖✨🌸

📦 where this page comes from