/home/abui.../aes_cbc.h(3)

📦 version 1.5.0, in opensuse-leap 16.0

💅 /home/abui.../aes_cbc.h(3) — Library Functions Manual

okay so bestie, welcome to the AES-CBC page 🎀 this is from the /home/abui.../aes_cbc.h(3) manual, and we're about to get very cozy with some block cipher functions. no cap.

✨ NAME ✨

/home/abuild/rpmbuild/BUILD/libzpc-legacy-1.5.0-build/libzpc-1.5.0/include/zpc/aes_cbc.h — the AES-CBC API. that's the whole vibe. it's giving "header file that knows exactly what it is." 🦋

🌸 SYNOPSIS 🌸

Functions

here's the whole squad — every single one of them, no cuts:

int zpc_aes_cbc_alloc (struct zpc_aes_cbc **ctx)
int zpc_aes_cbc_set_key (struct zpc_aes_cbc *ctx, struct zpc_aes_key *key)
int zpc_aes_cbc_set_iv (struct zpc_aes_cbc *ctx, const unsigned char *iv)
int zpc_aes_cbc_get_intermediate_iv (struct zpc_aes_cbc *ctx, unsigned char iv[16])
int zpc_aes_cbc_set_intermediate_iv (struct zpc_aes_cbc *ctx, const unsigned char iv[16])
int zpc_aes_cbc_encrypt (struct zpc_aes_cbc *ctx, unsigned char *ct, const unsigned char *pt, size_t ptlen)
int zpc_aes_cbc_decrypt (struct zpc_aes_cbc *ctx, unsigned char *pt, const unsigned char *ct, size_t ctlen)
void zpc_aes_cbc_free (struct zpc_aes_cbc **ctx)

💜 Detailed Description 💜

AES-CBC API. literally the entire subtitle. 💅

so this is the encryption API for the Advanced Encryption Standard (AES) block cipher [1], operating in Cipher Block Chaining (CBC) mode of operation [8]. that's the tea ☕ — AES, but chained, bestie.

Definition in file aes_cbc.h. that's where it lives, that's where it eats. 🍓

👑 Function Documentation 👑

💖 int zpc_aes_cbc_alloc (struct zpc_aes_cbc ** ctx)

allocate a shiny new context for an AES-CBC operation ✨ fresh out the box, main character energy.

Parameters

  • ctx — AES-CBC context

Returns

0 on success. otherwise, a non-zero error code is returned. (so like, check it, bestie. don't just assume. 😭)

🦋 int zpc_aes_cbc_set_key (struct zpc_aes_cbc * ctx, struct zpc_aes_key * key)

set the key to be used in the context of an AES-CBC operation. the key!! the most important part!! 🔥

Parameters

  • ctx — AES-CBC context
  • key — AES key

Returns

0 on success. otherwise, a non-zero error code is returned.

🌈 int zpc_aes_cbc_set_iv (struct zpc_aes_cbc * ctx, const unsigned char * iv)

set the initialization vector to be used in the context of an AES-CBC operation. yes bestie, CBC needs an IV, this is not optional, this is the whole point of chaining 💀

Parameters

  • ctx — AES-CBC context
  • iv — 16 byte initialization vector

Returns

0 on success. otherwise, a non-zero error code is returned.

🧚 int zpc_aes_cbc_get_intermediate_iv (struct zpc_aes_cbc * ctx, unsigned char iv[16])

get the intermediate initialization vector to be used in the context of an AES-CBC operation. peek at it. read it. it's yours now 👀

Parameters

  • ctx — AES-CBC context
  • iv — application provided buffer with 16 bytes size to receive the 16 byte intermediate iv — so you bring the buffer, and it must be 16 bytes, okurrr 🎀

Returns

0 on success. otherwise, a non-zero error code is returned.

⭐ int zpc_aes_cbc_set_intermediate_iv (struct zpc_aes_cbc * ctx, const unsigned char iv[16])

set the intermediate initialization vector to be used in the context of an AES-CBC operation.

🚨 important bestie: an initial iv must be set before via zpc_aes_cbc_set_iv. like, do that first. order matters. no skipping steps 🙈

Parameters

  • ctx — AES-CBC context
  • iv — 16 byte intermediate iv

Returns

0 on success. otherwise, a non-zero error code is returned.

🔥 int zpc_aes_cbc_encrypt (struct zpc_aes_cbc * ctx, unsigned char * ct, const unsigned char * pt, size_t ptlen)

do an AES-CBC encryption operation. turn that plaintext into ciphertext, slay 💅✨

Parameters

  • ctx — AES-CBC context
  • ct — ciphertext
  • pt — plaintext
  • ptlen — plaintext length [bytes]

Returns

0 on success. otherwise, a non-zero error code is returned.

🫶 int zpc_aes_cbc_decrypt (struct zpc_aes_cbc * ctx, unsigned char * pt, const unsigned char * ct, size_t ctlen)

do an AES-CBC decryption operation. the reverse slay. ciphertext goes in, plaintext comes out 🌸

Parameters

  • ctx — AES-CBC context
  • pt — plaintext
  • ct — ciphertext
  • ctlen — ciphertext length [bytes]

Returns

0 on success. otherwise, a non-zero error code is returned.

🎀 void zpc_aes_cbc_free (struct zpc_aes_cbc ** ctx)

free an AES-CBC context. clean up after yourself, bestie — leaving contexts lying around is not the move 😭🧹

Parameters

  • ctx — AES-CBC context

🌟 Author 🌟

generated automatically by Doxygen for libzpc from the source code. not a human, just a very diligent robot 🧚‍♀️

and that's the page!! hope you had fun, iykyk 💖

libzpc · Version 1.4 · /home/abui.../aes_cbc.h(3) — ok bye bestie, go encrypt something iconic 👑💜
📦 where this page comes from