watchgnupg
(1)
Name
watchgnupg - Read and print logs from a socket
Synopsis
watchgnupg [--force] [--verbose] socketname
Description
GNU Privacy Guard WATCHGNUPG(1)
NAME
watchgnupg - Read and print logs from a socket
SYNOPSIS
watchgnupg [--force] [--verbose] socketname
DESCRIPTION
Most of the main utilities are able to write their log files
to a Unix Domain socket if configured that way. watchgnupg
is a simple listener for such a socket. It ameliorates the
output with a time stamp and makes sure that long lines are
not interspersed with log output from other utilities. This
tool is not available for Windows.
watchgnupg is commonly invoked as
watchgnupg --force ~/.gnupg/S.log
OPTIONS
watchgnupg understands these options:
--force
Delete an already existing socket file.
--tcp n
Instead of reading from a local socket, listen for con-
nects on TCP port n.
--verbose
Enable extra informational output.
--version
Print version of the program and exit.
--help
Display a brief help page and exit.
GnuPG 2.0.22 Last change: 2014-06-17 1
GNU Privacy Guard WATCHGNUPG(1)
EXAMPLES
$ watchgnupg --force /home/foo/.gnupg/S.log
This waits for connections on the local socket
`/home/foo/.gnupg/S.log' and shows all log entries. To make
this work the option log-file needs to be used with all mod-
ules which logs are to be shown. The value for that option
must be given with a special prefix (e.g. in the conf file):
log-file socket:///home/foo/.gnupg/S.log
For debugging purposes it is also possible to do remote log-
ging. Take care if you use this feature because the infor-
mation is send in the clear over the network. Use this syn-
tax in the conf files:
log-file tcp://192.168.1.1:4711
You may use any port and not just 4711 as shown above; only
IP addresses are supported (v4 and v6) and no host names.
You need to start watchgnupg with the tcp option. Note that
under Windows the registry entry HKCU\Soft-
ware\GNU\GnuPG:DefaultLogFile can be used to change the
default log output from stderr to whatever is given by that
entry. However the only useful entry is a TCP name for
remote debugging.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | crypto/gnupg |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
SEE ALSO
gpg(1), gpgsm(1), gpg-agent(1), scdaemon(1)
The full documentation for this tool is maintained as a Tex-
info manual. If GnuPG and the info program are properly
installed at your site, the command
info gnupg
should give you access to the complete manual including a
menu structure and an index.
GnuPG 2.0.22 Last change: 2014-06-17 2
GNU Privacy Guard WATCHGNUPG(1)
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
ftp://ftp.gnupg.org/gcrypt/gnupg/gnupg-2.0.22.tar.bz2
Further information about this software can be found on the
open source community website at http://www.gnupg.org/.
GnuPG 2.0.22 Last change: 2014-06-17 3