IMAP常用命令汇总

转自http://busylog.net/telnet-imap-commands-note/

Sometimes I need to debug issues on email box… manually on IMAP port.

Sometimes I need to see my notes.

Here some notes just to use as cut&modify&paste.
>(extra notes here)<

#0 IMAP PORT 143

telnet <IP> 143

#1 Commands format

Command Input :
<RandomStringID> Command

Answer
:
<RandomStringID> OK <ANSWER DETAIL>

Example :
  axyz login test@dom.it p4ssw0rd
  axyz OK login successful

where <RandomStringID> is chars axyz or
simply char a

#2 Commands:

A command, usually, has to be executed in the proper sequence and only if IMAP automa has the correct status for that command.

In sequence…

2.1 Login Authorization

telnet
<SERVER> 143
Trying <SERVER-IP>...
Connected to <SERVER-IP>
Escape character is '^]'.
* OK IMAP4 server ready

a login
<username>@<domain> <password>
a OK login successful

2.2 CAPABILITY

a
capability
* CAPABILITY IMAP4rev1 UIDPLUS IDLE
LOGIN-REFERRALS NAMESPACE QUOTA CHILDREN ...
a OK capabilities listed

2.3 LIST of folder

system defined folder is “INBOX”.

Format : ‘LIST “(folder directory)” “(search argument)”.

“(search argument)” is case-sensitive and accept
*

“(folder directory)” if empty list shows all content from
root

(=> all folder)

a
LIST "" "*"
* LIST (HasNoChildren) "/" folder-name-1
* LIST (HasNoChildren) "/" folder-name-2
* LIST (HasChildren) "/" folder-name-3
* LIST (HasNoChildren) "/" folder-name-1/folder-name-1.2
...
* LIST (HasNoChildren) "/" INBOX
...
* LIST (HasNoChildren) "/" Trash
a OK LIST completed

(=> folder
“folder-name-1”)

a
LIST "folder-name-1" "*"
* LIST (HasNoChildren) "/" folder-name-1/folder-name-1.2
a OK LIST completed

(=> all
folder fol*)

a
LIST "" "fol*"
* LIST (HasNoChildren) "/" folder-name-1
* LIST (HasNoChildren) "/" folder-name-2
* LIST (HasChildren) "/" folder-name-3
* LIST (HasNoChildren) "/" folder-name-1/folder-name-1.2
a OK LIST completed

2.4 Status of a Folder

(=> number
of MESSAGES)

a
STATUS INBOX (MESSAGES)
* STATUS INBOX (MESSAGES 22)
a OK STATUS complete

(=>number
of MESSAGES and number flaged as UNSEEN RECENT)
see more about flags at end of this post #3 and #4
below.

a
STATUS INBOX (MESSAGES UNSEEN RECENT)
* STATUS INBOX (MESSAGES 22 RECENT 0 UNSEEN 0)
a OK STATUS complete

2.5 SELECT a folder on which work

a
SELECT INBOX
* 22 EXISTS
* 0 RECENT
* FLAGS (Answered Flagged Deleted
Seen Draft )
* OK [PERMANENTFLAGS (Answered Flagged
Deleted Seen Draft)] flags can be changed
* OK [UIDVALIDITY 1339682095] mailbox
UID validity
* OK [UIDNEXT 745] predicted next
UID
a OK [READ-WRITE] SELECT complete

2.6 LIST of emails

see more about flags at end of this post #3 and #4
below.

(=> list
all emails and show flags)

a
fetch 1:* flags
* 1 FETCH (FLAGS (Seen))
* 2 FETCH (FLAGS (Seen))
a OK FETCH complete

(=> list
all emails and show internal date)

a
fetch 1:* INTERNALDATE
* 1 FETCH (INTERNALDATE "13-Jun-2012
11:04:18 +0200")
* 2 FETCH (INTERNALDATE "20-Aug-2012
16:29:21 +0200")
...
* 22 FETCH (INTERNALDATE "23-Oct-2012
15:31:05 +0200")
a OK FETCH complete

(=> show
email with UID 1)

a
fetch 1 body[header]
* 1 FETCH (BODY[HEADER] {1316}
Return-Path: <rmsbox@test1.priv>
... email ...
a OK FETCH complete

… Other examples which use “UID Range”

see more about flags at end of this post #3 and #4
below.
=> all
emails :

a fetch 1:* body[header]

=> all
emails showing from, to, subject and date :

a fetch 1:* (body[header.fields (from to subject
date)])

=> all
emails showing from, to, subject and date :

a fetch 1:* (body[header.fields (subject)])

2.7 SET FLAG Massively

Set massivelly (bulk set) flags such as read, unread …

a store 1:* +flags seen ...
set read all emails

a store 1:* -flags seen ... set unread all emails

a store 10:100 +flags seen ... set as read emails from 10 to
100 (meaning as UID range)

a store 22 +flags deleted ... set as deleted email 22 (meaning
as UID 22)

a store 22 -flags deleted ... retore, undelete ... email 22
(meaning as UID 22)

2.5 EXPURGE

Emails wich are set as “deleted” are actually still present in “trash” folder.

If you need to delete them you have to run “EXPURGE” command.

a
expunge
* 2 EXPUNGE
a OK EXPUNGE complete

#3 List of Flags

\Seen             Message has been read

\Answered   Message has been answered

\Flagged        Message is “flagged”for urgent/special
attention

\Deleted        Message is “deleted”for removal
by later EXPUNGE

\Draft             Message has not completed composition

\Recent         Message has arrived since the previous
time this mailbox was selected.

#4 UID Range

Some commands (store 1:*) have possibility to specify range (for example STORE command).
Possible sequences :

1:*

2,4,5,6,7,9,12,13,14,15

*:3,8,0

sequence-set   
= (seq-number / seq-range) *(“,”sequence-set)
                    ; set of seq-number values, regardless
of order.
                    ; Servers MAY coalesce overlaps and/or
execute the
                    ; sequence in any order.
                    ; Example: a message sequence number
set of
                    ; 2,4:7,9,12:* for a mailbox with 15
messages is
                    ; equivalent to 2,4,5,6,7,9,12,13,14,15
                    ; Example: a message sequence number
set of *:4,5:7
                    ; for a mailbox with 10 messages is
equivalent to
                    ; 10,9,8,7,6,5,4,5,6,7 and MAY be reordered
and
                    ; overlap coalesced to be 4,5,6,7,8,9,10.