# man > gpg-preset-passphrase(1)

[_GPG-PRESET-PASSPHRASE_(1)](https://www.chedong.com/phpMan.php/man/GPG-PRESET-PASSPHRASE/1/markdown)                GNU Privacy Guard 2.4               [_GPG-PRESET-PASSPHRASE_(1)](https://www.chedong.com/phpMan.php/man/GPG-PRESET-PASSPHRASE/1/markdown)

## NAME
       **gpg-preset-passphrase **- Put a passphrase into gpg-agent's cache

## SYNOPSIS
       **gpg-preset-passphrase **[_options_] [_command_] _cache-id_


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

       This program works with GnuPG 2 and later.  GnuPG 1.x is not supported.

       Passphrases set with this utility don't expire unless the **--forget **option is used to  explic‐
       itly clear them from the cache --- or **gpg-agent **is either restarted or reloaded (by sending a
       SIGHUP  to  it).   Note that the maximum cache time as set with **--max-cache-ttl **is still hon‐
       ored.  It is necessary to allow this passphrase presetting by  starting  **gpg-agent  **with  the
       **--allow-preset-passphrase**.




       **gpg-preset-passphrase **is invoked this way:

         gpg-preset-passphrase [options] [command] _cacheid_

       _cacheid_  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: **gpgsm --with-keygrip  --list-secret-keys**.   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 **foo:12346**).   Scripts  should  always  use  the  option
       **--with-colons**, which provides the keygrip in a "grp" line (cf. ‘_doc/DETAILS_’)/


       One of the following command options must be given:


### --preset
              Preset  a  passphrase.  This  is what you usually will use. **gpg-preset-passphrase **will
              then read the passphrase from **stdin**.


### --forget
              Flush the passphrase for the given cache ID from the cache.


       The following additional options may be used:


### -v
### --verbose
              Output additional information while running.


### -P _
       **--passphrase _**string_
              Instead of reading the passphrase from **stdin**, use the supplied _string_  as  passphrase.
              Note that this makes the passphrase visible for other users.

## SEE ALSO
       [**gpg**(1)](https://www.chedong.com/phpMan.php/man/gpg/1/markdown), [**gpgsm**(1)](https://www.chedong.com/phpMan.php/man/gpgsm/1/markdown), [**gpg-agent**(1)](https://www.chedong.com/phpMan.php/man/gpg-agent/1/markdown), [**scdaemon**(1)](https://www.chedong.com/phpMan.php/man/scdaemon/1/markdown)

       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

         info gnupg

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






GnuPG 2.4.4                                  2024-01-25                     [_GPG-PRESET-PASSPHRASE_(1)](https://www.chedong.com/phpMan.php/man/GPG-PRESET-PASSPHRASE/1/markdown)