gnutls_cipher_encrypt2(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_encrypt2(3) 💖

okay bestie, so this one lives in the gnutls manual, and it's the glow-up version of encrypting your data. sit down, hydrate, let's go 🫶

✨ NAME ✨

gnutls_cipher_encrypt2 — it's an API function, periodt 💅

🌸 SYNOPSIS 🌸

#include <gnutls/crypto.h>

int gnutls_cipher_encrypt2(gnutls_cipher_hd_t handle, const void *
ptext, size_t ptext_len, void * ctext, size_t ctext_len);

like, look at her. she's a function signature and she's serving 😌

🎀 ARGUMENTS 🎀

  • gnutls_cipher_hd_t handle — bestie this is literally just a gnutls_cipher_hd_t type. that's the whole vibe of it.
  • const void * ptext — the data you wanna encrypt. your lil secret. 🤫
  • size_t ptext_len — how much data you're encrypting, in length form. count it, don't guess it.
  • size_t ptext_len... wait no, it's size_t ctext_len — the available length for the encrypted data. it's giving "how much room do we have for the glow-up" 🦋
  • void * ctext — the encrypted data goes here. the after pic. ✨

ngl the order in the original is handle, ptext, ptext_len, ctext, ctext_len — keep that energy, don't shuffle it 🙈

💜 DESCRIPTION 💜

so what does she do? she encrypts the given data using the algorithm specified by the context. that's it, that's the job, and she ate 💅

but — and this is the important part, no cap — for block ciphers, ptext_len must be a multiple of the block size. like, non-negotiable. do not come in here with a weird length and expect things to be cute. 😭

and for the supported ciphers, the encrypted data length will equal the plaintext size. so it's not gonna puff up or shrink on you. the way that's so reassuring fr fr 💖

⭐ RETURNS ⭐

zero. or a negative error code if something went wrong. so like, 0 = slay, negative = not slay, go check your error handling bestie 🔥

🌈 SINCE 🌈

2.12.0 — she's been iconic since way back, iykyk 👑

🦋 REPORTING BUGS 🦋

found a bug? don't suffer in silence, tell the girlies:

seriously, report it. bugs don't fix themselves and we are NOT about that silent-struggle life 🫶

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 receipts 🎀

👑 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/

and that's the whole page bestie, we're done here 🌸✨

🧚 this has been the gnutls manual, version 3.8.13, page gnutls_cipher_encrypt2(3). go encrypt something responsibly, mwah 💜
📦 where this page comes from