Next: , Previous: Connecting to an IMAP Server, Up: Using IMAP

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.

nnimap-authenticator
Some IMAP servers allow anonymous logins. In that case, this should be set to anonymous.
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.