rd_45.134-2000 (524304), страница 9

Команда

RENAME

Аргументы

exmn – существующее имя с почтового ящика

newmn - новое имя почтового ящика

Описание

Изменяет имя почтового ящика. Ошибкой является попытка переименования несуществующего почтового ящика или попытка назначения существующего имени. Низшие иерархические имена должны переименовываться.

При переименовании почтового ящика INBOX должен быть создан почтовый ящик с новым именем и в него перенесены все сообщения из ящика INBOX, а ящик INBOX должен после выполнения команды остаться пустым. При поддержке сервером низших иерархических имен в ящике INBOX после команды переименования INBOX низшие иерархические имена должны оставаться неизмененными.

Возможные ответы без тега

-

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка удаления

BAD – неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

SUBSCRIBE

Аргументы

mb - почтовый ящик

Описание

Добавляет заданное имя почтового ящика к набору активных (подписанных) почтовых ящиков.

Сервер может выполнять проверку существования почтового ящика перед занесением его в активный список. Сервер не должен в одностороннем порядке удалять имя почтового ящика из списка активных в случае, если ящика с таким именем больше не существует.

Возможные ответы без тега

-

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

UNSUBSCRIBE

Аргументы

mb - почтовый ящик

Описание

Удаляет заданное имя почтового ящика из списка активных (подписанных) почтовых ящиков.

Возможные ответы без тега

-

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

LIST

Аргументы

rn - ссылочное имя

mn - шаблон имени почтового ящика

Описание

Возвращает подмножество имен полного множества имен, доступных для клиента и удовлетворяющих сочетанию ссылочного имени и шаблона

Почтового ящика.

Пустое ссылочное имя показывает, что необходимо взять имя почтового ящика, выбранного командой SELECT. Возвращаемые имена почтовых ящиков должны удовлетворять шаблону.

При пустом шаблоне имени почтового ящика должно быть возвращено корневое имя от ссылочного име-ни.

Возможные ответы без тега

LIST

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD – неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

LSUB

Аргументы

rn - ссылочное имя

mn - шаблон имени почтового ящика

Описание

Возвращает подмножество имен полного множества имен, занесенных в список активных для клиента и удовлетворяющих сочетанию ссылочного имени и шаблона почтового ящика.

Сервер может проверять существование почтовых ящиков, соответствующих возвращаемым именам, и помечать несуществующие ящики флагом \Noselect.

Сервер не должен удалять из возвращаемого списка имена, соответствующие несуществующим почтовым ящикам.

Возможные ответы без тега

LSUB

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD – неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

STATUS

Аргументы

mn - имя почтового ящика

data - имена пунктов данных статуса

Описание

Команда статуса запрашивает статус указанного почтового ящика. Она не должна влиять на состояние сообщений в указанном ящике (в частности, не должна сбрасывать флаг \Recent).

Команда позволяет проверить статус почтового ящика, отличного от выбранного командой SELECT.

Имена пунктов данных статуса могут быть:

MESSAGES – количество сообщений в почтовом ящике

RECENT – количество сообщений с выставленным флагом \Recent

UIDNEXT – следующее значение UID, которое будет выделено новому сообщению в данном почтовом ящике.

UIDVALIDITY – значение валидности уникального идентификатора для почтового ящика.

UNSEEN - количество сообщений, в которых не установлен флаг \Seen .

Возможные ответы без тега

STATUS

Возможные ответы с тегом

OK – команда выполнена

NO – ошибка выполнения команды

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

APPEND [] [/]

Аргументы

mn - имя почтового ящика

flags - список в скобках флагов

date - строка дата/время

ml - литерал сообщения

Описание

Команда добавляет аргумент ml в качестве нового сообщения в конец обозначенного почтового ящика. Аргумент ml должен иметь формат, согласно RFC 822 [2]. В сообщении разрешены восьмибитные символы. Если сервер не может правильно сохранить восьмибитные символы, то в сервере должно быть осуществлено преобразование восьмибитных символов в семибитный код, соответствующий MIME-IMB, а также выполнено и обратное преобразование.

Список флагов результирующего сообщения должен соответствовать аргументу flags. По умолчанию список флагов результирующего сообщения должен быть пуст.

Если указан аргумент date, внутренняя дата сообщения должна быть установлена согласно указанному значению. По умолчанию устанавливается текущая дата и время.

Частичное добавление в случае возникновения ошибки запрещено.

При отсутствии указанного почтового ящика сервер не должен автоматически его создавать. В этом случае, а также в случае если нет никаких причин, по которым почтовый ящик с указанным именем не может быть создан, сервер должен в ответ с тегом NO включить код ответа [TRYCREATE].

Возможные ответы без тега

-

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Authenticated, Selected

Команда

CHECK

Аргументы

-

Описание

Команда запрашивает контрольную точку текущего почтового ящика.

Если команда не реализована, она должна выполняться подобно NOOP.

Возможные ответы без тега

-

Возможные ответы с тегом

OK - команда выполнена

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Selected

Команда

CLOSE

Аргументы

-

Описание

Команда удаляет из текущего выбранного почтового ящика все сообщения, имеющие флаг \Deleted, и переводит сервер в состояние authenticated.

Команда игнорируется без выдачи сообщения об ошибке, если почтовый ящик открыт в режиме READ-ONLY.

Возможные ответы без тега

-

Возможные ответы с тегом

OK - команда выполнена, состояние authenticated

NO - ошибка закрытия

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Selected

Команда

EXPUNGE

Аргументы

-

Описание

Команда удаляет из текущего выбранного почтового ящика все сообщения, имеющие флаг \Deleted.

Перед выдачей ответа OK для каждого удаленного сообщения высылается ответ EXPUNGE.

Возможные ответы без тега

EXPUNGE

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Selected

Команда

SEARCH []

Аргументы

CHARSET - спецификация набора символов

sc - критерий поиска (несколько критериев)

Описание

Выполняет поиск сообщений, удовлетворяющих критерию поиска. Критерий поиска состоит из одного или более ключей поиска. При наличии нескольких ключей поиска, результат является функцией пересечения (AND) всех сообщений, удовлетворяющих ключам. Ключом поиска является список в скобках ключей поиска.

Сервер может исключить из области поиска части тела сообщения с типами содержимого, отличными от типов TEXT или MESSAGE.

CHARSET характеризует кодовый набор строк, из которых состоит критерий поиска.

Обязательной является поддержка ASCII. Если сервер не поддерживает запрошенный кодовый набор, он должен ответить NO с тегом.

Во всех ключах поиска, использующих в качестве условия строку, считается, что ключ удовлетворен, если строка ключа является подстрокой поля сообщения. Должно использоваться сравнение, независимое от регистра символов.

Определены следующие ключи:

- список номеров сообщений

ALL - все сообщения в почтовом ящике

ANSWERED - сообщения с флагом \Answered

BCC - сообщение, содержащее указанную строку в поле BCC конверта

BEFORE - сообщения, внутренняя дата которых является более ранней, чем указанная.

BODY - сообщение, содержащее указанную строку в теле сообщения

CC - сообщение, содержащее указанную строку в поле BCC конверта

DELETED - сообщения с флагом \Deleted

DRAFT - сообщения с флагом \Draft

FLAGGED - сообщения с флагом \Flagged

FROM - сообщение, содержащее указанную строку в поле From конверта

HEADER - сообщение, указанное поле заголовка которого, содержит указанную строку

KEYWORD - Сообщения с указанным набором ключевых слов

LARGER - Сообщения с размером по RFC-822 [2], большим чем n октет

NEW - сообщения с флагом \Recent, но без флага \Seen (= RECENT UNSEEN)

NOT = сообщения, не удовлетворяющие указанному ключу поиска

OLD - сообщения без флага \Recent

ON - сообщения с внутренней датой, входящей в указанный промежуток

OR - сообщения, удовлетворяющие любому ключу поиска

RECENT - сообщения с флагом \Recent

SEEN - сообщения с флагом \Seen

SENTBEFORE - сообщения с датой заголовка более ранней, чем указанная

SENTON - сообщения с датой заголовка, соответствующей указанной

SENTSINCE - сообщения с датой заголовка, более поздней или соответствующей указанной

SINCE - сообщения с внутренней датой, более поздней или соответствующей указанной

SMALLER - сообщения с размером по RFC-822 [2], меньшим чем n октет

SUBJECT - сообщение, содержащее указанную строку в поле Subject конверта

TEXT - сообщение, содержащее указанную строку в заголовке или теле сообщения

TO - сообщение, содержащее указанную строку в поле TO конверта

UID - сообщение c UID, равным указанному

UNANSWERED - сообщения без флага \Answered

UNDELETED - сообщения без флага \Deleted

UNDRAFT - сообщения без флага \Draft

UNFLAGGED - сообщения без флага \Flagged

UNKEYWORD - сообщения, в которых нет указанных ключевых слов

UNSEEN - сообщения без флага \Seen

Возможные ответы без тега

SEARCH

Возможные ответы с тегом

OK - команда выполнена

NO - ошибка выполнения команды

BAD - неизвестная команда или ошибка в аргументах

Разрешенные состояния

Selected