Mercurial > hg > nginx-site

changeset 1784:68928f8d31d9

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
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	Tue Sep 13 18:46:02 2016 +0300
+++ b/xml/en/docs/events.xml	Mon Aug 15 22:06:27 2016 +0300
@@ -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 @@
 <literal>epoll</literal>&mdash;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	Tue Sep 13 18:46:02 2016 +0300
+++ b/xml/en/docs/ngx_core_module.xml	Mon Aug 15 22:06:27 2016 +0300
@@ -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 @@
 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	Tue Sep 13 18:46:02 2016 +0300
+++ b/xml/en/index.xml	Mon Aug 15 22:06:27 2016 +0300
@@ -8,7 +8,7 @@
 <article name="nginx"
          link="/en/"
          lang="en"
-         rev="60">
+         rev="61">
 
 
 <section>
@@ -336,6 +336,12 @@
 </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	Tue Sep 13 18:46:02 2016 +0300
+++ b/xml/ru/docs/events.xml	Mon Aug 15 22:06:27 2016 +0300
@@ -8,7 +8,7 @@
 <article name="Методы обработки соединений"
          link="/ru/docs/events.html"
          lang="ru"
-         rev="3">
+         rev="4">
 
 <section>
 
@@ -60,6 +60,11 @@
 <literal>epoll</literal>&mdash;эффективный метод, используемый
 в 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	Tue Sep 13 18:46:02 2016 +0300
+++ b/xml/ru/docs/ngx_core_module.xml	Mon Aug 15 22:06:27 2016 +0300
@@ -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 @@
 процессам, и при низкой интенсивности поступления новых соединений
 часть рабочих процессов может работать вхолостую.
 <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	Tue Sep 13 18:46:02 2016 +0300
+++ b/xml/ru/index.xml	Mon Aug 15 22:06:27 2016 +0300
@@ -8,7 +8,7 @@
 <article name="nginx"
          link="/ru/"
          lang="ru"
-         rev="60">
+         rev="61">
 
 
 <section>
@@ -336,6 +336,12 @@
 </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>