LIBRNP(3)

📦
version 0.18.1 · 14 versions
, in ubuntu stonking

💖 LIBRNP 💖 (that's the librnp page from section 3, bestie)

okay so picture this: you wanna do OpenPGP stuff in your own code, not just in the terminal. that's librnp. she's the library. she's the blueprint. she's the moment. 🎀

✨ NAME ✨

librnp — OpenPGP implementation, available via FFI interface.

✨ SYNOPSIS ✨

#include <rnp/rnp.h>
#include <rnp/rnp_err.h>

✨ DESCRIPTION ✨

so librnp is part of the RNP suite (iykyk) and she's literally the foundation under rnp(1) and rnpkeys(1), those command-line utilities you've probably already met. main character supporting cast energy, honestly. 👑

what she gives you is an FFI interface to the functions you need for the operations the OpenPGP protocol requires. no cap.

you get at all of that through two headers: <rnp/rnp.h> and <rnp/rnp_err.h>. and yeah, you're also gonna need to link against librnp. can't skip that step, bestie, that's the whole point. 💅

and like… go read the headers?? for real?? that's where the full function list lives and where the detailed documentation is. we're not gonna retype the entire API here, that would be unhinged. 🙈

🧚 EXAMPLES 🧚

there are a bunch of example files chilling in the src/examples folder of the RNP suite source tree. they're giving "study the source, become the source." 🌸

  • generate.c — shows you how to generate an OpenPGP keypair using the JSON key description mechanism. lowkey the cool part: you can use it to generate any custom key types that the RNP suite supports.
  • encrypt.c — demonstrates how to build OpenPGP-encrypted messages. the message gets encrypted with keys generated via ./generate, and there's a hardcoded password in there. iconic, simple, works.
  • decrypt.c — demonstrates how to decrypt OpenPGP messages. heads up though: to run this one you gotta run the ./encrypt example first, because that's what produces the sample encrypted message you're decrypting. order matters, babe. ✨
  • sign.c — demonstrates how to sign OpenPGP messages. and again with the prerequisites: run the ./generate example first so the secret keys actually exist and get written out.
  • verify.c — demonstrates verify OpenPGP signed messages (yes that's the original phrasing, she contains multitudes). once more: run the ./sign example first, because that's what generates the signed OpenPGP message you're verifying.
ngl the whole examples folder is a pipeline. generate → encrypt → decrypt, generate → sign → verify. run em in order or they'll just be sad and empty. 🥺

💀 BUGS 💀

found something broken? please report issues via the RNP public issue tracker at: https://github.com/rnpgp/rnp/issues.

and if it's a security report or security-sensitive feedback — like, actual danger vibes — those go through the instructions at: https://www.rnpgp.org/feedback. don't put those in the public tracker, bestie, that's not the vibe. 🔥

🌈 AUTHORS 🌈

RNP is an open source project led by Ribose, and it has received contributions from numerous individuals and organizations. group project but everyone actually showed up. slay. 🫶

⭐ RESOURCES ⭐

👑 COPYING 👑

Copyright (C) 2017-2021 Ribose. The RNP software suite is freely licensed: please refer to the LICENSE file for details.

like, actually go read the LICENSE file. it's right there. it's free and it's detailed. 🎀

🌸 SEE ALSO 🌸

rnp(1), rnpkeys(1)

🦋 AUTHOR 🦋

RNP

and that's the whole page, bestie!! 💖 this was RNP version 0.18.1, dated 2026-06-12, living in the RNP Manual, section 3, LIBRNP(3) — go forth and link against her, she's literally so good. ✨💅

📦 where this page comes from