aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorWerner Koch <[email protected]>2016-08-29 09:45:47 +0000
committerWerner Koch <[email protected]>2016-08-29 09:51:00 +0000
commit2aa0701013f703ad93e17da3345c493c08aa04ee (patch)
tree42e9b6da0d5cc00e5d3c2a9ec6c34a8f4d5659de /doc
parentgpg: Make decryption of -R work w/o --try-secret-key or --default-key. (diff)
downloadgnupg-2aa0701013f703ad93e17da3345c493c08aa04ee.tar.gz
gnupg-2aa0701013f703ad93e17da3345c493c08aa04ee.zip
common: Add a default socket name feature.
* common/logging.c (log_set_socket_dir_cb): New. (socket_dir_cb): New. (set_file_fd): Allow "socket://". (fun_writer): Implement default socket name. * common/init.c (_init_common_subsystems): Register default socket. -- This change allows the use of log-file socket:// in any configuration file. Signed-off-by: Werner Koch <[email protected]>
Diffstat (limited to 'doc')
-rw-r--r--doc/dirmngr.texi3
-rw-r--r--doc/gpg-agent.texi11
-rw-r--r--doc/gpg.texi5
-rw-r--r--doc/gpgsm.texi1
-rw-r--r--doc/scdaemon.texi3
-rw-r--r--doc/tools.texi8
6 files changed, 18 insertions, 13 deletions
diff --git a/doc/dirmngr.texi b/doc/dirmngr.texi
index d52fb892a..b6b70eaf5 100644
--- a/doc/dirmngr.texi
+++ b/doc/dirmngr.texi
@@ -163,7 +163,8 @@ verbose commands to @sc{dirmngr}, such as @option{-vv}.
@item --log-file @var{file}
@opindex log-file
Append all logging output to @var{file}. This is very helpful in
-seeing what the agent actually does.
+seeing what the agent actually does. Use @file{socket://} to log to
+socket.
@item --debug-level @var{level}
@opindex debug-level
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index b481dd64b..b890c214b 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -312,11 +312,12 @@ should in general not be used to avoid X-sniffing attacks.
@item --log-file @var{file}
@opindex log-file
@efindex HKCU\Software\GNU\GnuPG:DefaultLogFile
-Append all logging output to @var{file}. This is very helpful in seeing
-what the agent actually does. If neither a log file nor a log file
-descriptor has been set on a Windows platform, the Registry entry
-@code{HKCU\Software\GNU\GnuPG:DefaultLogFile}, if set, is used to specify
-the logging output.
+Append all logging output to @var{file}. This is very helpful in
+seeing what the agent actually does. Use @file{socket://} to log to
+socket. If neither a log file nor a log file descriptor has been set
+on a Windows platform, the Registry entry
+@code{HKCU\Software\GNU\GnuPG:DefaultLogFile}, if set, is used to
+specify the logging output.
@anchor{option --no-allow-mark-trusted}
diff --git a/doc/gpg.texi b/doc/gpg.texi
index fbcaa1545..68b21b62a 100644
--- a/doc/gpg.texi
+++ b/doc/gpg.texi
@@ -2697,9 +2697,8 @@ Write log output to file descriptor @code{n} and not to STDERR.
@item --log-file @code{file}
@itemx --logger-file @code{file}
@opindex log-file
-Same as @option{--logger-fd}, except the logger data is written to file
-@code{file}. Note that @option{--log-file} is only implemented for
-GnuPG-2.
+Same as @option{--logger-fd}, except the logger data is written to
+file @code{file}. Use @file{socket://} to log to socket.
@item --attribute-fd @code{n}
@opindex attribute-fd
diff --git a/doc/gpgsm.texi b/doc/gpgsm.texi
index dae26b239..7cee0f35f 100644
--- a/doc/gpgsm.texi
+++ b/doc/gpgsm.texi
@@ -384,6 +384,7 @@ Do not print a warning when the so called "secure memory" cannot be used.
@item --log-file @var{file}
@opindex log-file
When running in server mode, append all logging output to @var{file}.
+Use @file{socket://} to log to socket.
@end table
diff --git a/doc/scdaemon.texi b/doc/scdaemon.texi
index c1458147f..85a80f0c3 100644
--- a/doc/scdaemon.texi
+++ b/doc/scdaemon.texi
@@ -239,7 +239,8 @@ debugging.
@item --log-file @var{file}
@opindex log-file
Append all logging output to @var{file}. This is very helpful in
-seeing what the agent actually does.
+seeing what the agent actually does. Use @file{socket://} to log to
+socket.
@item --pcsc-driver @var{library}
diff --git a/doc/tools.texi b/doc/tools.texi
index d6cf56ee4..18f5d77e0 100644
--- a/doc/tools.texi
+++ b/doc/tools.texi
@@ -103,12 +103,14 @@ This waits for connections on the local socket
@file{/home/foo/.gnupg/S.log} and shows all log entries. To make this
work the option @option{log-file} needs to be used with all modules
which logs are to be shown. The value for that option must be given
-with a special prefix (e.g. in the conf file):
+with a special prefix (e.g. in the conf files):
@example
log-file socket:///home/foo/.gnupg/S.log
@end example
+If only @code{socket://} is used a default socket file named
+@file{S.log} in the standard socket directory is used.
For debugging purposes it is also possible to do remote logging. Take
care if you use this feature because the information is send in the
clear over the network. Use this syntax in the conf files:
@@ -1737,8 +1739,8 @@ Try to be as quiet as possible.
@item --log-file @var{file}
@opindex log-file
-Append all logging output to @var{file}. Default is to write logging
-information to STDERR.
+Append all logging output to @var{file}. Use @file{socket://} to log
+to socket. Default is to write logging information to STDERR.
@end table