hcrypto_rsa(3)

💖 hcrypto_rsa(3) — Heimdal crypto library 💖

okay bestie, welcome to the RSA corner of the Heimdal crypto library ✨ this is hcrypto_rsa, and it's giving "let's handle RSA objects together" energy. no cap.

---

🎀 NAME 🎀

hcrypto_rsa — RSA functions 🦋

---

✨ SYNOPSIS ✨

the functions, slay 💅

RSA *RSA_new (void)
RSA *RSA_new_method (ENGINE *engine)
void RSA_free (RSA *rsa)
int RSA_up_ref (RSA *rsa)
const RSA_METHOD *RSA_get_method (const RSA *rsa)
int RSA_set_method (RSA *rsa, const RSA_METHOD *method)
int RSA_set_app_data (RSA *rsa, void *arg)
void *RSA_get_app_data (const RSA *rsa)

---

🌸 Detailed Description 🌸

lowkey just go look at RSA - public-key cryptography for the description and the examples, bestie — that's where the real tea is 💜

---

👑 Function Documentation 👑

💀 void RSA_free (RSA * rsa)

frees an allocated RSA object. it's done, it's over, we're releasing it 🫶

Parameters

• rsa — the RSA object to free.

---

🔍 void* RSA_get_app_data (const RSA * rsa)

gets the application data for the RSA object. it's literally right there, come get it ✨

Parameters

• rsa — the rsa object to get the parameter for

Returns

the data object

---

🧚 const RSA_METHOD* RSA_get_method (const RSA * rsa)

returns the RSA_METHOD used for this RSA object. iykyk, the method is the whole vibe 💅

Parameters

• rsa — the object to get the method from.

Returns

the method used for this RSA object.

---

⭐ RSA* RSA_new (void)

same as RSA_new_method() but using NULL as the engine. simple, iconic, no drama.

Returns

a newly allocated RSA object. free it with RSA_free() 🎀

---

🌈 RSA* RSA_new_method (ENGINE * engine)

allocates a new RSA object using the engine. if NULL is specified as the engine, it uses the default RSA engine as returned by ENGINE_get_default_RSA(). bestie said "default it is" and honestly? valid 💖

Parameters

• engine — specifies what ENGINE RSA provider should be used.

Returns

a newly allocated RSA object. free it with RSA_free() 🎀

---

🍓 int RSA_set_app_data (RSA * rsa, void * arg)

sets the application data for the RSA object. dropping your lil data object in there, so cute 🥰

Parameters

• rsa — the rsa object to set the parameter for
• arg — the data object to store

Returns

1 on success.

---

💜 int RSA_set_method (RSA * rsa, const RSA_METHOD * method)

sets a new method for the RSA keypair. glow-up for your RSA, periodt 🔥

Parameters

• rsa — rsa parameter.
• method — the new method for the RSA parameter.

Returns

1 on success.

---

🦋 int RSA_up_ref (RSA * rsa)

adds an extra reference to the RSA object. the object should be freed with RSA_free() to drop the reference — don't leave it hanging, bestie 😭

Parameters

• rsa — the object to add reference counting to.

Returns

the current reference count. ⚠️ heads up: it can't safely be used except for debug printing, so no funny business with it, okay?

---

✍️ Author ✍️

generated automatically by Doxygen for Heimdal crypto library from the source code. not me getting written by a robot 💀 iconic behavior fr fr.

---

and that's the whole page, bestie!! this was hcrypto_rsa from the Heimdal crypto library — Version 7.8.0, dated Tue Nov 15 2022. mwah, go free your RSA objects 🫶💖✨