# HG changeset patch # User Ruslan Ermilov # Date 1340696218 0 # Node ID 6330ca27a4853b4cb5460782c7ca2c1355881d82 # Parent 32bde52db92ce8b37748e818a05882c75bf303bf Translated "events" into English. diff --git a/xml/en/GNUmakefile b/xml/en/GNUmakefile --- a/xml/en/GNUmakefile +++ b/xml/en/GNUmakefile @@ -6,6 +6,7 @@ DOCS = \ faq \ install \ windows \ + events \ control \ hash \ dirindex \ diff --git a/xml/en/docs/events.xml b/xml/en/docs/events.xml new file mode 100644 --- /dev/null +++ b/xml/en/docs/events.xml @@ -0,0 +1,112 @@ + + +
+ +
+ + +nginx supports a variety of connection processing methods. +The availability of a particular method depends on the platform used. +On platforms that support several methods nginx will normally +select the most efficient method automatically. +However, if needed, a connection processing method can be selected +explicitly with the + directive. + + + +The following connection processing methods are supported: + + + + +select—standard method. +The supporting module is built automatically on platforms that lack +more efficient methods. +The --with-select_module and +--without-select_module configuration parameters +can be used to forcibly enable or disable the build of this module. + + + + + +poll—standard method. +The supporting module is built automatically on platforms that lack +more efficient methods. +The --with-poll_module and +--without-poll_module configuration parameters +can be used to forcibly enable or disable the build of this module. + + + + + +kqueue—efficient method used on +FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0, and Mac OS X. + +On two-processor machines running some older versions of Mac OS X +the use of kqueue may cause a kernel panic. + + + + + + +epoll—efficient method used on +Linux 2.6+. + +Some older distributions like SuSE 8.2 provide patches +that add epoll support to 2.4 kernels. + + + + + + +rtsig—real time signals, efficient method +used on Linux 2.2.19+. +By default, +the system-wide event queue is limited by 1024 signals. +On loaded servers it may become necessary to increase this limit +by changing the /proc/sys/kernel/rtsig-max kernel parameter. +However, in Linux 2.6.6-mm2 this parameter is gone, and each process +now has its own event queue. +The size of each queue is limited by RLIMIT_SIGPENDING. + + + +On queue overflow, nginx discards the queue and falls back to +poll connection processing method until +the situation gets back to normal. + + + + + +/dev/poll—efficient method used on +Solaris 7 11/99+, HP/UX 11.22+ (eventport), IRIX 6.5.15+, +and Tru64 UNIX 5.1A+. + + + + + +eventport—event ports, efficient method +used on Solaris 10. + +This +patch +might be required to avoid kernel panics. + + + + + + + +
+ +
diff --git a/xml/en/docs/http/ngx_http_core_module.xml b/xml/en/docs/http/ngx_http_core_module.xml --- a/xml/en/docs/http/ngx_http_core_module.xml +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -1983,8 +1983,8 @@ parameter of the di If set to a non-zero value, nginx will try to minimize the number of send operations on client sockets by using either -NOTE_LOWAT flag of -, +NOTE_LOWAT flag of the + method, or the SO_SNDLOWAT socket option, with the specified size. diff --git a/xml/en/docs/index.xml b/xml/en/docs/index.xml --- a/xml/en/docs/index.xml +++ b/xml/en/docs/index.xml @@ -37,6 +37,10 @@ + + + + diff --git a/xml/en/docs/windows.xml b/xml/en/docs/windows.xml --- a/xml/en/docs/windows.xml +++ b/xml/en/docs/windows.xml @@ -9,7 +9,7 @@ Version of nginx for Windows uses the native Win32 API (not the Cygwin emulation layer). -Only the select request processing method is currently used, +Only the select connection processing method is currently used, so high performance and scalability should not be expected. Due to this and some other known issues version of nginx for Windows is considered to be a beta version. @@ -138,7 +138,7 @@ Running as a service. -Using the I/O completion ports as a request processing method. +Using the I/O completion ports as a connection processing method. diff --git a/xml/en/index.xml b/xml/en/index.xml --- a/xml/en/index.xml +++ b/xml/en/index.xml @@ -250,7 +250,8 @@ worker processes run under an unprivileg -The notification methods: kqueue (FreeBSD 4.1+), +Support for +kqueue (FreeBSD 4.1+), epoll (Linux 2.6+), rt signals (Linux 2.2.19+), /dev/poll (Solaris 7 11/99+), event ports (Solaris 10), select, and poll;