extension][RFC 7162]; for convenience reasons servers must also support
the [`LIST-EXTENDED`][RFC 5258], [`LIST-STATUS`][RFC 5819] and
[`UIDPLUS`][RFC 4315] IMAP extensions.
-See also the **[supported extensions]** section below.
+See also the **[supported extensions](#supported-extensions)** section
+below.
Stateful synchronization is only possible for mailboxes supporting
persistent message Unique Identifiers (UID) and persistent storage of
By default, `interimap` synchronizes each mailbox listed by the `LIST ""
"*"` IMAP command;
the *list-mailbox*, *list-select-opts* and *ignore-mailbox* options from
-the [configuration file] can be used to shrink that list and save
-bandwidth.
+the [configuration file](#configuration-file) can be used to shrink that
+list and save bandwidth.
However if some extra argument are provided on the command line,
`interimap` ignores said options and synchronizes the given
*MAILBOX*es instead. Note that each *MAILBOX* is taken “as is”; in
`--config=`*FILE*
-: Specify an alternate [configuration file]. Relative paths start
- from *$XDG_CONFIG_HOME*, or *~/.config* if the `XDG_CONFIG_HOME`
- environment variable is unset.
+: Specify an alternate [configuration file](#configuration-file).
+ Relative paths start from *$XDG_CONFIG_HOME*, or *~/.config* if the
+ `XDG_CONFIG_HOME` environment variable is unset.
`--target={local,remote,database}`
: Don't exit after a successful synchronization. Instead, keep
synchronizing forever. Sleep for the given number of *seconds* (1
minute by default) between two synchronizations.
+ Setting this options enables `SO_KEEPALIVE` on the socket for
+ *type*s other than `tunnel`.
`-q`, `--quiet`
* `interimap` will probably not work with non [RFC][RFC 3501]-compliant
servers. In particular, no work-around is currently implemented
- beside the tunables in the [configuration file]. Moreover, few IMAP
- servers have been tested so far.
+ beside the tunables in the [configuration file](#configuration-file).
+ Moreover, few IMAP servers have been tested so far.
Standards
=========
`UIDNEXT` values. While `pullimap` is running, the *statefile* is also
used to keep track of UIDs being delivered, which avoids duplicate
deliveries in case the process is interrupted.
-See the **[control flow]** section below for details.
+See the **[control flow](#control-flow)** section below for details.
Options
=======
`--config=`*FILE*
-: Specify an alternate [configuration file]. Relative paths start
- from *$XDG_CONFIG_HOME*, or *~/.config* if the `XDG_CONFIG_HOME`
- environment variable is unset.
+: Specify an alternate [configuration file](#configuration-file).
+ Relative paths start from *$XDG_CONFIG_HOME*, or *~/.config* if the
+ `XDG_CONFIG_HOME` environment variable is unset.
`--idle`[`=`*seconds*]