Mercurial > hg > nginx-site

comparison xml/en/docs/mail/ngx_mail_core_module.xml @ 966:95c3c3bbf1ce

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Text review.
author Egor Nikitin <yegor.nikitin@gmail.com>
date Wed, 14 Aug 2013 12:03:41 +0400
parents a2aea48ff155
children b81ad8234f90
comparison
equal deleted inserted replaced
965:fadccc156188 966:95c3c3bbf1ce
76 [<literal>bind</literal>]</syntax> 76 [<literal>bind</literal>]</syntax>
77 <default/> 77 <default/>
78 <context>server</context> 78 <context>server</context>
79 79
80 <para> 80 <para>
81 Sets an <value>address</value> and a <value>port</value> for a socket, 81 Sets the <value>address</value> and <value>port</value> for the socket
82 on which the server will accept requests. 82 on which the server will accept requests.
83 Only port may be specified. 83 It is possible to specify just the port.
84 An address may also be a hostname, for example: 84 The address can also be a hostname, for example:
85 <example> 85 <example>
86 listen 127.0.0.1:110; 86 listen 127.0.0.1:110;
87 listen *:110; 87 listen *:110;
88 listen 110; # same as *:110 88 listen 110; # same as *:110
89 listen localhost:110; 89 listen localhost:110;
103 103
104 <para> 104 <para>
105 The optional <literal>bind</literal> parameter 105 The optional <literal>bind</literal> parameter
106 instructs to make a separate <c-func>bind</c-func> 106 instructs to make a separate <c-func>bind</c-func>
107 call for a given address:port pair. 107 call for a given address:port pair.
108 The fact is that nginx will <c-func>bind</c-func> only to 108 The fact is that if there are several <literal>listen</literal> directives with
109 <literal>*:</literal><value>port</value>
110 if there are several <literal>listen</literal> directives with
111 the same port but different addresses, and one of the 109 the same port but different addresses, and one of the
112 <literal>listen</literal> directives listens on all addresses 110 <literal>listen</literal> directives listens on all addresses
113 for the given port (<literal>*:</literal><value>port</value>). 111 for the given port (<literal>*:</literal><value>port</value>), nginx will
112 <c-func>bind</c-func> only to <literal>*:</literal><value>port</value>.
114 It should be noted that the <c-func>getsockname</c-func> system call will be 113 It should be noted that the <c-func>getsockname</c-func> system call will be
115 made in this case to determine an address that accepted a connection. 114 made in this case to determine the address that accepted the connection.
116 </para> 115 </para>
117 116
118 <para> 117 <para>
119 Different servers must listen on different 118 Different servers must listen on different
120 <value>address</value>:<value>port</value> pairs. 119 <value>address</value>:<value>port</value> pairs.
127 <syntax block="yes"/> 126 <syntax block="yes"/>
128 <default/> 127 <default/>
129 <context>main</context> 128 <context>main</context>
130 129
131 <para> 130 <para>
132 Provides a configuration file context in which the mail server directives 131 Provides the configuration file context in which the mail server directives
133 are specified. 132 are specified.
134 </para> 133 </para>
135 134
136 </directive> 135 </directive>
137 136
143 <literal>smtp</literal></syntax> 142 <literal>smtp</literal></syntax>
144 <default/> 143 <default/>
145 <context>server</context> 144 <context>server</context>
146 145
147 <para> 146 <para>
148 Sets the protocol of a proxied server. 147 Sets the protocol for a proxied server.
149 Supported protocols are 148 Supported protocols are
150 <link doc="ngx_mail_imap_module.xml">IMAP</link>, 149 <link doc="ngx_mail_imap_module.xml">IMAP</link>,
151 <link doc="ngx_mail_pop3_module.xml">POP3</link> and 150 <link doc="ngx_mail_pop3_module.xml">POP3</link>, and
152 <link doc="ngx_mail_smtp_module.xml">SMTP</link>. 151 <link doc="ngx_mail_smtp_module.xml">SMTP</link>.
153 </para> 152 </para>
154 153
155 <para> 154 <para>
156 If the directive is not set, the protocol can be detected automatically 155 If the directive is not set, the protocol can be detected automatically
157 basing on the well-known port specified in the <link id="listen"/> 156 based on the well-known port specified in the <link id="listen"/>
158 directive: 157 directive:
159 <list type="bullet"> 158 <list type="bullet">
160 159
161 <listitem> 160 <listitem>
162 <literal>imap</literal>: 143, 993 161 <literal>imap</literal>: 143, 993
188 <syntax block="yes"/> 187 <syntax block="yes"/>
189 <default/> 188 <default/>
190 <context>mail</context> 189 <context>mail</context>
191 190
192 <para> 191 <para>
193 Sets a configuration for the server. 192 Sets the configuration for a server.
194 </para> 193 </para>
195 194
196 </directive> 195 </directive>
197 196
198 197
201 <default>hostname</default> 200 <default>hostname</default>
202 <context>mail</context> 201 <context>mail</context>
203 <context>server</context> 202 <context>server</context>
204 203
205 <para> 204 <para>
206 Sets a name of the server, used: 205 Sets the server name that is used:
207 206
208 <list type="bullet"> 207 <list type="bullet">
209 208
210 <listitem> 209 <listitem>
211 in the initial POP3/SMTP server greeting; 210 in the initial POP3/SMTP server greeting;
233 <default>off</default> 232 <default>off</default>
234 <context>mail</context> 233 <context>mail</context>
235 <context>server</context> 234 <context>server</context>
236 235
237 <para> 236 <para>
238 Controls if the “TCP keepalive” mode should be enabled on the client’s 237 Indicates if the “TCP keepalive” mode should be enabled on the client’s
239 connection (<c-def>SO_KEEPALIVE</c-def> socket parameter) on the 238 connection (<c-def>SO_KEEPALIVE</c-def> socket parameter) when connecting to
240 proxied server connection. 239 a proxied server.
241 </para> 240 </para>
242 241
243 </directive> 242 </directive>
244 243
245 244
248 <default>60s</default> 247 <default>60s</default>
249 <context>mail</context> 248 <context>mail</context>
250 <context>server</context> 249 <context>server</context>
251 250
252 <para> 251 <para>
253 Sets the timeout which is used before proxying to the backend started. 252 Sets the timeout that is used before proxying to the backend starts.
254 </para> 253 </para>
255 254
256 </directive> 255 </directive>
257 256
258 </section> 257 </section>