File: gnupg.info,  Node: Agent PRESET_PASSPHRASE,  Next: Agent GET_CONFIRMATION,  Prev: Agent CLEAR_PASSPHRASE,  Up: Agent Protocol

2.6.9 Set a passphrase for a keygrip
------------------------------------

This command adds a passphrase to the cache for the specified KEYGRIP.

       PRESET_PASSPHRASE [--inquire]   []

   The passphrase is a hexadecimal string when specified.  When not
specified, the passphrase will be retrieved from the pinentry module
unless the '--inquire' option was specified in which case the passphrase
will be retrieved from the client.

   The TIMEOUT parameter keeps the passphrase cached for the specified
number of seconds.  A value of '-1' means infinite while '0' means the
default (currently only a timeout of -1 is allowed, which means to never
expire it).