view xml/ru/docs/mail/ngx_mail_imap_module.xml @ 637:9a85069172dc

IMAP/POP3/SMTP directives split into their own modules.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 16 Aug 2012 05:04:04 +0000
parents
children ca72f350f6f0
line wrap: on
line source

<?xml version="1.0"?>

<!--
  Copyright (C) 2006, 2007 Anton Yuzhaninov
  Copyright (C) Nginx, Inc.
  -->

<!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">

<module name="Модуль ngx_mail_imap_module"
        link="/ru/docs/mail/ngx_mail_imap_module.html"
        lang="ru"
        rev="1">

<section id="directives" name="Директивы">

<directive name="imap_capabilities">
<syntax><value>расширение</value> ...</syntax>
<default>IMAP4 IMAP4rev1 UIDPLUS</default>
<context>mail</context>
<context>server</context>

<para>
Позволяет указать список расширений
<link url="http://tools.ietf.org/html/rfc3501">протокола IMAP</link>,
выдаваемый клиенту по команде
<literal>CAPABILITY</literal>.
К этому списку автоматически добавляется
<link url="http://tools.ietf.org/html/rfc2595">STARTTLS</link>,
если включена директива <link doc="ngx_mail_ssl_module.xml" id="starttls"/>.
</para>

<para>
В данной директиве имеет смысл указать расширения,
поддерживаемые IMAP-бэкендами,
на которые проксируются клиенты (если эти расширения относятся к командам,
используемым после авторизации, когда nginx прозрачно проксирует подключение
клиента на бэкенд).
</para>

<para>
Текущий список стандартизованных расширений опубликован на
<link url="http://www.iana.org/assignments/imap4-capabilities">www.iana.org</link>.
</para>

</directive>


<directive name="imap_client_buffer">
<syntax><value>размер</value></syntax>
<default>4k|8k</default>
<context>mail</context>
<context>server</context>

<para>
Задаёт размер буфера для чтения IMAP-команд.
По умолчанию размер одного буфера равен размеру страницы.
В зависимости от платформы это или 4K, или 8K.
</para>

</directive>

</section>

</module>