'\" te
.\" Created from Texinfo source by yat2m 1.0
.TH GPG-PRESET-PASSPHRASE 1 2015-08-20 "GnuPG 2.0.27" "GNU Privacy Guard"
.SH NAME
.B gpg-preset-passphrase
\- Put a passphrase into gpg-agent's cache
.SH SYNOPSIS
.B  gpg-preset-passphrase
.RI [ options ]
.RI [ command ]
.I cache-id

.SH DESCRIPTION
The \fBgpg-preset-passphrase\fR is a utility to seed the internal
cache of a running \fBgpg-agent\fR with passphrases.  It is mainly
useful for unattended machines, where the usual \fBpinentry\fR tool
may not be used and the passphrases for the to be used keys are given at
machine startup.

Passphrases set with this utility don't expire unless the
\fB--forget\fR option is used to explicitly clear them from the
cache --- or \fBgpg-agent\fR is either restarted or reloaded (by
sending a SIGHUP to it).  Nite that the maximum cache time as set with
\fB--max-cache-ttl\fR is still honored.  It is necessary to allow
this passphrase presetting by starting \fBgpg-agent\fR with the
\fB--allow-preset-passphrase\fR.




\fBgpg-preset-passphrase\fR is invoked this way:

.RS 2
.nf
gpg-preset-passphrase [options] [command] \fIcacheid\fR
.fi
.RE

\fIcacheid\fR is either a 40 character keygrip of hexadecimal
characters identifying the key for which the passphrase should be set
or cleared.  The keygrip is listed along with the key when running the
command: \fBgpgsm --dump-secret-keys\fR.  Alternatively an arbitrary
string may be used to identify a passphrase; it is suggested that such
a string is prefixed with the name of the application (e.g
\fBfoo:12346\fR).


One of the following command options must be given:

.TP
.B  --preset
Preset a passphrase. This is what you usually will
use. \fBgpg-preset-passphrase\fR will then read the passphrase from
\fBstdin\fR.

.TP
.B  --forget
Flush the passphrase for the given cache ID from the cache.



The following additional options may be used:

.TP
.B  -v
.TP
.B  --verbose
Output additional information while running.

.TP
.B  -P \fIstring\fR
.TP
.B  --passphrase \fIstring\fR
Instead of reading the passphrase from \fBstdin\fR, use the supplied
\fIstring\fR as passphrase.  Note that this makes the passphrase visible
for other users.


.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	crypto/gnupg
=
Stability	Uncommitted
.TE 
.PP
.SH SEE ALSO
\fBgpg\fR(1),
\fBgpgsm\fR(1),
\fBgpg-agent\fR(1),
\fBscdaemon\fR(1)

The full documentation for this tool is maintained as a Texinfo manual.
If GnuPG and the info program are properly installed at your site, the
command

.RS 2
.nf
info gnupg
.fi
.RE

should give you access to the complete manual including a menu structure
and an index.







.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  ftp://ftp.gnupg.org/gcrypt/gnupg/gnupg-2.0.27.tar.bz2

Further information about this software can be found on the open source community website at http://www.gnupg.org/.