[git] GnuPG - branch, master, updated. gnupg-2.1.0beta3-64-g99fc61f
by Ben Kibbey
cvs at cvs.gnupg.org
Wed Apr 4 13:01:37 CEST 2012
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "The GNU Privacy Guard".
The branch, master has been updated
via 99fc61f1cf09c7f72a9037d91d3cf0cd2e035ae6 (commit)
via a577f06c4aecc0af5b492e15812e9150c747cbe4 (commit)
via 108e8f622ef9cfa256707debec1d379ce3cf21ca (commit)
via 96e107fc29db625b247022ae1bf2cbe90b939c5d (commit)
via 26b59d78c43d72fa28609fb2c0d80fb377393127 (commit)
from 17499e761e8cd0fe867b5b5f3e42a71b6d45f954 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
commit 99fc61f1cf09c7f72a9037d91d3cf0cd2e035ae6
Author: Ben Kibbey <bjk at luxsci.net>
Date: Tue Apr 3 20:53:23 2012 -0400
Mention status messages in the documentation.
Note INQUIRE_MAXLEN.
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index 1c4d92f..dcd96fb 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -796,6 +796,14 @@ certificate is that it will be possible to use the same keypair for
different protocols, thereby saving space on the token used to keep the
secret keys.
+ at ifset gpgtwoone
+The @command{gpg-agent} may send status messages during a command or when
+returning from a command to inform a client about the progress or result of an
+operation. For example, the @var{INQUIRE_MAXLEN} status message may be sent
+during a server inquire to inform the client of the maximum usable length of
+the inquired data (which should not be exceeded).
+ at end ifset
+
@menu
* Agent PKDECRYPT:: Decrypting a session key
* Agent PKSIGN:: Signing a Hash
commit a577f06c4aecc0af5b492e15812e9150c747cbe4
Author: Ben Kibbey <bjk at luxsci.net>
Date: Tue Apr 3 20:53:22 2012 -0400
Document PASSWD --preset.
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index a7b9865..1c4d92f 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -1287,12 +1287,22 @@ option given the certificates are send back.
@subsection Change a Passphrase
@example
+ at ifset gpgtwoone
+ PASSWD [--cache-nonce=<c>] [--passwd-nonce=<s>] [--preset] @var{keygrip}
+ at end ifset
+ at ifclear gpgtwoone
PASSWD @var{keygrip}
+ at end ifclear
@end example
This command is used to interactively change the passphrase of the key
identified by the hex string @var{keygrip}.
+ at ifset gpgtwoone
+The @option{--preset} option may be used to add the new passphrase to the
+cache using the default cache parameters.
+ at end ifset
+
@node Agent UPDATESTARTUPTTY
@subsection Change the standard display
commit 108e8f622ef9cfa256707debec1d379ce3cf21ca
Author: Ben Kibbey <bjk at luxsci.net>
Date: Tue Apr 3 20:53:21 2012 -0400
Document GENKEY options.
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index eb5b334..a7b9865 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -976,7 +976,12 @@ option allows to choose the storage location. To get the secret key out
of the PSE, a special export tool has to be used.
@example
+ at ifset gpgtwoone
+ GENKEY [--no-protection] [--preset] [<cache_nonce>]
+ at end ifset
+ at ifclear gpgtwoone
GENKEY
+ at end ifclear
@end example
Invokes the key generation process and the server will then inquire
@@ -1021,6 +1026,13 @@ Here is an example session:
S OK key created
@end example
+ at ifset gpgtwoone
+The @option{--no-protection} option may be used to prevent prompting for a
+passphrase to protect the secret key while leaving the secret key unprotected.
+The @option{--preset} option may be used to add the passphrase to the cache
+using the default cache parameters.
+ at end ifset
+
@node Agent IMPORT
@subsection Importing a Secret Key
commit 96e107fc29db625b247022ae1bf2cbe90b939c5d
Author: Ben Kibbey <bjk at luxsci.net>
Date: Tue Apr 3 20:53:20 2012 -0400
Document PRESET_PASSPHRASE.
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index 19f7c30..eb5b334 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -805,6 +805,9 @@ secret keys.
* Agent ISTRUSTED:: Importing a Root Certificate
* Agent GET_PASSPHRASE:: Ask for a passphrase
* Agent CLEAR_PASSPHRASE:: Expire a cached passphrase
+ at ifset gpgtwoone
+* Agent PRESET_PASSPHRASE:: Set a passphrase for a keygrip
+ at end ifset
* Agent GET_CONFIRMATION:: Ask for confirmation
* Agent HAVEKEY:: Check whether a key is available
* Agent LEARN:: Register a smartcard
@@ -1196,6 +1199,30 @@ was set by gpg-agent.
+ at ifset gpgtwoone
+ at node Agent PRESET_PASSPHRASE
+ at subsection Set a passphrase for a keygrip
+
+This command adds a passphrase to the cache for the specified @var{keygrip}.
+
+ at example
+ PRESET_PASSPHRASE [--inquire] <string_or_keygrip> <timeout> [<hexstring>]
+ at end example
+
+The passphrase is a hexidecimal string when specified. When not specified, the
+passphrase will be retrieved from the pinentry module unless the
+ at option{--inquire} option was specified in which case the passphrase will be
+retrieved from the client.
+
+The @var{timeout} parameter keeps the passphrase cached for the specified
+number of seconds. A value of @code{-1} means infinate while @code{0} means
+the default (currently only a timeout of -1 is allowed, which means to never
+expire it).
+ at end ifset
+
+
+
+
@node Agent GET_CONFIRMATION
@subsection Ask for confirmation
commit 26b59d78c43d72fa28609fb2c0d80fb377393127
Author: Ben Kibbey <bjk at luxsci.net>
Date: Tue Apr 3 20:53:19 2012 -0400
Document CLEAR_PASSPHRASE.
And describe the --mode=normal option.
diff --git a/doc/gpg-agent.texi b/doc/gpg-agent.texi
index 4c7f13f..19f7c30 100644
--- a/doc/gpg-agent.texi
+++ b/doc/gpg-agent.texi
@@ -804,6 +804,7 @@ secret keys.
* Agent EXPORT:: Exporting a Secret Key
* Agent ISTRUSTED:: Importing a Root Certificate
* Agent GET_PASSPHRASE:: Ask for a passphrase
+* Agent CLEAR_PASSPHRASE:: Expire a cached passphrase
* Agent GET_CONFIRMATION:: Ask for confirmation
* Agent HAVEKEY:: Check whether a key is available
* Agent LEARN:: Register a smartcard
@@ -1173,6 +1174,28 @@ may be used to invalidate the cache entry for a passphrase. The
function returns with OK even when there is no cached passphrase.
+
+ at node Agent CLEAR_PASSPHRASE
+ at subsection Remove a cached passphrase
+
+Use this command to remove a cached passphrase.
+
+ at example
+ at ifset gpgtwoone
+ CLEAR_PASSPHRASE [--mode=normal] <cache_id>
+ at end ifset
+ at ifclear gpgtwoone
+ CLEAR_PASSPHRASE <cache_id>
+ at end ifclear
+ at end example
+
+ at ifset gpgtwoone
+The @option{--mode=normal} option can be used to clear a @var{cache_id} that
+was set by gpg-agent.
+ at end ifset
+
+
+
@node Agent GET_CONFIRMATION
@subsection Ask for confirmation
-----------------------------------------------------------------------
Summary of changes:
doc/gpg-agent.texi | 80 ++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 80 insertions(+), 0 deletions(-)
hooks/post-receive
--
The GNU Privacy Guard
http://git.gnupg.org
More information about the Gnupg-commits
mailing list