IMAP Folder

A folder to access e-mails via IMAP4rev1 protocol (RFC 2060).

Format:

`%' mailbox [`:' username [`/' authenticate-type]][`@' hostname][`:' port][`!']

You can specify login (encoded password transmission), cram-md5 (CRAM-MD5 authentication), digest-md5 (DIGEST-MD5 authentication) or clear (or nil, plain password transmission) as authenticate-type.

default:

username  -> The value of elmo-imap4-default-user.
             Initial setting is @env{USER} environment variable or
             @env{LOGNAME} environment variable or return value of
             (user-login-name).
authenticate-type -> The value of elmo-imap4-default-authenticate-type.
             Initial setting is "auth".
hostname  -> The value of elmo-imap4-default-server.
             Initial setting is "localhost".
port -> The value of elmo-imap4-default-port.
             Initial setting is 143.

You can omit the hostname from folder names if you set elmo-imap4-default-server as your main IMAP server. For example, you can specify a folder as `foo%imap@gateway' even if you have to go through a firewall.

;; Example: imap4.exaple.org as main IMAP server
(setq elmo-imap4-default-server "imap4.example.org")

SSL (Secure Socket Layer) connection will be used if a folder name ends with `!'. Or, if the value of elmo-imap4-default-stream-type is ssl, SSL will be the default connection. If a folder name ends with `!!', STARTTLS connection will be established. If the value of elmo-imap4-default-stream-type is starttls, STARTTLS will be the default connection.

;; Example: Use SSL connection
(setq elmo-imap4-default-stream-type 'ssl)

If you specify login, cram-md5 or digest-md5 as authentication method, the password is sent in encoded form. But, if your server is unable to receive an encoded password, authentication will fall back to clear (that is, sending password in raw format) after confirmation to user. If elmo-imap4-force-login is non-nil, authentication will fall back to clear without confirmation (default value is nil).

;; Example: password in raw format
(setq elmo-imap4-default-authenticate-type 'clear)

Example:

%inbox     -> IMAP mailbox "inbox"
%#mh/inbox -> IMAP mailbox "#mh/inbox"

%inbox:hoge -> IMAP mailbox "inbox" of user "hoge".
%inbox:hoge/clear@server1
            -> server1's IMAP mailbox "inbox"
               of user "hoge", with plain password authentication
               ('clear).

International mailbox names (Modified UTF7)

You can use international mailbox names in mailbox part, if you are using Emacs which can treat unicode and elmo-imap4-use-modified-utf7 is set to non-nil value (default value is nil).

Currently, following Emacsen can treat unicode.

• Emacs 20.3 or later + Mule-UCS If you installed Mule-UCS package, Emacs can treat unicode. You can obtain Mule-UCS package from following URL.

  ftp://ftp.m17n.org/pub/mule/Mule-UCS/
  

• XEmacs 21.2.13 or later + ucs-conv package By default, XEmacs 21 cannot treat unicodes, but if you installed ucs-conv package, it can. You can obtain ucs-conv package from following anonymous CVS.

  cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root login
  Password: NULL (Just enter return key)
  cvs -d :pserver:anonymous@cvs.m17n.org:/cvs/root checkout ucs-conv
  

  You also need utf7 conversion programs, @command{u7tou8} and @command{u8tou7} to use international mailbox name in the current XEmacs. These programs are included in the UTF7 package which can be obtained from following URL.

  ftp://ftp.ifcss.org/pub/software/unix/convert/utf7.tar.gz
  

Go to the first, previous, next, last section, table of contents.