[1] Рекомендация IETF RFC 821

Простой протокол передачи почты, 1982 г. (Simple Mail Transfer Protocol)

[2] Рекомендация IETF RFC 822

Стандарт для формата текстовых сообщений Интернета ARPA., 1982 г. (Standart for the Format of ARPA Internet Text Messages.)

[3] Рекомендация IETF RFC 1939

Протокол почтового офиса, 1996 г. (Post Office Protocol - Version 3)

[4] Рекомендация IETF RFC 1734

Команда AUTH протокола РОР3, 1994 г. (POP3. AUTHentication command)

[5] Рекомендация IETF RFC 1321

Алгоритм цифрового сообщения MD5, 1992 г. (The MD5 Message-Digest Algorithm)

[6] Рекомендация IETF RFC 1731

Механизм аудентификации протокола IMAP4, 1994 г. (IMAP4. Authentication Mechanisms)

[7] Рекомендация IETF RFC 1733

Распределенные модели электронной почты в IMAP4, 1994 г. (Distributed Electronic Mail Models in IMAP4)

[8] Рекомендация IETF RFC 2045

MIME (Многоцелевые расширения почты Интернета). Часть 1: Формат тела сообщения Internet., 1996 г. (MIME (Multipurpose Internet Mail Extensions). Part One: Format of Internet Message Bodies)

[9] Рекомендация IETF RFC 1700

Выделение номера., 1994 г. (Assigned Number)

[10] Рекомендация IETF RFC 1730

Протокол доступа к сообщениям Интернет, 1996 г. (Internet Message Access Protocol - version 4)

[11] Рекомендация IETF RFC 2060

Протокол доступа к сообщениям Интернет, 1996 г. (Internet Message Access Protocol - version 4rev1)

[12] Рекомендация IETF RFC 1034

Доменные имена. Концепции и возможности., 1987 г. (Domain name - concepts and facilities)

[13] Рекомендация IETF RFC 1035

Доменные имена. Реализация и спецификация., 1987 г. (Domain name - implementation and specification)

[14] Рекомендация IETF RFC 2068

Протокол передачи гипертекста - HTTP/1.1, 1997 г. (Hypertext Transfer Protocol - HTTP/1.1)

[15] Рекомендация IETF RFC 2048

Процедура регистрации типа информации, 1996 г. (Media Type Registration Procedure)

[16] ISO-8859

Международный стандарт по обработке информации - 8-битные однобайтовые наборы кодов графических символов. (International Standart - Information Processing - 8-bit Single Byte Coded Graphic Character Sets.)

[ 17] Рекомендация IETF RFC 2047

MIME (Многоцелевые расширения почты Интернета). Часть 3: Расширения заголовка для не ASCII-текста., 1996 г. (MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text)

[18] Рекомендация IETF RFC 1123

Требования для узлов Интернета - применение и поддержка., 1989 г. (Requirements for Internet hosts - application and support.)

[19] Рекомендация IETF RFC 1036

Стандарт для обмена USENET сообщениями., 1987 г. (Standart for interchange of USENET messages)

[20] Рекомендация IETF RFC 850

Стандарт для обмена USENET сообщениями., 1983 г. (Standart for interchange of USENET messages)

[21] Рекомендация IETF RFC 1952

Спецификация формата файла GZIP версии 4.З., 1996 г. (GZIP file format specification version 4.3)

[22] Рекомендация IETF RFC 1766

Тэги для идентификации языков., 1995 г. (Tags for the identification of languages)

[23] ISO-639

Коды для представления названий языков., 1988 г. (Code for representation of names languages)

[24] ISO-3166

Коды стран. (Country codes)

[25] Рекомендация IETF RFC 1864

Поле заголовка Content-MD5., 1995 (The Content-MD5 Header Field)

[26] Рекомендация IETF RFC 977

Протокол передачи сетевых новостей, 1986 г. (Network News Transfer Protokol)

[27] Рекомендация IETF RFC 959

Протокол передачи файлов, 1985 г. (File Transfer Protocol)

[28] Рекомендация IETF RFC 943

Выделенные числа, 1985 г. (Assigned Numbers)

[29] Рекомендация IETF RFC 2138

Служба удаленной аутентификации пользователей подключаемых через телефонную сеть общего пользования (ТфОП) (Remote Authentication Dial In User Service)

Команда

HELO <domain>

Аргументы

domain - имя узла передатчика SMTP

Описание

Используется для идентификации передатчика SMTP приемником SMTP.

Действия с буферами

Все таблицы состояний и буферы очищены.

Команда

MAIL FROM:<reverse-path>

Аргументы

reverce-path - обратный путь. Состоит из списка узлов и почтового ящика отправителя.

Описание

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

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

Действия с буферами

Очищаются буферы обратного пути, буферы прямого пути, буфер данных почты.

В буфер обратного пути помещаются данные аргумента команды.

Команда

RCPT TO:<forward-path>

Аргументы

forward-path - прямой путь. Состоит из списка узлов и почтового ящика адресата

Описание

Идентифицирует индивидуального получателя данных почты. Несколько получателей определяются использованием множества команд RCPT. Наличие списка узлов в прямом пути указывает, что почтовое сообщение должно быть передано следующему узлу из списка. Если приемник SMTP не поддерживает функцию пересылки, он должен выдать ответ 550 (неизвестный локальный клиент).

При передаче почтового сообщения передающий узел должен удалить свое имя из списка прямого пути. При достижении почтовым сообщением оконечного адресата (при этом прямой путь будет содержать только имя почтового ящика) приемник SMTP должен поместить почтовое сообщение в почтовый ящик с именем, указанным в прямом пути.

Действия с буферами

Аргумент прямого пути добавляется в буфер прямого пути

Команда

DATA

Аргументы

-

Описание

Приемник обрабатывает строки, следующие за этой командой как данные почты, направляемой от передатчика. Полученные почтовые данные добавляются к буферу данных. Почтовые данные должны заканчиваться последовательностью "<CRLF>.<CRLF>".

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

Когда приемник SMTP получает почтовое сообщение для пересылки или для окончательной доставки, он должен вставлять в начало почтовых данных линию штампа времени. В штампе времени должны указываться: узел-отправитель, узел-получатель (приемник данной команды), дата и время получения сообщения.

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

В случае, если пересылка почты выполнена только частично (только части указанных адресатов), сервер SMTP должен выдать ответ OK и извещения о непересланных сообщениях. Может быть либо одно извещение с перечнем всех неудачных адресатов, либо для каждого неудачного адресата должно быть выслано отдельное извещение.

Все извещения о недоставке должны посылаться с помощью команды MAIL.

Действия с буферами

Буферы обратного пути, прямого пути и буфер данных сбрасываются.

Команда

SEND FROM:<reverse-path>

Аргументы

reverse-path - обратный путь

Описание

Используется для инициации транзакции, в которой почта доставляется одному или более терминалам.

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

Действия с буферами

Буферы обратного пути, прямого пути и буфер данных сбрасываются. Информация из аргумента обратного пути вставляется в буфер обратного пути.

Команда

SOML FROM:<reverse-path>

Аргументы

reverse-path - обратный путь

Описание

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

Назначение аргумента аналогично команде SEND.

Действия с буферами

Буферы обратного пути, прямого пути и буфер данных сбрасываются. Информация из аргумента обратного пути вставляется в буфер обратного пути.

Команда

SAML FROM:<reverse-path>

Аргументы

Reverse-path - обратный путь

Описание

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

Назначение аргумента аналогично команде SEND.

Действия с буферами

Буферы обратного пути, прямого пути и буфер данных сбрасываются. Информация из аргумента обратного пути вставляется в буфер обратного пути.

Команда

RSET

Аргументы

-

Описание

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

Приемник должен ответить OK.

Действия с буферами

Все сохраненные данные уничтожаются, все буферы сбрасываются.

Команда

VRFY <string>

Аргументы

string - предполагаемое имя клиента

Описание

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

Действия с буферами

-

Команда

EXPN <string>

Аргументы

string - предполагаемый идентификатор списка рассылки

Описание

Данная команда просит приемник подтвердить, что аргумент идентифицирует список рассылки. Если аргумент содержит список рассылки, приемник должен выдать многострочный ответ с перечнем полных имен клиентов, если они известны, и полных имен почтовых ящиков, занесенных в данных список рассылки.

Действия с буферами

-

Команда

HELP [<string>]

Аргументы

string - имя команды

Описание

По данной команде приемник должен выдать ответ с полезной для передатчика информацией.

Действия с буферами

-

Команда

NOOP

Аргументы

-

Описание

Нет операции. Приемник должен выдать ответ OK.

Действия с буферами

-

Команда

QUIT

Аргументы

-

Описание

Приемник должен выдать ответ OK и закрыть соединение.

Действия с буферами

Сброс всех данных и буферов.

Команда

TURN

Аргументы

-

Описание

Приемник должен либо выдать ответ OK и взять на себя роль передатчика, либо выдать ответ отказа 502 и остаться в роли приемника.

Если обмен ролями произошел, процесс, ставший приемником высылает ответ приветствия 220.

Действия с буферами

Сброс всех данных и буферов.

1

Положительный предварительный ответ

2

Положительный окончательный ответ

3

Положительный промежуточный ответ

4

Временный отрицательный окончательный ответ

5

Постоянный отрицательный окончательный ответ

0

Ошибки синтаксиса

1

Запрос информации

2

О состоянии соединения

3

не определен

4

не определен

5

О состоянии почтовой системы

Код

Текст

211

Системный статус или ответ системной помощи

214

Ответ помощи

220

<домен> Служба готова

221

<домен> Служба закрывает соединение

250

Запрошенное действие выполнено успешно

251

Клиент не локальный, направлено в <прямой путь>

354

Начинаю получение почтовых данных. Конец при <CRLF>.<CRLF>

421

<домен> Служба не доступна, закрываю соединение

450

Запрошенное действие не принято. Почтовый ящик недоступен (например, занят)

451

Запрошенное действие прервано. Локальная ошибка выполнения.

452

Запрошенное действие не принято. Недостаточно памяти.

500

Синтаксическая ошибка, команда не распознана

501

Синтаксическая ошибка в параметре или аргументах

502

Команда не реализована

503

Неправильная последовательность команд.

504

Аргумент команды не реализован

550

Запрошенное действие не принято. Почтовый ящик не доступен (например, не найден).

551

Клиент не локальный. Пожалуйста, попробуйте <прямой путь>

552

Запрошенное действие прервано. Превышен лимит памяти.

553

Запрошенное действие не принято. Неправильное имя почтового ящика.

554

Ошибка транзакции.

Обозначение элемента

Элемент

Максимальный размер

User

имя клиента

64 символов

Domain

имя домена

64 символов

Path

обратный путь или прямой путь

256 символов

Command line

Строка команды включая символы <CRLF>

512 символов

reply line

Строка ответа включая код ответа и символы <CRLF>

512 символов

text line

Строка данных почты, включая символы <CRLF>, но не считая символы точки, добавленные для обеспечения прозрачности

1000 символов

Recipient buffer

Емкость буфера адресатов

100 адресатов

<HELO> ::= "HELO" 1*<SP> <domain> <CRLF>

<MAIL> ::= "MAIL" 1*<SP> "FROM:" <reverse-path> <CRLF>

<RCPT> ::= "RCPT" 1*<SP> "TO:" <forward-path> <CRLF>

<DATE> ::= "DATA" <CRLF>

<RSET> ::= "RSET" <CRLF>

<SEND> ::= "SEND" 1*<SP> "FROM:" <reverse-path> <CRLF>

<SOML> ::= "SOML" 1*<SP> "FROM:" <reverse-path> <CRLF>

<SAML> ::= "SAML" 1*<SP> "FROM:" <reverse-path> <CRLF>

<VRFY> ::= "VRFY" 1*<SP> <string> <CRLF>

<EXPN> ::= "EXPN"  1*<SP> <string> <CRLF>

<HELP> ::= "HELP" [1*<SP><string>] <CRLF>

<NOOP> ::= "NOOP" <CRLF>

<QUIT> ::= "QUIT" <CRLF>

<TURN> ::= "TURN" <CRLF>

<reverse-path> ::= <path>

<forward-path> ::= <path>

<path> ::= "<" [ <a-d-l> ":" ] <mailbox> ">"

<a-d-l> ::= <at-domain> | <at-domain> "," <a-d-l>

<at-domain> ::= "@" <domain>

<domain> ::= <element> <element> "." <domain>

<element> ::= <name> "#" <number> "[" <dotnum> "]"

<mailbox> ::= <local-part> "@" <domain>

<local-part> ::= <dot-string> <quoted-string>

<name> ::= <a> <ldh-str> <let-dig>

<ldh-str> ::= <let-dig-hyp> <let-dig-hyp> <ldh-str>

<let-dig> ::= <a> <d>

<let-dig-hyp> ::= <a> <d> "-"

<dot-string> ::= <string> <string> "." <dot-string>

<string> ::= <char> <char> <string>

<quoted-string> ::= """ <qtext> """

<qtext> ::= "\" <x> "\" <x> <qtext> <q> <q> <qtext>

<char> ::= <c> "\" <x>

 <dotnum> ::= <snum> "." <snum> "." <snum> "." <snum>

<number> ::= <d> <d> <number>

<CRLF> ::= <CR> <LF>

<CR> ::= символ возврата каретки (код ASCII 13)

<LF> ::= символ следующей строки (код ASCII 10)

<SP> ::= символ пробела (код ASCII - 32)

<snum>

::= одна, две или три десятичные цифры, представляющие десятичное число в диапазоне от 0 до 255

<а>

::= любой из 52 алфавитных строчных и прописных символа от А до Z и от а до z

<с>

::= любой из 128 символов ASCII кроме <special> or <SP>

<d>

::= любая из 10 цифр от 0 до 9

<q>

::= любой из 128 символов ASCII кроме <CR>, <LF>, кавычек ("), или (\)

<х>

::= любой из 128 символов ASCII

<special>

::= "<" ">" "(" ")" "[" "]" "\" "."
"," ";" ":" "@" """ управляющие символы (коды ASCII от 0 до 31 включительно, а также 127)

<return-path-line> ::= "Return-Path:" <SP<reverse-path>CRLF>

<time-stamp-line> ::= "Received:" <SP> <stamp> <CRLF>

<stamp> ::= <from-domain> <by-domain> <opt-info> ";"

<daytime>

<from-domain> ::= "FROM" <SP> <domain> <SP>

<by-domain> ::= "BY" <SP> <domain> <SP>

<opt-info> ::= [<via>] [<with>] [<id>] [<for>]

<via> ::= "VIA" <SP> <link> <SP>

<with> ::= "WITH" <SP> <protocol> <SP>

<id> ::= "ID" <SP> <string> <SP>

<for> ::= "FOR" <SP> <path> <SP>

<link> ::= Стандартные имена соединений (links),

зарегистрированные в организации Network Information Center

<protocol> ::= Стандартные имена протоколов, зарегистрированные

в организации Network Information Center

<daytime> ::= <SP> <date> <SP> <time>

<date> ::= <dd> <SP> <mon> <SP> <yy>

<time> ::= <hh> ":" <mm> ":" <ss> <SP> <zone>

<dd> ::= однозначное или двузначное десятичное число,

обозначающее день в диапазоне от 1 до 31

<mon> ::= "JAN" "FEB" "MAR" "APR" "MAY" "JUN"  

"JUL" "AUG" "SEP" "ОСТ" "NOV" "DEC"

<уу> ::= двузначное десятичное число, обозначающее год столетия

в диапазоне от 00 до 99

<hh> ::= двузначное десятичное число, обозначающее часы дня

в диапазоне от 00 до 23

<mm> ::= двузначное десятичное число, обозначающее минуты часа

в диапазоне от 00 до 59

<ss> ::= двузначное десятичное число, обозначающее секунды

минуты в диапазоне от 00 до 59

<zone> ::= "UT" для Универсального Времени (по умолчанию)

или другого часового пояса в соответствии с RFC 822 [2]

Установление соединения

S: 220

F: 421

HELO

S: 250

E: 500, 501, 504, 421

MAIL

S: 250

F: 552, 451, 452

E: 500, 501, 421

RCPT

S: 250, 251

F: 550, 551, 552, 553, 450, 451, 452

E: 500, 501, 503, 421

DATA

I: 354 -> data -> S: 250

F: 552, 554, 451, 452

F: 451, 554

E: 500, 501, 503, 421

RSET

S: 250

E: 500, 501, 504, 421

SEND

S: 250

F: 552, 451, 452

E: 500, 501, 502, 421

SOML

S: 250

F: 552, 451, 452

E: 500, 501, 502, 421

SAML

S: 250

F: 552, 451, 452

E: 500, 501, 502, 421

VRFY

S: 250, 251

F: 550, 551, 553

E: 500, 501, 502, 504, 421

EXPN

S: 250

F: 550

E: 500, 501, 502, 504, 421

HELP

S: 211, 214

E: 500, 501, 502, 504, 421

NOOP

S: 250

E: 500, 421

QUIT

S: 221

E: 500

TURN

S: 250

F: 502

E: 500, 503

Шаг транзакции

Команда

Описание шага транзакции

1.

MAIL from: <обратный путь>

На данном шаге происходит идентификация отправителя, сброс всех таблиц состояния и буферов. Устанавливается обратный путь, используемый для передачи сообщений об ошибках. Если приемник SMTP принимает данную команду, от выдает ответ 250 OK.

2.

RCPT to: <прямой путь 1>

┘.

┘.

RCPT to: <прямой путь N>

На данном шаге идентифицируется один или больше адресатов. Каждая команда RCPT идентифицирует одного адресата. Если приемник SMTP принимает команду RCPT, он выдает ответ 250 OK. Если адресат неизвестен, приемник SMTP выдает ответ 550 Failure. Описанный шаг повторяется для каждого адресата.

3.

DATA

Если приемник SMTP принимает данную команду, он выдает ответ 354 Intermediate. Следующие за командой DATA строки приемник SMTP воспринимает как текст почтового сообщения. После того, как все строки приняты и запомнены, приемник SMTP выдает ответ 250 OK.

Команда

STAT

Аргументы

-

Описание

Информация о статусе почтового ящика.

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

+OK <статус>

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

TRANSACTION

Команда

LIST [<msg>]

Аргументы

msg - номер сообщения. Не должен ссылаться на удаленное сообщение.

Описание

Если указан аргумент, сервер высылает положительный однострочный ответ с информацией о данном сообщении. Если нет сообщения с таким номером, выдается отрицательный ответ. Если аргумент не указан, сервер высылает положительный многострочный ответ с информацией обо всех сообщениях в почтовом ящике. В случае, если почтовый ящик пуст, выдается положительный ответ, состоящий только из ".CRLF".

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

+OK <скан-список>

-ERR

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

TRANSACTION

Команда

RETR <msg>

Аргументы

msg - номер сообщения

Описание

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

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

+OK <верх сообщения>

-ERR

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

TRANSACTION

Команда

DELE <msg>

Аргументы

msg - номер сообщения

Описание

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

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

+OK

-ERR

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

TRANSACTION

Команда

NOOP

Аргументы

-

Описание

Нет операции

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

+OK

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

TRANSACTION

Команда

RSET

Аргументы

-

Описание

Сбрасываются все метки удаленных сообщений

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

+OK

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

TRANSACTION

Команда

QUIT

Аргументы

-

Описание

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

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

+OK

-ERR

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

TRANSACTION

Команда

QUIT

Аргументы

-

Описание

Разрыв соединения TCP.

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

+OK

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

AUTHORIZATION

Команда

TOP <msg> <n>

Аргументы

msg - номер сообщения

n - число строк (положительное число либо равное 0)

Описание

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

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

+OK <ответ>

-ERR

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

AUTHORIZATION

Команда

UIDL [<msg>]

Аргументы

msg - номер сообщения

Описание

В случае, если аргумент задан, сервер выдает однострочный положительный ответ "unique-id listening" для почтового сообщения с указанным номером.

Если аргумент не задан, сервер выдает многострочный положительный ответ, состоящий из

- первой строки +OK,

- строк "unique-id listening" для каждого сообщения в почтовом ящике.

Отрицательный ответ выдается в случае отсутствия сообщения с указанным номером.

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

+OK <список uid>

-ERR

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

TRANSACTION

Команда

USER <name>

Аргументы

name - идентификатор почтового ящика

Описание

Идентификатор почтового ящика.

Используется в механизме идентификации по комбинации команд USER PASS. Положительный ответ выдается, если существует почтовый ящик с указанным именем, отрицательный - если такой почтовый ящик отсутствует.

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

+OK

-ERR

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

AUTHORIZATION

Команда

PASS <string>

Аргументы

string - пароль почтового ящика

Описание

Пароль почтового ящика

Используется в механизме идентификации по комбинации команд USER PASS. Положительный ответ выдается, если клиенту позволен доступ к соответствующему почтовому ящику, и отрицательный - в противном случае.

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

+OK

-ERR

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

AUTHORIZATION, после выполнения команды USER

Команда

АРОР <name> <digest>

Аргументы

name - идентификатор почтового ящика

digest - строка MD5

Описание

Пароль почтового ящика

Используется в механизме идентификации по методу "разделяемого секрета". Положительный ответ выдается, если клиенту позволен доступ к соответствующему почтовому ящику, и отрицательный - в противном случае.

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

+OK

-ERR

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

AUTHORIZATION

Команда

AUTH <str>

Аргументы

str - идентификатор идентификационного механизма в соответствии с RFC 1731 [6]

Описание

Команда начала процедуры идентификации по механизму IMAP4

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

+OK

-ERR

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

AUTHORIZATION

Ответ:

Приветствие

Структура

+OK

+OK <timestamp>

Описание

Сообщение приветствия. Метка времени timestamp должна соответствовать RFC822 [2] и должна включаться в сообщение, когда реализована команда АРОР.

Ответ:

Статус

Структура

+OK <nn> <mm>

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

mm - размер почтового ящика в октетах

Описание

Статус почтового ящика

Ответ:

скан-список

Структура

+OK <n> <m>

; для однострочного ответа

n - номер сообщения

m - точный размер сообщения
     

+OK

; для многострочного ответа

<n> <m>
     ┘

<n> <m>
     
.     

n - номер сообщения

m - точный размер сообщения

Описание

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

Ответ:

Сообщение

Структура

+OK

<line1>

┘

<linen>
     
.     

line1 .. linen - строки почтового сообщения, передаваемые в соответствии с правилами составления многострочного сообщения.

Описание

Почтовое сообщение.

Ответ:

верх сообщения

Структура

+OK

<header1>

┘

<headern>

<line1>

...

<linem>
     
.     

header1 .. headern - строки заголовка почтового сообщения;

line1 .. linem - начальные m строк тела почтового сообщения.

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

Описание

Верхняя часть почтового сообщения

Ответ:

список uid

Структура

+OK <n> <uidm>

; для однострочного ответа

n - номер сообщения

uidm - уникальный идентификатор сообщения

_________________________________________________________________

+OK

; для многострочного ответа

<n1> <uidm1>

...

<nn> <uidmn>
     
.     

n - номер сообщения

uidm - уникальный идентификатор сообщения

Описание

Уникальный идентификатор почтового сообщения.

Ответ:

"готов"

Структура

+<строка BASE64>

Описание

Вызов сервера после подачи пользователем команды AUTH

; Команда

<command> ::=

"STAT" <CRLF>
     

"LIST" [ <SP> <msg> ] <CLRF>
     

"RETR" <SP> <msg> <CLRF>
     

"DELE" <SP> <msg> <CLRF>
     

"NOOP" <CLRF>
     

"RSET" <CLRF>
     

"QUIT" <CLRF>
     

"TOP" <SP> <msg> <SP> <number> <CLRF>
     

"UIDL" [ <SP> <msg> ] <CLRF>
     

"USER" <SP> <name> <CLRF>
     

"PASS" <SP> <string> <CLRF>
     

"APOP" <SP> <name> <SP> <digest>
     

"AUTH" <SP> <str>
     

; Примечание 1: регистр символов в ключевых словах "STAT", "LIST", ...,
     

; "AUTH" не имеет значения
     

; Ответ
     

<answer>

::=<single_line> ; Однострочный ответ
     

<multi_line> ; Многострочный ответ
     

<single_Iine> ::=

<greeting>

; Приветствие
     

<status>

; Статус
     

<simple_scan_list>

; Однострочный ответ
     

; "скан-список"

<simple_uid_list>

; Однострочный ответ
     

; "список идентификаторов"
     

<simple_OK>

; Простой положительный ответ
     

<simple_ERR>

; Простой отрицательный ответ
     

<ready>

; Ответ сервера на команду AUTH
     

<multi_line> ::=

<scan_list>

; Многострочный скан-список

<message>

; Сообщение

<message_top>

; Верхняя часть сообщения

<uid_list>

; Список идентификаторов сообщений

; Примечание 2: длина строк ответа должна составлять не более 512
     

; символов включая <CRLF>

<greeting>

::= "-OK" [ <timestamp> ]

<status>

::= "+OK" <SP><number> ; Количество сообщений

; в почтовом ящике

<SP> <number> ; Размер почтового ящика

<CLRF>

<simple_scan_list>

::= "+OK" <SP> <number> ; Номер сообщения

<SP> <number> ; Размер сообщения

<CLRF>

<simple_uid_list>

::= "+OK" <SP> <number> ; Номер сообщения

<SP> <number> ; Идентификатор сообщения

<CLRF>

<simple_OK>

::= "+OK" <text><CLRF> ; произвольный текст

<simple_ERR>

::= "-ERR" <text><CLRF> ; произвольный текст

<ready>

::= "+" <SP> <строка BASE64> ; произвольный текст

<scan_list>

::= "+OK" <CRLF>

1* ( <number> ; Номер сообщения

<SP> <number> ; Размер сообщения

<CRLF>)

"." <CLRF>

<message>

::= "+OK" <CRLF>

1* (<line> <CRLF>) ; Строки почтового сообщения

"." <CLRF>

<message_top>

::= "+OK>" <CRLF>

1* (<line> <CRLF>) ; Строки заголовка

<CRLF>

1* (<line> <CRLF>) ; Начальные строки сообщения

"." <CRLF>

<uid_list>

::= "+OK" <CRLF>

1* ( <number> ; Номер сообщения

<SP> <number> ; Идентификатор сообщения

<CRLF>)

"." <CRLF>

<timestamp>

::= <метка времени в соответствии с RFC 822[2]>

<msg>

::= <number>

<name>

::= <string>

<line>

::= 2* ( PRINT_ASCII <SP> )

(EXCEPT_POINT_ASCII <SP>)

<text>

::= *(PRINT_ASCII <SP>)

<string>

::= 1*40 <PRINT_ASCII>

<number>

::= 1 *40 <DIGIT>

<CRLF>

::=<CR><LF>

<CR>

::= символ возврата каретки (код ASCII 13)

<LF>

::= символ следующей строки (код ASCII 10)

<SP>

::= символ пробела (код ASCII - 32)

<DIGIT>

::= <любая цифра ASCII "0".."9">

<PRINT_ASCII>

::= <печатный символ ASCII>

<EXCEPT_POINT>

::= <печатный символ ASCII, кроме символа ".">

<str>

::= Идентификатор в соответствии RFC1731 [6]>

Команда

CAPABILITY

Аргументы

-

Описание

Запрашивает список возможностей, поддерживаемых сервером. Сервер должен ответить единственным ответом CAPABILITY без тега с указанием "IМАР4rev1" в качестве одной из возможностей в списке, а затем ответом OK с тегом. Выдаваемый список не должен зависеть от состояния или клиента.

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

Обязательный ответ без тега: CAPABILITY

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

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

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

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

Любое состояние

Команда

NOOP

Аргументы

-

Описание

Нет операции.

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

-

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

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

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

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

Любое состояние

Команда

LOGOUT

Аргументы

-

Описание

Команда информирует сервер, что клиент хочет закрыть соединение.

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

Обязательный ответ без тега: BYE

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

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

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

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

Любое состояние

Команда

AUTHENTICATE <am>

Аргументы

am - название механизма идентификации

Описание

По этой команде сервер начинает процесс идентификации в соответствии с указанным механизмом по RFC 1731 [6]. Сервер может также согласовать механизм дополнительной защиты для последующих взаимодействий протокола. Если механизм идентификации не поддерживается, сервер должен ответить NО и отклонить команду. При успешной идентификации выдается сообщение OK, и сервер переходит в состояние Authenticated.

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

Могут быть запрошены данные продолжения

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

OK - идентификация выполнена

NO - идентификация не выполнена, механизм идентификации не поддерживается

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

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

Not-Authenticated

Команда

LOGIN <user> <pass>

Аргументы

user - идентификатор клиента

pass - пароль

Описание

Идентификация клиента и пересылка серверу незакодированного текстового пароля.

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

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

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

NO - идентификация не выполнена

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

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

Not-Authenticated

Команда

SELECT <mn>

Аргументы

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

Описание

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

Если клиенту разрешено модифицировать почтовый ящик, сервер может в ответе с тегом OK перед текстом указать код ответа "[READ-WRITE]"

Если клиенту не разрешено модифицировать почтовый ящик, сервер должен в ответе с тегом OK перед текстом указать код ответа "[READ-ONLY]"

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

Обязательные ответы без тега: FLAGS, EXISTS, RECENT

Необязательные ответы OK без тега: UNSEEN, PERMANENTFLAGS

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

OK - выбор выполнен, состояние selected

NO - ошибка выбора, состояние authenticated

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

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

Authenticated, Selected

Команда

EXAMINE <mn>

Аргументы

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

Описание

Команда EXAMINE является идентичной команде SELECT. Выбранный почтовый ящик всегда открывается без разрешения модификации (READ-ONLY).

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

Обязательные: FLAGS, EXISTS, RECENT

Необязательные ответы OK: UNSEEN, PERMANENTFLAGS

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

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

NO - ошибка выбора, состояние authenticated

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

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

Authenticated, Selected

Команда

CREATE <mn>

Аргументы

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

Описание

Создание почтового ящика с заданным именем.

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

Если символ отделения уровня иерархии появляется внутри имени почтового ящика, сервер может создавать почтовые ящики (несколько почтовых ящиков) таким образом, чтобы их структура соответствовала заданному имени. Например, при попытке создать ящик "foo/bar/zap" (символ "/" является отделителем иерархии) сервер создает иерархические ящики foo/, foo/bar и foo/bar/zap.

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

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

-

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

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

NО - ошибка создания

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

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

Authenticated, Selected

Команда

DELETE <mn>

Аргументы

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

Описание

Удаление почтового ящика.

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

(Удаление foo не должно удалить foo/bar).

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

Команда может удалять ящики высшего иерархического имени без атрибута /Noselect. При этом все сообщения из данного почтового ящика удаляются и устанавливается атрибут /Noselect.

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

-

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

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

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

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

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

Authenticated, Selected

Команда

RENAME <exmn> <newmn>

Аргументы

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

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

Описание

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

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

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

-

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

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

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

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

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

Authenticated, Selected

Команда

SUBSCRIBE <mb>

Аргументы

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

Описание

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

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

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

-

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

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

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

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

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

Authenticated, Selected

Команда

UNSUBSCRIBE <mb>

Аргументы

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

Описание

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

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

-

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

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

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

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

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

Authenticated, Selected

Команда

LIST <rn> <mn>

Аргументы

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

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

Описание

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

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

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

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

LIST

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

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

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

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

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

Authenticated, Selected

Команда

LSUB <rn> <mn>

Аргументы

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

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

Описание

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

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

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

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

LSUB

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

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

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

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

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

Authenticated, Selected

Команда

STATUS <mn> <data>

Аргументы

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

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

Описание

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

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

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

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

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

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

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

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

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

STATUS

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

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

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

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

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

Authenticated, Selected

Команда

APPEND <mn> [<flags>] [<date>/<time>] <ml>

Аргументы

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

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

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

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

Описание

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

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

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

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

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

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

-

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

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

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

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>

Аргументы

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

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

Описание

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

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

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

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

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

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

<message set> - список номеров сообщений

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

UID <message set> - сообщение с UID, равным указанному

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

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

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

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

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

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

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

SEARCH

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

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

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

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

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

Selected

Команда

FETCH <ms> <items>

Аргументы

ms - набор сообщений

items - имена элементов данных сообщения

Описание

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

Могут быть реализованы элементы:

ALL - эквивалентно набору FLAGS INTERNALDATE RFC822.SIZE ENVELOPE

BODY - нерасширяемая форма BODYSTRUCTURE

BODY [<секция>] <<частичный>> - текст отдельной секции тела сообщения.

Секция - набор определителей части. Определитель части - номер части или одно из следующих значений: HEADER, HEADER.FIELDS, HEADER.FIELDS.NOT, MIME, TEXT. Пустой аргумент секции ссылается на сообщение целиком, включая заголовок. Аргумент <частичный> позволяет выбрать произвольный отрезок выбранной части с точностью до октета.

Если <частичный> указывает вне текста, возвращается пустая строка. Если указываемый отрезок частично выходит за пределы текста, возвращается накрываемый отрезок текста. При выполнении устанавливается флаг \Seen.

BODY.PEEK [<секция>] <<частичный>> - подобно TEXT, но при выполнении флаг \Seen не устанавливается.

BODYSTRUCTURE - структура сообщения согласно RFC 2045 [8].

ENVELOPE - Структура конверта сообщения.

FAST - эквивалентно набору FLAGS INTERDATE RFC822.SIZE

FLAGS - флаги, установленные для данного сообщения

FULL - эквивалентно набору FLAGS INTERDATE RFC822.SIZE ENVELOPE BODY

INTERNALDATE - внутренняя дата сообщения

RFC822 - эквивалентно BODY[], хотя синтаксис возвращаемого ответа отличен

RFC822.HEADER - эквивалентно BODY.PEEK[HEADER], хотя синтаксис возвращаемого ответа отличен

RFC822.SIZE - размер сообщения по RFC 822 [2]

RFC822.TEXT - эквивалентно BODY[TEXT], хотя синтаксис возвращаемого ответа отличен

UID - UID сообщения

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

FETCH

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

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

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

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

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

Selected

Команда

STORE <ms> <md> <value>

Аргументы

ms - набор сообщений

md - имя элемента данных почтового сообщения

value - значение элемента данных почтового сообщения

Описание

Изменяет данные, связанные с сообщением в почтовом ящике. Обновленные значения данных возвращаются ответом FETCH. Если после имени элемента данных стоит слово .SILENT, ответ без тега FETCH не должен высылаться сервером. Должны быть реализованы аргументы:

FLAGS <список флагов> - Удаляет старый список флагов сообщения и создает новый список флагов

FLAGS.SILENT <список флагов>

+FLAGS <список флагов> - добавляет указанные флаги к существующему списку

+FLAGS.SILENT <список флагов>

-FLAGS <список флагов> - Удаляет указанные флаги из списка флагов сообщения

-FLAGS.SILENT <список флагов>

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

FETCH

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

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

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

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

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

Selected

Команда

COPY <ms> <mn>

Аргументы

Ms - набор сообщений

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

Описание

Команда копирует определенное сообщение в конец указанного ящика адресата. Флаги и внутренняя дата должны быть сохранены.

Если указанного почтового ящика не существует, сервер может создать почтовый ящик автоматически. Если сервер не создал почтовый ящик, но может создать ящик с таким именем, он должен отправить ответ NО с тегом и кодом ответа [TRYCREATE].

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

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

-

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

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

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

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

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

Selected

Команда

UID <сn> <са>

Аргументы

cn - имя команды

са - аргументы команды

Описание

Команда UID имеет две формы.

В первой форме первым аргументом является команда COPY, FETCH или STORE, а вторым аргументом - аргументы указанной команды. Однако в аргументе набора сообщений нужно указывать не последовательные номера сообщений, a UID.

Во второй форме команда UID отрабатывает команду SEARCH с соответствующими аргументами. Аргументы интерпретируются так же, как и в команде SEARCH, однако номера, возвращаемые в ответе SEARCH, будут UID вместо порядковых номеров сообщений.

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

FETCH, SEARCH

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

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

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

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

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

Selected

Код ответа:

Описание

ALERT

Текст, предназначенный для чтения человеком-клиентом, составленный таким образом, чтобы привлечь внимание клиента.

NEWNAME

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

PARSE

Текст, предназначенный для чтения человеком-клиентом и показывающий ошибку разбора заголовка RFC822 [2] или заголовка MIME-IMB сообщения.

PERMANENTFLAGS

За данным кодом следует список в скобках, содержащий список флагов, которые клиент может изменить. Список PERMANENTFLAGS может включать в себя специальный флаг \*, говорящий о возможности создания новых ключевых слов путем попыток сохранить данные флаги в почтовом ящике.

READ-ONLY

Почтовый ящик выбран в режиме только для чтения.

READ-WRITE

Почтовый ящик выбран как доступный для изменений.

TRYCREATE

Ошибка выполнения команд APPEND или COPY в связи с тем, что указанный почтовый ящик назначения не существует.

UIDVALIDITY

За данным кодом следует десятичное число, указывающее значение валидности UID.

UNSEEN

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

Ответ:

Описание

OK

Указывает на информационное сообщение, поступившее от сервера. Если присутствует тег, ответ указывает на успешное выполнение соответствующей команды.

Ответ без тега может использоваться в качестве приветствия.

NO

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

BAD

Указывает на сообщение ошибки, поступившее от сервера. Если присутствует тег, ответ указывает на ошибку протокольного уровня в команде клиента, на которую указывает тег.

PREAUTH

Может использоваться в качестве приветствия. Указывает на установление преидентифицированного соединения.

BYE

Указывает на процесс закрытия соединения. Посылается сервером в случаях:
     
- нормального закрытия соединения по команде LOGOUT

- в случае внезапного закрытия соединения сервером (например, в случае останова сервера)

- в случае разрыва соединения по таймеру неактивности

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

Ответ:

Описание

CAPABILITY

Ответ на команду CAPABILITY. Выдается перечень возможностей, поддерживаемых сервером. Должен быть включен атом "IMAP4rev1". Возможность "AUTH=" показывает, что сервер поддерживает данный механизм идентификации.

Имена, данные в списке ответа, должны быть либо стандартными, либо начинаться с буквы X.

LIST

Ответ на команду LIST. Выдается одно имя, удовлетворяющее спецификации команды LIST. Может быть несколько ответов LIST на команду LIST.

В ответе LIST указывается разделитель иерархии. Если почтовый ящик неиерархический, в качестве разделителя иерархии должен стоять NUL.

LSUB

Ответ на команду LSUB. Выдается одно имя, удовлетворяющее спецификации команды. Может быть несколько ответов на команду.

STATUS

Ответ на команду STATUS. Возвращает имя почтового ящика, удовлетворяющее спецификации команды, и запрошенную информацию статуса.

SEARCH

Ответ на команду SEARCH. Возвращает список номеров сообщений, удовлетворяющих критерию поиска. Для команды SEARCH выдаются порядковые номера, для команды UID SEARCH - UID.

FLAGS

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

Ответ:

Описание

EXISTS

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

RECENT

Указывает количество сообщений в почтовом ящике с установленным флагом \Recent. Выдается в ответ на команды SELECT или EXAMINE, или когда меняется размер почтового ящика.

Ответ:

Описание

EXPUNGE

Указывает, что определенный последовательный номер сообщения был удален из почтового ящика. Последовательные номера сообщений в данном почтовом ящике немедленно уменьшаются на 1. В случае, если удаляются несколько сообщений, выдается соответствующее количество ответов EXPUNGE. Корректировка номеров оставшихся сообщений производится после каждого ответа EXPUNGE. Таким образом, номера, выдаваемые ответами EXPUNGE, при удалении нескольких сообщений не будут соответствовать номерам, указанным в команде EXPUNGE.
     
Ответ EXPUNGE не должен посылаться во время выполнения команд FETCH, STORE, SEARCH.

FETCH

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

Определены элементы данных:

BODY - форма BODYSTRUCTURE без данных расширения

BODY [<секция>]<<начальный октет>> - текст отдельной секции тела сообщения, начиная с начального октета. Данные могут быть в 8-битовом формате, если в список параметров данной секции включен идентификатор [CHARSET].

7-битные и 8-битные символы запрещены в заголовках.

Нетекстовые данные должны передаваться в форме BASE64.

BODYSTRUCTURE - список в скобках, описывающий структуру сообщения согласно MIME-IMB.

Порядок описания данных:

Данные расширения части сложного тела:

Body parameter parenthesized list

Body discription

Body language

Первичные поля части простого тела:

Body type

Body subtype

Body parameter parenthesized list

Body id

Body description

Body encoding

Body size

Данные расширения части простого тела:

Body MD5

Body disposition

Body language

ENVELOPE - список в скобках, описывающий структуру конверта сообщения.
Порядок полей должен быть следующим: date, subject, from, sender, reply-to, to, cc, bcc, in-reply-to, message-id. Порядок полей списка адреса: personal name, at-domain-list, mailbox name, host name. Все поля с отсутствующими значениями должны иметь значения NIL.

Сервер должен определить поля reply-to и sender из поля from.

FLAGS - список в скобках флагов, установленных для данного сообщения

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

RFC822 - эквивалентно BODY[]

RFC822.HEADER - эквивалентно BODY.PEEK[HEADER]

RFC822.SIZE - числовое выражение, показывающее размер сообщения по RFC 822 [2]

RFC822.TEXT - эквивалентно BODY[TEXT]

UID - числовое выражение, показывающее UID сообщения

<">

::= <ASCII quote mark, 0x22>

;; метка ограничителя ASCII, код 0x22

address

::= "(" addr_name SPACE addr_adl SPACE addr_mailbox

SPACE addr_host ")"

addr_adl

::=nstring

;; Holds route from [RFC-822[2]] route-addr if

;; non-NIL

;; (Содержит маршрутизацию от [RFC-822[2]] адреса маршрутизации,

;; если не-NIL)

addr_host

::=nstring

;; NIL indicates [RFC-822[2]] group syntax.

;; Otherwise, holds [RFC-822[2]] domain name

;; (NIL указывает [RFC-822[2]] синтаксис группы.

;; Иначе, содержит имя домена по [RFC-822[2]])

addr_mailbox

::=nstring

;; NIL indicates end of [RFC-822[2]] group; if

;; non-NIL and addr_host is NIL, holds

;; [RFC-822[2]] group name.

;; Otherwise, holds [RFC-822[2]] local-part

;; (NIL указывает на конец группы по [RFC-822[2]];

;; Если не-NIL и addr_host - NIL, то содержит имя группы

;; по [RFC-822[2]]. Иначе, содержит локальную часть.)

addr_name

::=nstring

;; Holds phrase from [RFC-822[2]] mailbox if

;; non-NIL

;; (Содержит фразу из [RFC-822[2]] почтового ящика, если не-NIL)

alpha

::= "А" / "В" / "С" / "D" / "Е" / "F" / "G" / "Н" /

"I" / "J" / "К" / "L" / "М" / "N" / "О" / "Р" /

"Q" / "R" / "S" / "Т" / "U" / "V" / "W" / "X" /

"Y" / "Z" /

"а" / "b" / "с" / "d" / "е" / "f" / "g" / "h" /

"i" / "j" / "k" / "l" / "m" / "n" / "o" / "p" /

"q" / "r" / "s" / "t" / "u" / "v" / "w" / "x" /

"y" / "z"

;; Case-sensitive (Есть зависимость от регистра букв)

;; (65.-90.), (97.-122.)

append

::= "APPEND" SPACE mailbox [SPACE flag_list]

[SPACE date_time] SPACE literal

astring

::= atom/string

atom

::= 1* ATOM_CHAR

ATOM_CHAR

::= <any CHAR except atom_specials>

;; любое CHAR, кроме atom_specials

atom_specials

::= "(" / ")" / "{" / SPACE / CTL / list_wildcards /

quoted_specials

authenticate

::= "AUTHENTICATE" SPACE auth_type *(CRLF base64)

auth_type

::=atom

;; Defined by [IMAP-AUTH] (Определяется документом [IMAP-AUTH])

base64

::= *(4base64_char) [base64_terminal]

base64_char

::= alpha / digit / "+" / "/"

base64_terminal

::= (2base64_char "==") / (3base64_char "=")

body

::= "(" body_type_1part / body_type_mpart ")"

body_extension

::= nstring / number / "(" 1#body_extension ")"

;; Future expansion. Client implementations

;; MUST accept body_extension fields. Server

;; implementations MUST NOT generate

;; body_extension fields except as defined by

;; future standard or standards-track

;; revisions of this specification.

;; (Будущее перспективное расширение. Клиентские реализации

;; должны иметь доступ к полям body_extension. Реализации

;; сервера не должны осуществлять

;; генерацию полей body_extension, за

;; исключением случаев, определенных вводимыми стандартами

;; или поправками - версиями ревизий - данной спецификации)

body_ext_1part

::=body_fld_md5 [SPACE body_fld_dsp

[SPACE body_fld_lang

[SPACE 1#body_extension]]]

;; MUST NOT be returned on non-extensible

;; "BODY" fetch

;; (не должны возвращаться на нерасширенный вызов BODY)

body_ext_mpart

::=body_fld_param

[SPACE body_fld_dsp  SPACE body_fld_lang

[SPACE 1#body_extension]]

;; MUST NOT be returned on non-extensible

;; "BODY" fetch

;; (не должны возвращаться на нерасширенный вызов BODY)

body_fields

::= body_fld_param SPACE body_fld_id SPACE

body_fld_desc SPACE body_fld_enc SPACE

Body_fld_octets

body_fld_desc

::= nstring

body_fld_dsp

::= "(" string SPACE body_fld_param ")" / nil

body_fld_enc     

::= (<"> ("7BIT" / "8BIT" / "BINARY" / "BASE64"/

"QUOTED-PRINTABLE") <">) / string

body_fld_id

::=nstring

body_fld_lang

::= nstrig/ "(" 1#string ")"

body_fld_lines

::= number

body _fld_md5

::= nstnng

body_fld_octets

::= number

body_fld_param

::= "(" 1#(string SPACE string) ")" / nil

body_type_1part

::= (body_type_basic / body_type_msg / body_type_text)

[SPACE body_ext_1part]

body_type_basic

::= media_basic SPACE body_fields

;; MESSAGE subtype MUST NOT be "RFC822"

;; (Под-тип сообщения не должен определяться RFC822[2])

body_type_mpart

::= 1*body SPACE media_subtype

 [SPACE body_ext_mpart]

body_type_msg

::= media_message SPACE body_fields SPACE envelope

SPACE body SPACE body_fld_lines

body_type_text

::= media_text SPACE body_fields SPACE body_fld_lines

capability

::= "AUTH=" auth_type / atom

;; New capabilities MUST begin with "X" or be

;; registered with IANA as standard or

;; standards-track

;; (Новые возможности не должны начинаться с "X" или

;; регистрироваться с именем IANA в качестве

;; стандартного или стандартной записью)

capability_data

::= "CAPABILITY" SPACE [ 1 #capability SPACE]

"IMAP4rev1" [SPACE 1#capability]

;; IMAP4rev1 servers which offer RFC1730[10], RFC2060[11]

;; compatibility MUST list "IMAP4" as the first

;; capability.

;; IMAP4revq серверы, которые предлагают

;; совместимость по RFC1730[10] и RFC2060[11], должны определить

;; список "IMAP4" в качестве первоначально-определяемой

;; совместимости

CHAR

::= <any 7-bit US-ASCII character except NUL,

0x01 - 0x7f>

CHAR8

::= <any 8-bit octet except NUL, 0x01 - 0xff>

command

::= tag SPACE (command_any / command_auth /

command_nonauth / command_select) CRLF

;; Modal based on state (Форма базируется на утверждении)

command_any

::= "CAPABILITY" / "LOGOUT" / "NOOP" / x_command

;; Valid in all states (Годится в любых состояниях)

command_auth

::= append / create / delete / examine / list /

lsub / rename select / status / subscribe /
     
unsubscribe

;; Valid only in Authenticated or Selected state

;; (Годится только в режиме Аутоидентификации и Выбора)

command_nonauth

::= login / authenticate

;; Valid only when in Non-Authenticated state

;; (Годится только в режиме Не-Аутоидентификации)

command_select

::= "CHECK" / "CLOSE" / "EXPUNGE" /

copy / fetch / store / uid / search

;; Valid only when in Selected state

;; (Годится только в режиме Выбора)

continue_req

::= "+" SPACE (resp_text / base64)

copy

::= "COPY" SPACE set SPACE mailbox

CR

::= <ASCII CR, carriage return, 0x0D>

create

::= "CREATE" SPACE mailbox

;; Use of INBOX gives a NO error

;; (Использование INBOX дает ошибку NO)

CRLF

::=CR LF

CTL

::= <any ASCII control character and DEL,

0x00-0x1f, 0x7f>

date

::= date_text / <"> date_text <">

date_day

::= 1*2digit

;; Day of month (День месяца)

date_day_fixed

::= (SPACE digit) / 2digit

;; Fixed-format version of date_day

;; (Версия формата даты/дня)

date_month

::= "Jan" / "Feb" / "Mar" / "Apr" / "May" / "Jun" /

"Jul" / "Aug" / "Sep" / "Oct" / "Nov" / "Dec"

date_text

::= date_day "-" date_month "-" date_year

date_year

::= 4digit

date_time

::= <"> date_day_fixed "-" date_month "-" date_year

SPACE time SPACE zone <">

delete

::= "DELETE" SPACE mailbox

;; Use of INBOX gives a NO error

;; (Использование INBOX дает ошибку NO)

digit

::="0" / digit_nz

digit_nz

::= "1" / "2" / "3" / "4" / "5" / "6" / "7" / "8" /

"9"

;; (48. - 57.)

envelope

::= "(" env_date SPACE env_subject SPACE env_from

SPACE env_sender SPACE env_reply_to SPACE env_to

SPACE env_cc SPACE env_bcc SPACE env_in_reply_to

SPACE env_message_id ")"

env_bcc

::= "(" 1*address")" / nil

env_cc

::= "(" 1*address")"/nil

env_date

::= nstring

env_from

::= "(" 1*address ")" / nil

env_in_reply_to

::= nstring

env_message_id

::= nstring

env_reply_to

::= "(" 1*address ")" / nil

env_sender

::= "(" 1*address ")" / nil

env_subject

::= nstring

env_to

::= "(" 1*address ")" / nil

examine

::= "EXAMINE" SPACE mailbox

fetch

::= "FETCH" SPACE set SPACE ("ALL" / "FULL" /

"FAST" / fetch_att /"(" 1#fetch_att")")

fetch_att

::= "ENVELOPE" / "FLAGS" / "INTERNALDATE" /

"RFC822" [".HEADER" / ".SIZE" / ".TEXT"] /

"BODY" ["STRUCTURE"] / "UID" /

"BODY" [".PEEK"] section

 ["<" number "." nz_number ">"]

flag

::= "\Answered" / "\Flagged" / "\Deleted" /

"\Seen" / "\Draft" / flag_keyword / flag_extension

flag_extension

::= "\" atom

;; Future expansion. Client implementations

;; MUST accept flag_extension flags. Server

;; implementations MUST NOT generate

;; flag_extension flags except as defined by

;; future standard or standards-track

;; revisions of this specification.

;; (Будущее перспективное расширение. Клиентские реализации

;; должны иметь доступ к флагам flag_extension. Реализации

;; сервера не должны осуществлять

;; генерацию флагов flag_extension, за

;; исключением случаев, определенных вводимыми стандартами

;; или поправками - версиями ревизий - данной спецификации)

flag_keyword

::= atom

flag_list

::= "(" #flag ")"

greeting

::= "*" SPACE (resp_cond_auth / resp_cond_bye) CRLF

header_fld_name ::= astring
     

header_list

::= "(" 1 #header_fld_name ")"

HTAB

::= <ASCII HT, horizontal tab, 0x9>

LF

::= <ASCII LF, line feed, 0x0A>

linear-white-space ::= 1*([CRLF] LWSP-char)

list

::= "LIST" SPACE mailbox SPACE list_mailbox

list_mailbox

::= 1*(ATOM_CHAR / list_wildcards) / string

list_wildcards

::= "%" / "*"

literal

::= "{" number "}" CRLF *CHAR8

;; Number represents the number of CHAR8 octets

;; (Number представляет число октетов CHAR8)

login

::= "LOGIN" SPACE userid SPACE password

lsub

::= "LSUB" SPACE mailbox SPACE list_mailbox

LWSP-char

::= SPACE / HTAB

mailbox

::= "INBOX" astring

;; INBOX is case-insensitive. All case variants of

;; INBOX (e.g. "iNbOx") MUST be interpreted as INBOX

;; not as an astring. Refer to section 5.1 for

;; further semantic details of mailbox names.

;; (INBOX зависит от регистра букв. Все варианты случаев

;; INBOX (например "iNbOx") должны быть интерпретированы

;; и не astring. См. раздел 5.1 для

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

mailbox_data

::= "FLAGS" SPACE flag_list /

"LIST" SPACE mailbox_list /

"LSUB" SPACE mailbox_list /

"MAILBOX" SPACE text /

"SEARCH" [SPACE 1#nz_number] /

"STATUS" SPACE mailbox SPACE

"(" #<status_att number ")" /

number SPACE "EXISTS" / number SPACE "RECENT"

mailbox_list

::= "(" #("\Marked" / "\Noinferiors" /

"\Noselect" / "\Unmarked" / flag_extension) ")"

SPACE (<"> QUOTED_CHAR <"> / nil) SPACE mailbox

media_basic

::= (<"> ("APPLICATION" / "AUDIO" / "IMAGE" /

"MESSAGE" / "VIDEO") <">) / string)

SPACE media_subtype

;; Defined in [MIME-IMT] (Определены в [MIME-IMT])

media_message

::= <"> "MESSAGE" <"> SPACE <"> "RFC822" <">

;; Defined in [MIME-IMT] (Определены в [MIME-IMT])

media_subtype

::= string

;; Defined in [MIME-IMT] (Определены в [MIME-IMT])

media_text

::= <"> "TEXT" <"> SPACE media_subtype

;; Defined in [MIME-IMT] (Определены в [MIME-IMT])

message_data

::= nz_number SPACE ("EXPUNGE" /

("FETCH" SPACE msg_att))

msg_att

::= "(" 1#("ENVELOPE" SPACE envelope /

"FLAGS" SPACE "(" #(flag / "\Recent") ")" /

"INTERNALDATE" SPACE date_time /

"RFC822" [".HEADER" / ".TEXT"] SPACE nstring /