Mercurial > hg > nginx-site
changeset 1784:68928f8d31d9
Updated accept_mutex with info about reuseport and epollexclusive.
author | Yaroslav Zhuravlev <yar@nginx.com> |
---|---|
date | Mon, 15 Aug 2016 22:06:27 +0300 |
parents | 031566771bbd |
children | 3fa0944ddc6a |
files | xml/en/docs/events.xml xml/en/docs/ngx_core_module.xml xml/en/index.xml xml/ru/docs/events.xml xml/ru/docs/ngx_core_module.xml xml/ru/index.xml |
diffstat | 6 files changed, 40 insertions(+), 6 deletions(-) [+] |
line wrap: on
line diff
--- a/xml/en/docs/events.xml +++ b/xml/en/docs/events.xml @@ -8,7 +8,7 @@ <article name="Connection processing methods" link="/en/docs/events.html" lang="en" - rev="3"> + rev="4"> <section> @@ -60,6 +60,11 @@ FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0, <literal>epoll</literal>—efficient method used on Linux 2.6+. <note> +The <literal>EPOLLRDHUP</literal> (Linux 2.6.17, glibc 2.8) +and <literal>EPOLLEXCLUSIVE</literal> (Linux 4.5, glibc 2.24) +flags are supported since 1.11.3. +</note> +<note> Some older distributions like SuSE 8.2 provide patches that add epoll support to 2.4 kernels. </note>
--- a/xml/en/docs/ngx_core_module.xml +++ b/xml/en/docs/ngx_core_module.xml @@ -10,7 +10,7 @@ <module name="Core functionality" link="/en/docs/ngx_core_module.html" lang="en" - rev="20"> + rev="21"> <section id="example" name="Example Configuration"> @@ -47,6 +47,12 @@ Otherwise, all worker processes will be and if volume of new connections is low, some of the worker processes may just waste system resources. <note> +There is no need to enable <literal>accept_mutex</literal> +on systems that support the +<link doc="events.xml" id="epoll">EPOLLEXCLUSIVE</link> flag (1.11.3) or +when using <link doc="http/ngx_http_core_module.xml" id="reuseport"/>. +</note> +<note> Prior to version 1.11.3, the default value was <literal>on</literal>. </note> </para>
--- a/xml/en/index.xml +++ b/xml/en/index.xml @@ -8,7 +8,7 @@ <article name="nginx" link="/en/" lang="en" - rev="60"> + rev="61"> <section> @@ -336,6 +336,12 @@ error codes; </listitem> <listitem> +The support of various epoll features including +EPOLLRDHUP (Linux 2.6.17+, glibc 2.8+) and +EPOLLEXCLUSIVE (Linux 4.5+, glibc 2.24+); +</listitem> + +<listitem> sendfile (FreeBSD 3.1+, Linux 2.2+, Mac OS X 10.5+), sendfile64 (Linux 2.4.21+), and sendfilev (Solaris 8 7/01+) support; </listitem>
--- a/xml/ru/docs/events.xml +++ b/xml/ru/docs/events.xml @@ -8,7 +8,7 @@ <article name="Методы обработки соединений" link="/ru/docs/events.html" lang="ru" - rev="3"> + rev="4"> <section> @@ -60,6 +60,11 @@ nginx поддерживает различные методы обработки соединений. <literal>epoll</literal>—эффективный метод, используемый в Linux 2.6+. <note> +Флаги <literal>EPOLLRDHUP</literal> (Linux 2.6.17, glibc 2.8) +и <literal>EPOLLEXCLUSIVE</literal> (Linux 4.5, glibc 2.24) +поддерживаются начиная с 1.11.3. +</note> +<note> В некоторых старых дистрибутивах, например SuSE 8.2, есть патчи для поддержки epoll ядром 2.4. </note>
--- a/xml/ru/docs/ngx_core_module.xml +++ b/xml/ru/docs/ngx_core_module.xml @@ -10,7 +10,7 @@ <module name="Основная функциональность" link="/ru/docs/ngx_core_module.html" lang="ru" - rev="20"> + rev="21"> <section id="example" name="Пример конфигурации"> @@ -47,6 +47,12 @@ events { процессам, и при низкой интенсивности поступления новых соединений часть рабочих процессов может работать вхолостую. <note> +Нет необходимости включать <literal>accept_mutex</literal> +на системах, поддерживающих +флаг <link doc="events.xml" id="epoll">EPOLLEXCLUSIVE</link> (1.11.3), или +при использовании <link doc="http/ngx_http_core_module.xml" id="reuseport"/>. +</note> +<note> До версии 1.11.3 по умолчанию использовалось значение <literal>on</literal>. </note> </para>
--- a/xml/ru/index.xml +++ b/xml/ru/index.xml @@ -8,7 +8,7 @@ <article name="nginx" link="/ru/" lang="ru" - rev="60"> + rev="61"> <section> @@ -336,6 +336,12 @@ NOTE_LOWAT, EV_EOF, число доступных данных, коды ошибок; </listitem> <listitem> +Использование возможностей, предоставляемых epoll, таких как +EPOLLRDHUP (Linux 2.6.17+, glibc 2.8+) и +EPOLLEXCLUSIVE (Linux 4.5+, glibc 2.24+); +</listitem> + +<listitem> Поддержка sendfile (FreeBSD 3.1+, Linux 2.2+, Mac OS X 10.5+), sendfile64 (Linux 2.4.21+) и sendfilev <nobr>(Solaris 8 7/01+);</nobr> </listitem>