Mercurial > hg > nginx-site
comparison xml/en/docs/events.xml @ 553:6330ca27a485
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>—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>—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>—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>—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>—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>—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>—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> |