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.