Mercurial > hg > nginx-site
view xml/en/docs/mail/ngx_mail_proxy_module.xml @ 978:5ebc52bb2633
Donor added.
author | Maxim Konovalov <maxim@nginx.com> |
---|---|
date | Tue, 03 Sep 2013 07:22:27 +0000 |
parents | 95c3c3bbf1ce |
children | b81ad8234f90 |
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="Module ngx_mail_proxy_module" link="/en/docs/mail/ngx_mail_proxy_module.html" lang="en" rev="1"> <section id="directives" name="Directives"> <!-- <directive name="proxy"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>mail</context> <context>server</context> <para> Does not tested anywhere in the current version. </para> </directive> --> <directive name="proxy_buffer"> <syntax><value>size</value></syntax> <default>4k|8k</default> <context>mail</context> <context>server</context> <para> Sets the size of the buffer used for proxying. By default, the buffer size is equal to one memory page. Depending on a platform, it is either 4K or 8K. </para> </directive> <directive name="proxy_pass_error_message"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>mail</context> <context>server</context> <para> Indicates whether to pass the error message obtained during the authentication on the backend to the client. </para> <para> Usually, if the authentication in nginx is a success, the backend cannot return an error. If it nevertheless returns an error, it means some internal error has occurred. In such case the backend message can contain information that should not be shown to the client. However, responding with an error for the correct password is a normal behavior for some POP3 servers. For example, CommuniGatePro informs a user about <link url="http://www.stalker.com/CommuniGatePro/Alerts.html#Quota">mailbox overflow</link> or other events by periodically outputting the <link url="http://www.stalker.com/CommuniGatePro/POP.html#Alerts">authentication error</link>. The directive should be enabled in this case. </para> </directive> <directive name="proxy_timeout"> <syntax><value>timeout</value></syntax> <default>24h</default> <context>mail</context> <context>server</context> <para> Defines a timeout used after the proxying to the backend had started. </para> </directive> <directive name="xclient"> <syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>mail</context> <context>server</context> <para> Enables or disables issuing of the <literal>XCLIENT</literal> command on connection to the SMTP backend. The <literal>XCLIENT</literal> command requires Postfix with the <link url="http://citrin.ru/nginx:xclient-login-patch">patch</link> that adds the <literal>LOGIN</literal> parameter. If the <literal>XCLIENT</literal> command is not used, the MTA will be unable to write the client’s <literal>IP</literal>/<literal>HELO</literal>/<literal>LOGIN</literal> to the log and apply various limitations based on this data. </para> <para> If <literal>xclient</literal> is enabled, then on a connection to the backend nginx first issues <example> EHLO server_name </example> and then <example> XCLIENT PROTO=ESMTP HELO=client_hello ADDR=192.168.1.1 LOGIN=good_user NAME=[UNAVAILABLE] </example> If the client issues <literal>EHLO</literal> on a connection to nginx, the <literal>XCLIENT</literal> command will pass <literal>PROTO=ESMTP</literal>. Otherwise, it will pass <literal>PROTO=SMTP</literal>. The IP address of a client is specified in the <literal>ADDR</literal> parameter, and since nginx does not use DNS to resolve the hostname, the <literal>NAME=[UNAVAILABLE]</literal> is specified. </para> <para> If <literal>xclient</literal> is disabled, nginx will issue <literal>EHLO</literal> on a connection to the backend if the client has passed it, or <literal>HELO</literal>, otherwise. </para> </directive> </section> </module>