NAME

       pinentry-gnome3 - PIN or pass-phrase entry dialog for GnuPG

SYNOPSIS

       pinentry-gnome3 [OPTION...]

DESCRIPTION

       pinentry-gnome3  is  a program that allows for secure entry of PINs or pass phrases.  That means it tries
       to take care that the entered information is not swapped to disk or temporarily  stored  anywhere.   This
       functionality  is  particularly  useful  for entering pass phrases when using encryption software such as
       GnuPG or e-mail clients using the same.  It uses an open protocol and is therefore not tied to particular
       software.

       pinentry-gnome3  implements  a  PIN  entry  dialog based on GNOME 3, which aims to follow the GNOME Human
       Interface Guidelines as closely as possible.  If the X Window System is not active  then  an  alternative
       text-mode dialog will be used.  There are other flavors that implement PIN entry dialogs using other tool
       kits.

       pinentry-gnome3 is typically used internally by gpg-agent.  Users don't normally have a reason to call it
       directly.

OPTIONS

       --version
              Print the program version and licensing information.

       --help Print a usage message summarizing the most useful command-line options.

       --debug, -d
              Turn  on  some debugging.  Mostly useful for the maintainers.  Note that this may reveal sensitive
              information like the entered pass phrase.

       --enhanced, -e
              Ask for timeouts and insurance, too.  Note that this is currently not fully supported.

       --no-global-grab, -g
              Grab the keyboard only when the window is focused.  Use this option if you are debugging  software
              using  pinentry-gnome3;  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-gnome3).

       --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.

       --display STRING, --ttyname STRING, --ttytype STRING, --lc-type STRING, --lc-messages STRING
              These  options  are  used  to pass localization information to pinentry-gnome3.  They are required
              because pinentry-gnome3 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.

SEE ALSO

       pinentry-curses(1), pinentry-gtk-2(1), pinentry-fltk(1), pinentry-qt(1),  pinentry-tty(1),  gpg(1),  gpg-
       agent(1)

       The  full  documentation  for  pinentry-gnome3  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.

AUTHOR

       This manual page was written by Daniel Kahn Gillmor for the Debian project, adapted from  other  pinentry
       manual pages written by Peter Eisentraut.

                                                   01 Jun 2015                                PINENTRY-GNOME3(1)