LC_KEYPAIR_NEW(3)

💖 lc_keypair_new(3) — the Librecast Programmer's Manual glow-up 💖

okay bestie, sit down, hydrate, because we're about to make you a whole entire keypair ✨ this one lives in section 3 of the Librecast Programmer's Manual, so you already know it's the good stuff.

---

🌸 NAME 🌸

lc_keypair_new — create new keypair

like. that's it. that's the whole job. she makes keys. iconic behavior honestly 🎀

---

🦋 LIBRARY 🦋

Librecast library (liblibrecast, -llibrecast)

---

✨ SYNOPSIS ✨

#include <librecast/key.h>

int lc_keypair_new(lc_keypair_t *keypair, int flags);

Compile and link with -llibrecast.

not the linker forgetting your library again 😭 we've all been there, add that flag fr fr

---

👑 DESCRIPTION 👑

okay so here's the tea: lc_keypair_new() creates a new signing or encryption keypair. brand new. fresh out the box. main character energy 💅

The new keypair will be returned in keypair.

flags can be any of the following:

• LC_KEY_SIG — Generate a signing keypair. 🔥
• LC_KEY_ENC — Generate an encryption keypair. 🔐

pick your fighter bestie, you gotta tell her which kind of keypair you want. that's literally the whole decision. slay.

---

🫶 RETURN VALUE 🫶

lc_keypair_new() returns 0 if the call succeeds, or -1 if an error occurred. In the event of an error, errno is set to indicate the error.

so like, 0 = we ate. -1 = check errno, she's telling you what went wrong 🧚

---

💀 ERRORS 💀

lc_keypair_new() can fail with the following errors:

• EINVAL — Key generation failed.

not the key generation ghosting us 🙈 if you see EINVAL, the generation itself did not happen. no keypair for you, bestie.

---

🌈 SEE ALSO 🌈

lc_keyring_init(3), lc_keyring_free(3), lc_keyring_add(3), lc_keyring_del(3), lc_token_new(3)

go read these next, they're the rest of the friend group 💜

---

and that's the page!! brought to you by LIBRECAST, dated 2025-04-02, filed under LC_KEYPAIR_NEW(3) — go forth and generate responsibly, bestie, ily 🎀✨💖