Agent Signals - Using the GNU Privacy Guard
Description: Using the GNU Privacy Guard

Next: Agent Examples, Previous: Agent Configuration, Up: Invoking GPG-AGENT

### 2.4 Use of some signals.

A running `gpg-agent` may be controlled by signals, i.e. using the `kill` command to send a signal to the process.

Here is a list of supported signals:

`SIGHUP`
  This signal flushes all cached passphrases and if the program has been started with a configuration file, the configuration file is read again. Only certain options are honored: `quiet`, `verbose`, `debug`, `debug-all`, `debug-level`, `no-grab`, `pinentry-program`, `default-cache-ttl`, `max-cache-ttl`, `ignore-cache-for-signing`, `no-allow-external-cache`, `allow-mark-trusted`, `disable-scdaemon`, and `disable-check-own-socket`. `scdaemon-program` is also supported but due to the current implementation, which calls the scdaemon only once, it is not of much use unless you manually kill the scdaemon.
`SIGTERM`
  Shuts down the process but waits until all current requests are fulfilled. If the process has received 3 of these signals and requests are still pending, a shutdown is forced.
`SIGINT`
  Shuts down the process immediately.
`SIGUSR1`
  Dump internal information to the log file.
`SIGUSR2`
  This signal is used for internal purposes.