pinentry: Using pinentry

 
 1 How to use the PINENTRY
 *************************
 
 You may run PINENTRY directly from the command line and pass the
 commands according to the Assuan protocol via stdin/stdout.
 
    Here is a list of options supported by all flavors of pinentry:
 
 '--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
      passphrase.
 
 '--no-global-grab'
 '-g'
      Grab the keyboard only when the window is focused.  Use this option
      if you are debugging software using the PINENTRY; 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 the PINENTRY).
 
 '--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.
 
 '--timeout SECONDS'
      Give up waiting for input from the user after the specified number
      of seconds and return an error.  The error returned is the same as
      if the Cancel button was selected.  To disable the timeout and wait
      indefinitely, set this to 0, which is the default.
 
 '--display STRING'
 '--ttyname STRING'
 '--ttytype STRING'
 '--lc-ctype STRING'
 '--lc-messages STRING'
      These options are used to pass localization information to
      PINENTRY.  They are required because PINENTRY is usually called by
      some background process which does not have any information about
      the locale and terminal to use.  It is also possible to pass these
      options using Assuan protocol options.