pinentry: Using pinentry

1 
1 1 How to use the PINENTRY
1 *************************
1 
1 You may run PINENTRY directly from the command line and pass the
1 commands according to the Assuan protocol via stdin/stdout.
1 
1    Here is a list of options supported by all flavors of pinentry:
1 
1 '--version'
1      Print the program version and licensing information.
1 
1 '--help'
1      Print a usage message summarizing the most useful command line
1      options.
1 
1 '--debug'
1 '-d'
1      Turn on some debugging.  Mostly useful for the maintainers.  Note
1      that this may reveal sensitive information like the entered
1      passphrase.
1 
1 '--no-global-grab'
1 '-g'
1      Grab the keyboard only when the window is focused.  Use this option
1      if you are debugging software using the PINENTRY; otherwise you may
1      not be able to to access your X session anymore (unless you have
1      other means to connect to the machine to kill the PINENTRY).
1 
1 '--parent-wid N'
1      Use window ID N as the parent window for positioning the window.
1      Note, that this is not fully supported by all flavors of PINENTRY.
1 
1 '--timeout SECONDS'
1      Give up waiting for input from the user after the specified number
1      of seconds and return an error.  The error returned is the same as
1      if the Cancel button was selected.  To disable the timeout and wait
1      indefinitely, set this to 0, which is the default.
1 
1 '--display STRING'
1 '--ttyname STRING'
1 '--ttytype STRING'
1 '--lc-ctype STRING'
1 '--lc-messages STRING'
1      These options are used to pass localization information to
1      PINENTRY.  They are required because PINENTRY is usually called by
1      some background process which does not have any information about
1      the locale and terminal to use.  It is also possible to pass these
1      options using Assuan protocol options.
1