diff options
| author | Koni Marti <koni.marti@gmail.com> | 2024-08-06 22:37:28 +0200 |
|---|---|---|
| committer | Robin Jarry <robin@jarry.cc> | 2024-10-12 00:12:25 +0200 |
| commit | 163ea3ec7d2af3bac1afe6489071a8a286f282b8 (patch) | |
| tree | 7f018a3910b373d374786eaceaadabe806ce4fbb /doc | |
| parent | bc8698e1f088cf144a797d2d0b8f875138a79967 (diff) | |
| download | aerc-163ea3ec7d2af3bac1afe6489071a8a286f282b8.tar.gz | |
aerc: support terminal-based pinentry programs
Support terminal-based pinentry programs. Suspend vaxis before running
the command that can trigger a pinentry call. Provide the proper tty in
the GPG_TTY environment variable (and set a TERM variable if not
provided; this is necessary for pinentry-curses). Finally, resume vaxis.
To enable terminal-based pinentry support, you have to set
[general]
use-terminal-pinentry = true
in your aerc.conf. Any GUI-based pinentry programs will work the same as
before if this option is not set to true.
To test pinentry-tty, add the following to your ~/.gnupg/gpg-agent.conf:
pinentry-program /usr/bin/pinentry-tty
and kill all running gpg-agents:
$ killall gpg-agent
Fixes: https://todo.sr.ht/~rjarry/aerc/202
Changelog-fixed: Terminal-based pinentry programs
(e.g. `pinentry-curses`) now work properly.
Signed-off-by: Koni Marti <koni.marti@gmail.com>
Acked-by: Robin Jarry <robin@jarry.cc>
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/aerc-config.5.scd | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd index d4c1ad19..80922fa1 100644 --- a/doc/aerc-config.5.scd +++ b/doc/aerc-config.5.scd @@ -41,6 +41,23 @@ These options are configured in the *[general]* section of _aerc.conf_. Default: _auto_ +*use-terminal-pinentry* = _true_|_false_ + For terminal-based pinentry programs (such as _pinentry-tty_, + _pinentry-curses_ or _pinentry-vaxis_) to work properly with *aerc*(1), + set this to _true_. + + In some setups *aerc*(1) will not be able to determine the correct tty. + In those cases, you have to manually set _GPG_TTY_ to the output of *tty*(1) + before running *aerc*(1) as recommended by GnuPG for invoking a GPG-agent. Add + the following to your shell initialization scripts: + + ``` + GPG_TTY=$(tty) + export GPG_TTY + ``` + + Default: _false_ + *unsafe-accounts-conf* = _true_|_false_ By default, the file permissions of _accounts.conf_ must be restrictive and only allow reading by the file owner (_0600_). Set this option to |