Mercurial > hg > nginx-site

comparison xml/en/docs/mail/ngx_mail_ssl_module.xml @ 2068:3d9e7993c201

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added links to directives in the example of ssl modules.
author Yaroslav Zhuravlev <yar@nginx.com>
date Mon, 23 Oct 2017 14:48:21 +0300
parents 8f1a568a8bbf
children 3535437f97d2
comparison
equal deleted inserted replaced
2067:014323d0cc38 2068:3d9e7993c201
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd"> 8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
9 9
10 <module name="Module ngx_mail_ssl_module" 10 <module name="Module ngx_mail_ssl_module"
11 link="/en/docs/mail/ngx_mail_ssl_module.html" 11 link="/en/docs/mail/ngx_mail_ssl_module.html"
12 lang="en" 12 lang="en"
13 rev="16"> 13 rev="17">
14 14
15 <section id="summary"> 15 <section id="summary">
16 16
17 <para> 17 <para>
18 The <literal>ngx_mail_ssl_module</literal> module provides the necessary 18 The <literal>ngx_mail_ssl_module</literal> module provides the necessary
37 <para> 37 <para>
38 To reduce the processor load, it is recommended to 38 To reduce the processor load, it is recommended to
39 <list type="bullet"> 39 <list type="bullet">
40 40
41 <listitem> 41 <listitem>
42 set the number of worker processes equal to the number of processors, 42 set the number of
43 <link doc="../ngx_core_module.xml" id="worker_processes">worker processes</link>
44 equal to the number of processors,
43 </listitem> 45 </listitem>
44 46
45 <listitem> 47 <listitem>
46 enable the shared session cache, 48 enable the <link id="ssl_session_cache_shared">shared</link> session cache,
47 </listitem> 49 </listitem>
48 50
49 <listitem> 51 <listitem>
50 disable the built-in session cache, 52 disable the <link id="ssl_session_cache_builtin">built-in</link> session cache,
51 </listitem> 53 </listitem>
52 54
53 <listitem> 55 <listitem>
54 and possibly increase the session lifetime (by default, 5 minutes): 56 and possibly increase the session <link id="ssl_session_timeout">lifetime</link>
57 (by default, 5 minutes):
55 </listitem> 58 </listitem>
56 59
57 </list> 60 </list>
58 61
59 <example> 62 <example>
385 the use of a session cache is gently disallowed: 388 the use of a session cache is gently disallowed:
386 nginx tells a client that sessions may be reused, but does not 389 nginx tells a client that sessions may be reused, but does not
387 actually store session parameters in the cache. 390 actually store session parameters in the cache.
388 </tag-desc> 391 </tag-desc>
389 392
390 <tag-name><literal>builtin</literal></tag-name> 393 <tag-name id="ssl_session_cache_builtin"><literal>builtin</literal></tag-name>
391 <tag-desc> 394 <tag-desc>
392 a cache built in OpenSSL; used by one worker process only. 395 a cache built in OpenSSL; used by one worker process only.
393 The cache size is specified in sessions. 396 The cache size is specified in sessions.
394 If size is not given, it is equal to 20480 sessions. 397 If size is not given, it is equal to 20480 sessions.
395 Use of the built-in cache can cause memory fragmentation. 398 Use of the built-in cache can cause memory fragmentation.
396 </tag-desc> 399 </tag-desc>
397 400
398 <tag-name><literal>shared</literal></tag-name> 401 <tag-name id="ssl_session_cache_shared"><literal>shared</literal></tag-name>
399 <tag-desc> 402 <tag-desc>
400 a cache shared between all worker processes. 403 a cache shared between all worker processes.
401 The cache size is specified in bytes; one megabyte can store 404 The cache size is specified in bytes; one megabyte can store
402 about 4000 sessions. 405 about 4000 sessions.
403 Each shared cache should have an arbitrary name. 406 Each shared cache should have an arbitrary name.