summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorWerner Koch <wk@gnupg.org>2007-03-07 21:55:14 +0100
committerWerner Koch <wk@gnupg.org>2007-03-07 21:55:14 +0100
commit634b4c31d28914e9730fefcff03f6c242ebfa441 (patch)
tree30495ec570a4da24bcf2858571cf8701664fa32a /doc
parentSupport for a global gpgconf configuration file. (diff)
downloadgnupg2-634b4c31d28914e9730fefcff03f6c242ebfa441.tar.xz
gnupg2-634b4c31d28914e9730fefcff03f6c242ebfa441.zip
The Cherry XX44 keyboard's PINpad does now work.
DINSIG and NKS card applications are now also PIN pad aware.
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/Makefile.am2
-rw-r--r--doc/tools.texi49
3 files changed, 52 insertions, 3 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 799906988..7bd0b1082 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2007-03-07 Werner Koch <wk@g10code.com>
+
+ * tools.texi (applygnupgdefaults): New.
+
2007-03-06 Werner Koch <wk@g10code.com>
* examples/gpgconf.conf: New.
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 9614b222b..70a83d437 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -55,7 +55,7 @@ myman_sources = gnupg7.texi gpg.texi gpgsm.texi gpg-agent.texi \
myman_pages = gpg2.1 gpgsm.1 gpg-agent.1 scdaemon.1 gpgv2.1 \
watchgnupg.1 gpgconf.1 addgnupghome.8 gpg-preset-passphrase.1 \
gpg-connect-agent.1 gpgparsemail.1 symcryptrun.1 \
- gpgsm-gencert.sh.1
+ gpgsm-gencert.sh.1 applygnupgdefaults.8
man_MANS = $(myman_pages)
noinst_MANS = gnupg.7
diff --git a/doc/tools.texi b/doc/tools.texi
index 1e386f521..d10b806eb 100644
--- a/doc/tools.texi
+++ b/doc/tools.texi
@@ -12,6 +12,7 @@ GnuPG comes with a couple of smaller tools:
* gpgv:: Verify OpenPGP signatures.
* addgnupghome:: Create .gnupg home directories.
* gpgconf:: Modify .gnupg home directories.
+* applygnupgdefaults:: Run gpgconf for all users.
* gpgsm-gencert.sh:: Generate an X.509 certificate request.
* gpg-preset-passphrase:: Put a passphrase into the cache.
* gpg-connect-agent:: Communicate with a running agent.
@@ -82,10 +83,12 @@ Display a brief help page and exit
@end table
@mansect see also
+@ifset isman
@command{gpg}(1),
@command{gpgsm}(1),
@command{gpg-agent}(1),
@command{scdaemon}(1)
+@end ifset
@include see-also-note.texi
@@ -680,7 +683,7 @@ effect.
@table @file
-@item /etc/gnupg/gpg-agent.conf
+@item /etc/gnupg/gpgconf.conf
@cindex gpgconf.conf
If this file exists, it is processed as a global configuration file.
A commented example can be found in the @file{examples} directory of
@@ -689,15 +692,51 @@ effect.
@mansect see also
+@ifset isman
@command{gpg}(1),
@command{gpgsm}(1),
@command{gpg-agent}(1),
@command{scdaemon}(1),
@command{dirmngr}(1)
+@end ifset
@include see-also-note.texi
-@manpause
+
+@c
+@c APPLYGNUPGDEFAULTS
+@c
+@manpage applygnupgdefaults.8
+@node applygnupgdefaults
+@section Run gpgconf for all users.
+@ifset manverb
+.B applygnupgdefaults
+\- Run gpgconf --apply-defaults for all users.
+@end ifset
+
+@mansect synopsis
+@ifset manverb
+.B applygnupgdefaults
+@end ifset
+
+@mansect description
+This script is a wrapper around @command{gpgconf} to run it with the
+command @code{--apply-defaults} for all real users with an existing
+GnuPG home directory. Admins might want to use this script to update he
+GnuPG configuration files for all users after
+@file{/etc/gnupg/gpgconf.conf} has been changed. This allows to enforce
+certain policies for all users. Note, that this is not a bulletproof of
+forcing a user to use certain options. A user may always directly edit
+the configuration files and bypass gpgconf.
+
+@noindent
+@command{applygnupgdefaults} is invoked by root as:
+
+@example
+applygnupgdefaults
+@end example
+
+
@c
@c GPGSM-GENCERT.SH
@c
@@ -725,9 +764,11 @@ which will be printed to stdout.
@samp{gpgsm-cencert.sh}
@mansect see also
+@ifset isman
@command{gpgsm}(1),
@command{gpg-agent}(1),
@command{scdaemon}(1)
+@end ifset
@include see-also-note.texi
@@ -818,10 +859,12 @@ for other users.
@end table
@mansect see also
+@ifset isman
@command{gpg}(1),
@command{gpgsm}(1),
@command{gpg-agent}(1),
@command{scdaemon}(1)
+@end ifset
@include see-also-note.texi
@@ -1103,8 +1146,10 @@ The possible exit status codes of @command{symcryptrun} are:
@end table
@mansect see also
+@ifset isman
@command{gpg}(1),
@command{gpgsm}(1),
@command{gpg-agent}(1),
+@end ifset
@include see-also-note.texi