gnupg/doc/tools.texi

75 lines
1.8 KiB
Plaintext

@c Copyright (C) 2004 Free Software Foundation, Inc.
@c This is part of the GnuPG manual.
@c For copying conditions, see the file GnuPG.texi.
@node Helper Tools
@chapter Helper Tools
GnuPG comes with a couple of smaller tools:
@menu
* watchgnupg:: Read logs from a socket.
* addgnupghome:: Create .gnupg home directories
@end menu
@node watchgnupg
@section Read logs from a socket
Most of the main utilities are able to write there 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.
@noindent
watchgnupg is commonly invoked as
@samp{watchgnupg --force ~/.gnupg/S.log}
@noindent
This starts it on the current terminal for listening on the socket
@file{~/.gnupg/S.log}.
@noindent
watchgnupg understands these options:
@table @gnupgtabopt
@item --force
@opindex force
Delete an already existing socket file.
@item --verbose
@opindex verbose
Enable extra informational output.
@item --version
@opindex version
print version of the program and exit
@item --help
@opindex help
Display a brief help page and exit
@end table
@node addgnupghome
@section Create .gnupg home directories
If GnuPG is installed on a system with existing user accounts, it is
sometimes required to populate the GnuPG home directory with existing
files. Especially a @file{trustlist.txt} and a keybox with some
initial certificates are often desired. This scripts help to do this
by copying all files from @file{/etc/skel/.gnupg} to the home
directories of the accounts given on the command line. It takes care
not to overwrite existing GnuPG home directories.
@noindent
addgnupghome is invoked by root as:
@samp{addgnupghome account1 account2 ... accountn}