aboutsummaryrefslogtreecommitdiffstats
path: root/doc/tools.texi
diff options
context:
space:
mode:
authorWerner Koch <[email protected]>2016-12-16 15:00:15 +0000
committerWerner Koch <[email protected]>2016-12-16 15:05:02 +0000
commit76cd64a5baf6057b199c01f7999b327f1f4a87bc (patch)
tree9975cc64b46a26afe4a69ed9c9dcc5a3ded771d9 /doc/tools.texi
parentgpgconf: Fix --apply-defaults. (diff)
downloadgnupg-76cd64a5baf6057b199c01f7999b327f1f4a87bc.tar.gz
gnupg-76cd64a5baf6057b199c01f7999b327f1f4a87bc.zip
gpgconf: New command --apply-profile.
* tools/gpgconf.c (aApplyProfile): New. (opts): New command --apply-profile. (main): Implement that command. * tools/gpgconf-comp.c (option_check_validity): Add arg VERBATIM. (change_options_program): Ditto. (change_one_value): Ditto. (gc_component_change_options): Ditto. (gc_apply_profile): New. -- Here is an example for a profile --8<---------------cut here---------------start------------->8--- # foo.prf - Sample profile [gpg] compliance de-vs default-new-key-algo brainpoolP256r1+brainpoolP256r1 [gpgsm] enable-crl-checks [gpg-agent] default-cache-ttl 900 max-cache-ttl [] 3600 no-allow-mark-trusted no-allow-external-cache enforce-passphrase-constraints min-passphrase-len 9 min-passphrase-nonalpha 0 [dirmngr] keyserver hkp://keys.gnupg.net allow-ocsp --8<---------------cut here---------------end--------------->8--- Note that flags inside of brackets are allowed after the option name. The only defined flag for now is "[default]". In case the value starts with a bracket, it is possible to insert "[]" as a nop-flag. Signed-off-by: Werner Koch <[email protected]>
Diffstat (limited to 'doc/tools.texi')
-rw-r--r--doc/tools.texi9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/tools.texi b/doc/tools.texi
index b1ed61584..d321b699a 100644
--- a/doc/tools.texi
+++ b/doc/tools.texi
@@ -279,6 +279,15 @@ Change the options of the component @var{component}.
@item --check-options @var{component}
Check the options for the component @var{component}.
+@item --apply-profile @var{file}
+Apply the configuration settings listed in @var{file} to the
+configuration files. If @var{file} has no suffix and no slashes the
+command first tries to read a file with the suffix @code{.prf} from
+the the data directory (@code{gpgconf --list-dirs datadir}) before it
+reads the file verbatim. A profile is divided into sections using the
+bracketed component name. Each section then lists the option which
+shall go into the respective configuration file.
+
@item --apply-defaults
Update all configuration files with values taken from the global
configuration file (usually @file{/etc/gnupg/gpgconf.conf}).