NAME

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

SYNOPSIS

       pinentry-tty [OPTION...]

DESCRIPTION

       pinentry-tty  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-tty implements a PIN entry prompt directly on the controlling tty.  It has minimal dependencies,
       and a comparably minimal feature set.  It is useful for users  working  with  dumb  terminals  and  other
       similarly  constrained  environments.  There are other pinentry flavors that implement more user-friendly
       PIN entry dialogs, either in text mode with the curses toolkit, or using graphical X11 toolkits.   Please
       use one of the other flavors unless you know what you are doing.

       pinentry-tty  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-tty; 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-tty).

       --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-tty.   They  are  required
              because  pinentry-tty  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-gtk-2(1), pinentry-qt(1), pinentry-fltk(1), pinentry-gnome3(1), pinentry-curses(1), gpg(1), gpg-
       agent(1)

       The full documentation for pinentry-tty 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, derived from other pinentry
       manual pages written by Peter Eisentraut.

                                                   19 Apr 2015                                PINENTRY-CURSES(1)