Next: Client-Side IMAP Splitting, Previous: Connecting to an IMAP Server, Up: Using IMAP [Contents][Index]

#### 6.3.2 Customizing the IMAP Connection

Here’s an example method that’s more complex:

    (nnimap "imap.gmail.com"
            (nnimap-inbox "INBOX")
            (nnimap-split-methods default)
            (nnimap-expunge t)
            (nnimap-stream ssl))

`nnimap-address`

  The address of the server, like ‘`imap.gmail.com`’.

`nnimap-server-port`

  If the server uses a non-standard port, that can be specified here. A typical port would be `"imap"` or `"imaps"`.

`nnimap-stream`

  How `nnimap` should connect to the server. Possible values are:

  `undecided`

    This is the default, and this first tries the `ssl` setting, and then tries the `network` setting.

  `ssl`

    This uses standard TLS/SSL connections.

  `network`

    Non-encrypted and unsafe straight socket connection, but will upgrade to encrypted STARTTLS if both Emacs and the server supports it.

  `starttls`

    Encrypted STARTTLS over the normal IMAP port.

  `shell`

    If you need to tunnel via other systems to connect to the server, you can use this option, and customize `nnimap-shell-program` to be what you need.

  `plain`

    Non-encrypted and unsafe straight socket connection. STARTTLS will not be used even if it is available.

`nnimap-authenticator`

  Some IMAP servers allow anonymous logins. In that case, this should be set to `anonymous`. If this variable isn’t set, the normal login methods will be used. If you wish to specify a specific login method to be used, you can set this variable to either `login` (the traditional IMAP login method), `plain` or `cram-md5`.

`nnimap-expunge`

  If non-`nil`, expunge articles after deleting them. This is always done if the server supports UID EXPUNGE, but it’s not done by default on servers that doesn’t support that command.

`nnimap-streaming`

  Virtually all IMAP server support fast streaming of data. If you have problems connecting to the server, try setting this to `nil`.

`nnimap-fetch-partial-articles`

  If non-`nil`, fetch partial articles from the server. If set to a string, then it’s interpreted as a regexp, and parts that have matching types will be fetched. For instance, ‘`"text/"`’ will fetch all textual parts, while leaving the rest on the server.

`nnimap-record-commands`

  If non-`nil`, record all IMAP commands in the ‘`"*imap log*"`’ buffer.

Next: Client-Side IMAP Splitting, Previous: Connecting to an IMAP Server, Up: Using IMAP [Contents][Index]