Changeset View
Changeset View
Standalone View
Standalone View
doc/gpg-agent.texi
Context not available. | |||||
sure that only one is running: @command{gpg-agent} uses an environment | sure that only one is running: @command{gpg-agent} uses an environment | ||||
variable to inform clients about the communication parameters. You can | variable to inform clients about the communication parameters. You can | ||||
write the content of this environment variable to a file so that you can | write the content of this environment variable to a file so that you can | ||||
test for a running agent. Here is an example using Bourne shell synax: | test for a running agent. Here is an example using Bourne shell syntax: | ||||
@smallexample | @smallexample | ||||
gpg-agent --daemon --enable-ssh-support \ | gpg-agent --daemon --enable-ssh-support \ | ||||
Context not available. | |||||
protocol. | protocol. | ||||
To identify a key we use a thing called keygrip which is the SHA-1 hash | To identify a key we use a thing called keygrip which is the SHA-1 hash | ||||
of an canoncical encoded S-Expression of the the public key as used in | of an canonical encoded S-Expression of the public key as used in | ||||
Libgcrypt. For the purpose of this interface the keygrip is given as a | Libgcrypt. For the purpose of this interface the keygrip is given as a | ||||
hex string. The advantage of using this and not the hash of a | hex string. The advantage of using this and not the hash of a | ||||
certificate is that it will be possible to use the same keypair for | certificate is that it will be possible to use the same keypair for | ||||
Context not available. | |||||
PKSIGN <options> | PKSIGN <options> | ||||
@end example | @end example | ||||
Options are not yet defined, but my later be used to choosen among | Options are not yet defined, but my later be used to choose among | ||||
different algorithms. The agent does then some checks, asks for the | different algorithms. The agent does then some checks, asks for the | ||||
passphrase and as a result the server returns the signature as an SPKI | passphrase and as a result the server returns the signature as an SPKI | ||||
like S-expression in "D" lines: | like S-expression in "D" lines: | ||||
Context not available. | |||||
@node Agent IMPORT | @node Agent IMPORT | ||||
@subsection Importing a Secret Key | @subsection Importing a Secret Key | ||||
This operation is not yet supportted by GpgAgent. Specialized tools | This operation is not yet supported by GpgAgent. Specialized tools | ||||
are to be used for this. | are to be used for this. | ||||
There is no actual need because we can expect that secret keys | There is no actual need because we can expect that secret keys | ||||
Context not available. | |||||
Actually we do not import a Root Cert but provide a way to validate | Actually we do not import a Root Cert but provide a way to validate | ||||
any piece of data by storing its Hash along with a description and | any piece of data by storing its Hash along with a description and | ||||
an identifier in the PSE. Here is the interface desription: | an identifier in the PSE. Here is the interface description: | ||||
@example | @example | ||||
ISTRUSTED <fingerprint> | ISTRUSTED <fingerprint> | ||||
Context not available. | |||||
@end example | @end example | ||||
The first item on a line is the hexified fingerprint where MD5 | The first item on a line is the hexified fingerprint where MD5 | ||||
ingerprints are @code{00} padded to the left and the second item is a | fingerprints are @code{00} padded to the left and the second item is a | ||||
flag to indicate the type of key (so that gpg is able to only take care | flag to indicate the type of key (so that gpg is able to only take care | ||||
of PGP keys). P = OpenPGP, S = S/MIME. A client should ignore the rest | of PGP keys). P = OpenPGP, S = S/MIME. A client should ignore the rest | ||||
of the line, so that we can extend the format in the future. | of the line, so that we can extend the format in the future. | ||||
Context not available. | |||||
@subsection Ask for confirmation | @subsection Ask for confirmation | ||||
This command may be used to ask for a simple confirmation by | This command may be used to ask for a simple confirmation by | ||||
presenting a text and 2 bottonts: Okay and Cancel. | presenting a text and 2 buttons: Okay and Cancel. | ||||
@example | @example | ||||
GET_CONFIRMATION @var{description} | GET_CONFIRMATION @var{description} | ||||
Context not available. | |||||
@end example | @end example | ||||
This command is used to interactively change the passphrase of the key | This command is used to interactively change the passphrase of the key | ||||
indentified by the hex string @var{keygrip}. | identified by the hex string @var{keygrip}. | ||||
@node Agent UPDATESTARTUPTTY | @node Agent UPDATESTARTUPTTY | ||||
Context not available. |