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