aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gpg-agent.texi
diff options
context:
space:
mode:
authorWerner Koch <[email protected]>2025-01-08 16:10:07 +0000
committerWerner Koch <[email protected]>2025-01-08 16:17:42 +0000
commita019a0fcd8dfb9d1eae5bc991fdd54b7cf55641e (patch)
tree6b211dc7805f07b519782e8884d00c598c478c96 /doc/gpg-agent.texi
parentUpdate README and copyright years. (diff)
downloadgnupg-a019a0fcd8dfb9d1eae5bc991fdd54b7cf55641e.tar.gz
gnupg-a019a0fcd8dfb9d1eae5bc991fdd54b7cf55641e.zip
Stronger deprecate the --supervised option.
* agent/gpg-agent.c (opts): Rename option supervised. * dirmngr/dirmngr.c (opts): Ditto. -- The --supervised way to start gpg-agent has been deprecated for 2.5 years and will probably entirely removed with version 2.6.0. To allow its use until its removal the systemd service description need to be adjusted to use this option. The reason for the deprecation are conflicts with the way systemd starts gpg-agent and gpg expects how gpg-agent is started. In particular gpg expects that the gpg-agent matching its own version is started. Further the systemd way is not portable to other platforms and long term experience on Windows has show that the standard way of starting gpg-agent is less error prone. Note to those who want to re-introduse this option: Pretty please do not use socket names conflicting with our standard socket names. For example use /run/user/1000/foo-gnupg/S.gpg-agent.
Diffstat (limited to 'doc/gpg-agent.texi')
-rw-r--r--doc/gpg-agent.texi12
1 files changed, 4 insertions, 8 deletions
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index 1d531fb57..42ac84019 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -167,21 +167,17 @@ gpg-agent: @code{gpg-agent --daemon /bin/sh}. This way you get a new
shell with the environment setup properly; after you exit from this
shell, gpg-agent terminates within a few seconds.
-@item --supervised
+@item --deprecated-supervised
@opindex supervised
Run in the foreground, sending logs by default to stderr, and
listening on provided file descriptors, which must already be bound to
-listening sockets. This option is deprecated and not supported on
-Windows.
+listening sockets. This option is not supported on Windows and
+deprecated since version 2.3.6. To clarify its deprecation the option
+has been renamed with version 2.5.3.
If in @file{common.conf} the option @option{no-autostart} is set, any
start attempts will be ignored.
-In @option{--supervised} mode, different file descriptors can be provided for
-use as different socket types (e.g., ssh, extra) as long as they are
-identified in the environment variable @code{LISTEN_FDNAMES} (see
-sd_listen_fds(3) on some Linux distributions for more information on
-this convention).
@end table
@mansect options