GPGME-TOOL(1)

💖 GPGME-TOOL 💖

okay bestie, this is the manual page for gpgme-tool, from the User Commands corner of the world. she's a little test gremlin, but we love her. let's go 🫶

---

✨ NAME ✨

gpgme-tool — an Assuan server that exposes GnuPG Made Easy operations 👑

---

✨ SYNOPSIS ✨

gpgme-tool [--server|-s] [--gpgme-binary=FILE] [--lib-version] [--usage]
[--version|-V] [--help|-?]

---

✨ DESCRIPTION ✨

so gpgme-tool is a test interface — its whole job is to exercise the library functionality of GPGME. she is not currently intended for production use, okay? do not deploy her to prod, bestie, I am begging 😭. but she is genuinely a super useful way to dynamically understand and experiment with the functionality available from the library. like, a little playground. a sandbox. a vibe 🦋

If you run this tool in Server mode (which is the default mode, the one she wakes up in), you get a text-based, command-driven session. Here's the rhythm: when the tool produces — on its standard output — a line beginning with OK or ERR, that's your cue, and you can hand it a command on its standard input. 🎀

try the command HELP to see a list of available commands. the way that commands are case-insensitive?? iconic. type in caps, type in lowercase, she does not care 💅

also, quick cheat sheet so you don't get confused mid-session:

• Status lines begin with an S
• Data lines begin with a D

that's it. that's the whole code. ✨

---

✨ OPTIONS ✨

gpgme-tool accepts the following options on the command line:

OPTIONS

• -s, --server — Server mode (this is the default, so like, if you do nothing, you're already here 💖)
• --gpg-binary=FILE — Use FILE for the GPG backend
• --lib-version — Show the library version and terminate (she says her piece and dips 👋)
• -V, --version — Print the currently installed version of GPGME to standard output.
• -?, --help — Print a list of command-line options.
• --usage — Print a synopsis of gpgme-tool's command line.

---

✨ EXAMPLE ✨

okay here's an actual interaction from a POSIX shell 🍓 — the lines you type are in italics, and the data that gpgme-tool hands back is in bold:

user@host:~$ gpgme-tool
OK GPGME-Tool 1.7.0 ready
strerror 20
D Unknown compression algorithm <Unspecified source>
OK
version
D 1.7.0
OK
armor
S ARMOR false
OK
armor true
OK
armor
S ARMOR true
OK
bye
OK closing connection
user@host:~$

see how she just talks back?? main character energy fr fr 🔥

---

✨ AUTHORS ✨

The GPGME library is written by many contributors, including Werner Koch, Marcus Brinkmann, Andre Heinecke, Justus Winter, and Karl-Heinz Zimmer. 🫶 legends, all of them.

This manual page page was written by Daniel Kahn Gillmor for the Debian distribution (but may be used by others). yes, the original says "manual page page" and honestly? we're keeping it. it's canon now. 💀

---

✨ BUGS ✨

Please report bugs to <https://bugs.gnupg.org>. 🙈

---

✨ COPYRIGHT ✨

gpgme-tool is Copyright © 2015-2016 g10 Code GmbH — License GPLv2+: GNU GPL version 2 or later <https://www.gnu.org/licenses/>

This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. 🧚

---

✨ SEE ALSO ✨

gpgme-config(1), /usr/include/gpgme.h, info gpgme 💜

---

and that's the whole page, bestie!! this was gpgme-tool version 1.7.0, dated September 2016, and the page itself is GPGME-TOOL(1). slay, go forth and experiment responsibly 💅✨🌈