PINENTRY-GTK-2(1)

📦
version 1.3.2 · 2 versions
  • 1.3.2 · debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute (latest)
  • 1.1.1 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute

💖 PINENTRY-GTK-2 💖

okay bestie, gather round, because we're about to talk about a lil program from the General Commands Manual section of your system, and it's genuinely iconic. it's called pinentry-gtk-2 and yes, the name is a mouthful, we'll get through it together 🫶

✨ NAME ✨

pinentry-gtk-2 — PIN or pass-phrase entry dialog for GnuPG 🌸

🎀 SYNOPSIS 🎀

pinentry-gtk-2 [OPTION...]

that's it. that's the whole vibe. options go in, dialog comes out 💅

🦋 DESCRIPTION 🦋

so like. pinentry-gtk-2 is a program that lets you securely type in PINs or pass phrases. and when I say securely, I mean it literally tries its absolute best to make sure the stuff you typed does not get swapped to disk or temporarily stored anywhere. no cap. that's the whole point.

this is especially useful when you're entering pass phrases while using encryption software like GnuPG, or email clients that use the same thing. and because it uses an open protocol, it is not tied to any particular software. free agent behavior, honestly 👑

pinentry-gtk-2 implements a PIN entry dialog using the GTK+ tool kit version 2, so it's especially suitable for users of GNOME. and here's the cute part: if the X Window System is not active, then an alternative text-mode dialog will be used instead. it always has a backup plan, we love a resilient queen ✨

there are other flavors that implement PIN entry dialogs using other tool kits. (they're in SEE ALSO, we'll get there, don't worry.)

and ngl, the biggest tea: pinentry-gtk-2 is typically used internally by gpg-agent. users don't normally have a reason to call it directly. so if you're here just to hang out, that's valid, but you probably don't need to invoke it yourself 🙈

💅 OPTIONS 💅

  • --version — prints the program version and licensing information. cute lil receipts moment 🧾
  • --help — prints a usage message summarizing the most useful command-line options. your bestie when you're lost ✨
  • --debug, -d — turns on some debugging. mostly useful for the maintainers.
⚠️ heads up bestie: this may reveal sensitive information like the entered pass phrase. so like, be careful with this one, fr fr 😭
  • --enhanced, -e — asks for timeouts and insurance, too. note that this is currently not fully supported. it's giving "coming soon" energy 💀
  • --no-global-grab, -g — grabs the keyboard only when the window is focused. use this option if you're debugging software using pinentry-gtk-2; otherwise you may not be able to to access your X session anymore (unless you have other means to connect to the machine to kill pinentry-gtk-2). yes that sentence really does say what you think it says. the keyboard grab is serious business 🔥
  • --parent-wid N — use window ID N as the parent window for positioning the window. note, that this is not fully supported by all flavors of pinentry. lowkey a suggestion more than a promise 🫶
  • --display STRING, --ttyname STRING, --ttytype STRING, --lc-ctype STRING, --lc-messages STRING — these options are used to pass localization information to pinentry-gtk-2. they're required because pinentry-gtk-2 is usually called by some background process which does not have any information on the locale and terminal to use. Assuan protocol options are an alternative way to pass these information. so basically: somebody's gotta tell this program where it is and what language to speak, and it's usually these guys 🌈

👑 SEE ALSO 👑

the full documentation for pinentry-gtk-2 is maintained as a Texinfo manual. if the pinentry-doc package is installed, the command

info pinentry

should give you access to the complete manual. go read it, it's giving scholar behavior 📚✨

🌸 AUTHOR 🌸

this manual page was written by Peter Eisentraut for the Debian project. thank you for your service, king 🫡💖

and that's the whole page bestie!! this one came from the General Commands Manual and it's dated 27 Jan 2005, so yeah, it's an elder but it still slays 💅✨ mwah, go type your pass phrase securely 🎀🦋💜

📦 where this page comes from