Mercurial > hg > nginx-site

comparison xml/en/docs/events.xml @ 553:6330ca27a485

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Translated "events" into English.
author Ruslan Ermilov <ru@nginx.com>
date Tue, 26 Jun 2012 07:36:58 +0000
parents
children ccb7451af1d8
comparison
equal deleted inserted replaced
552:32bde52db92c 553:6330ca27a485
1 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
2
3 <article name="Connection processing methods"
4 link="/en/docs/events.html"
5 lang="en">
6
7 <section>
8
9 <para>
10 nginx supports a variety of connection processing methods.
11 The availability of a particular method depends on the platform used.
12 On platforms that support several methods nginx will normally
13 select the most efficient method automatically.
14 However, if needed, a connection processing method can be selected
15 explicitly with the
16 <link doc="ngx_core_module.xml" id="use"/> directive.
17 </para>
18
19 <para>
20 The following connection processing methods are supported:
21 <list type="bullet">
22
23 <listitem>
24 <para>
25 <literal>select</literal>&mdash;standard method.
26 The supporting module is built automatically on platforms that lack
27 more efficient methods.
28 The <literal>--with-select_module</literal> and
29 <literal>--without-select_module</literal> configuration parameters
30 can be used to forcibly enable or disable the build of this module.
31 </para>
32 </listitem>
33
34 <listitem>
35 <para>
36 <literal>poll</literal>&mdash;standard method.
37 The supporting module is built automatically on platforms that lack
38 more efficient methods.
39 The <literal>--with-poll_module</literal> and
40 <literal>--without-poll_module</literal> configuration parameters
41 can be used to forcibly enable or disable the build of this module.
42 </para>
43 </listitem>
44
45 <listitem>
46 <para>
47 <literal>kqueue</literal>&mdash;efficient method used on
48 FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0, and Mac OS X.
49 <note>
50 On two-processor machines running some older versions of Mac OS X
51 the use of kqueue may cause a kernel panic.
52 </note>
53 </para>
54 </listitem>
55
56 <listitem>
57 <para>
58 <literal>epoll</literal>&mdash;efficient method used on
59 Linux 2.6+.
60 <note>
61 Some older distributions like SuSE 8.2 provide patches
62 that add epoll support to 2.4 kernels.
63 </note>
64 </para>
65 </listitem>
66
67 <listitem>
68 <para>
69 <literal>rtsig</literal>&mdash;real time signals, efficient method
70 used on Linux 2.2.19+.
71 By default,
72 the system-wide event queue is limited by 1024 signals.
73 On loaded servers it may become necessary to increase this limit
74 by changing the <path>/proc/sys/kernel/rtsig-max</path> kernel parameter.
75 However, in Linux 2.6.6-mm2 this parameter is gone, and each process
76 now has its own event queue.
77 The size of each queue is limited by <literal>RLIMIT_SIGPENDING</literal>.
78 </para>
79
80 <para>
81 On queue overflow, nginx discards the queue and falls back to
82 <literal>poll</literal> connection processing method until
83 the situation gets back to normal.
84 </para>
85 </listitem>
86
87 <listitem>
88 <para>
89 <literal>/dev/poll</literal>&mdash;efficient method used on
90 Solaris 7 11/99+, HP/UX 11.22+ (eventport), IRIX 6.5.15+,
91 and Tru64 UNIX 5.1A+.
92 </para>
93 </listitem>
94
95 <listitem>
96 <para>
97 <literal>eventport</literal>&mdash;event ports, efficient method
98 used on Solaris 10.
99 <note>
100 This
101 <link url="http://sunsolve.sun.com/search/document.do?assetkey=1-26-102485-1">patch</link>
102 might be required to avoid kernel panics.
103 </note>
104 </para>
105 </listitem>
106
107 </list>
108 </para>
109
110 </section>
111
112 </article>