changeset 1465:eea7541e7c6a

Removed "rtsig" and "worker_rlimit_sigpending".
author Ruslan Ermilov <ru@nginx.com>
date Thu, 23 Apr 2015 14:33:10 +0300
parents d5c66374dc02
children 564bfa1ef994
files xml/en/docs/configure.xml xml/en/docs/control.xml xml/en/docs/events.xml xml/en/docs/ngx_core_module.xml xml/ru/docs/configure.xml xml/ru/docs/control.xml xml/ru/docs/events.xml xml/ru/docs/example.xml xml/ru/docs/ngx_core_module.xml
diffstat 9 files changed, 14 insertions(+), 128 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/configure.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/en/docs/configure.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Building nginx from Sources"
          link="/en/docs/configure.html"
          lang="en"
-         rev="4">
+         rev="5">
 
 <section>
 
@@ -121,7 +121,7 @@
 building a module that allows the server to work with the
 <c-func>select</c-func> method.
 This module is built automatically if the platform does not appear
-to support more appropriate methods such as kqueue, epoll, rtsig, or /dev/poll.
+to support more appropriate methods such as kqueue, epoll, or /dev/poll.
 </para>
 </listitem>
 
@@ -132,7 +132,7 @@
 building a module that allows the server to work with the
 <c-func>poll</c-func> method.
 This module is built automatically if the platform does not appear
-to support more appropriate methods such as kqueue, epoll, rtsig, or /dev/poll.
+to support more appropriate methods such as kqueue, epoll, or /dev/poll.
 </para>
 </listitem>
 
--- a/xml/en/docs/control.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/en/docs/control.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Controlling nginx"
          link="/en/docs/control.html"
          lang="en"
-         rev="5">
+         rev="6">
 
 <section>
 
@@ -189,15 +189,6 @@
 </para>
 
 <para>
-<note>
-When using the “rtsig” method on Linux, the new processes may not accept
-connections even after the old master process was sent the WINCH signal.
-If that is the case, the USR1 signal should be sent to the new master
-process continuously, until the new processes start to accept connections.
-</note>
-</para>
-
-<para>
 After some time, only the new worker processes will process requests:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
--- a/xml/en/docs/events.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/en/docs/events.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Connection processing methods"
          link="/en/docs/events.html"
          lang="en"
-         rev="2">
+         rev="3">
 
 <section>
 
@@ -66,28 +66,6 @@
 </para>
 </listitem>
 
-<listitem id="rtsig">
-<para>
-<literal>rtsig</literal>&mdash;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 <path>/proc/sys/kernel/rtsig-max</path> 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 <literal>RLIMIT_SIGPENDING</literal>
-and can be changed with
-<link doc="ngx_core_module.xml" id="worker_rlimit_sigpending"/>.
-</para>
-
-<para>
-On queue overflow, nginx discards the queue and falls back to
-<literal>poll</literal> connection processing method until
-the situation gets back to normal.
-</para>
-</listitem>
-
 <listitem id="devpoll">
 <para>
 <literal>/dev/poll</literal>&mdash;efficient method used on
--- a/xml/en/docs/ngx_core_module.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/en/docs/ngx_core_module.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -10,7 +10,7 @@
 <module name="Core functionality"
         link="/en/docs/ngx_core_module.html"
         lang="en"
-        rev="13">
+        rev="14">
 
 <section id="example" name="Example Configuration">
 
@@ -46,11 +46,6 @@
 Otherwise, all worker processes will be notified about new connections,
 and if volume of new connections is low, some of the worker processes
 may just waste system resources.
-<note>
-The use of <link doc="events.xml" id="rtsig"/>
-connection processing method
-requires <literal>accept_mutex</literal> to be enabled.
-</note>
 </para>
 
 </directive>
@@ -350,11 +345,6 @@
 connection processing method is used, because it reports
 the number of new connections waiting to be accepted.
 </note>
-<note>
-The use of <link doc="events.xml" id="rtsig"/>
-connection processing method
-automatically enables <literal>multi_accept</literal>.
-</note>
 </para>
 
 </directive>
@@ -669,22 +659,6 @@
 </directive>
 
 
-<directive name="worker_rlimit_sigpending">
-<syntax><value>number</value></syntax>
-<default/>
-<context>main</context>
-
-<para>
-On systems that support <link doc="events.xml" id="rtsig"/>
-connection processing method,
-changes the limit on the number of signals that may be queued
-(<c-def>RLIMIT_SIGPENDING</c-def>) for worker processes.
-Used to increase the limit without restarting the main process.
-</para>
-
-</directive>
-
-
 <directive name="working_directory">
 <syntax><value>directory</value></syntax>
 <default/>
--- a/xml/ru/docs/configure.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/ru/docs/configure.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Сборка nginx из исходных файлов"
          link="/ru/docs/configure.html"
          lang="ru"
-         rev="4">
+         rev="5">
 
 <section>
 
@@ -118,7 +118,7 @@
 <literal>--without-select_module</literal>&mdash;разрешает или запрещает
 сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
 Этот модуль собирается автоматически, если на платформе не обнаружено
-более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+более подходящего метода&mdash;kqueue, epoll или /dev/poll.
 </para>
 </listitem>
 
@@ -128,7 +128,7 @@
 <literal>--without-poll_module</literal>&mdash;разрешает или запрещает
 сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
 Этот модуль собирается автоматически, если на платформе не обнаружено
-более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+более подходящего метода&mdash;kqueue, epoll или /dev/poll.
 </para>
 </listitem>
 
--- a/xml/ru/docs/control.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/ru/docs/control.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Управление nginx"
          link="/ru/docs/control.html"
          lang="ru"
-         rev="5">
+         rev="6">
 
 <section>
 
@@ -180,15 +180,6 @@
 </para>
 
 <para>
-<note>
-При использовании метода rtsig новые процессы могут не принимать соединения
-даже после того, как старому главному процессу послан сигнал WINCH.
-В этом случае новому главному процессу нужно посылать сигнал USR1 до тех пор,
-пока новые процессы не начнут принимать соединения.
-</note>
-</para>
-
-<para>
 По истечении времени запросы будут обрабатывать только новые рабочие процессы:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
--- a/xml/ru/docs/events.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/ru/docs/events.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Методы обработки соединений"
          link="/ru/docs/events.html"
          lang="ru"
-         rev="2">
+         rev="3">
 
 <section>
 
@@ -66,28 +66,6 @@
 </para>
 </listitem>
 
-<listitem id="rtsig">
-<para>
-<literal>rtsig</literal>&mdash;real time signals, эффективный метод,
-используемый в Linux 2.2.19+.
-По умолчанию в общесистемной очереди событий может одновременно
-находиться не более 1024 сигналов.
-На нагруженных серверах может потребоваться увеличить размер очереди
-с помощью параметра ядра <path>/proc/sys/kernel/rtsig-max</path>.
-Однако, начиная с Linux 2.6.6-mm2, этого параметра уже нет и для каждого
-процесса существует отдельная очередь сигналов, размер которой
-ограничивается с помощью <literal>RLIMIT_SIGPENDING</literal>
-и может быть изменён с помощью
-<link doc="ngx_core_module.xml" id="worker_rlimit_sigpending"/>.
-</para>
-
-<para>
-При переполнении очереди nginx сбрасывает её и начинает обрабатывать
-соединения с помощью метода <literal>poll</literal> до тех пор,
-пока ситуация не нормализуется.
-</para>
-</listitem>
-
 <listitem id="devpoll">
 <para>
 <literal>/dev/poll</literal>&mdash;эффективный метод, используемый
--- a/xml/ru/docs/example.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/ru/docs/example.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -8,7 +8,7 @@
 <article name="Пример конфигурации nginx"
          link="/ru/docs/example.html"
          lang="ru"
-         rev="1">
+         rev="2">
 
 <section>
 
@@ -32,7 +32,7 @@
 events {
     connections   2000;
 
-    # use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];
+    # use [ kqueue | epoll | /dev/poll | select | poll ];
     use kqueue;
 }
 
--- a/xml/ru/docs/ngx_core_module.xml	Thu Apr 23 11:56:14 2015 +0300
+++ b/xml/ru/docs/ngx_core_module.xml	Thu Apr 23 14:33:10 2015 +0300
@@ -10,7 +10,7 @@
 <module name="Основная функциональность"
         link="/ru/docs/ngx_core_module.html"
         lang="ru"
-        rev="13">
+        rev="14">
 
 <section id="example" name="Пример конфигурации">
 
@@ -46,11 +46,6 @@
 В противном случае о новых соединениях будет сообщаться сразу всем рабочим
 процессам, и при низкой интенсивности поступления новых соединений
 часть рабочих процессов может работать вхолостую.
-<note>
-Использование метода обработки соединений
-<link doc="events.xml" id="rtsig"/>
-требует обязательного включения <literal>accept_mutex</literal>.
-</note>
 </para>
 
 </directive>
@@ -347,11 +342,6 @@
 <link doc="events.xml" id="kqueue"/>, т.к. данный метод сам сообщает
 число новых соединений, ожидающих приёма.
 </note>
-<note>
-Использование метода обработки соединений
-<link doc="events.xml" id="rtsig"/>
-автоматически включает <literal>multi_accept</literal>.
-</note>
 </para>
 
 </directive>
@@ -669,22 +659,6 @@
 </directive>
 
 
-<directive name="worker_rlimit_sigpending">
-<syntax><value>число</value></syntax>
-<default/>
-<context>main</context>
-
-<para>
-На системах с поддержкой метода обработки соединений
-<link doc="events.xml" id="rtsig"/>,
-изменяет ограничение на размер очереди сигналов
-(<c-def>RLIMIT_SIGPENDING</c-def>) для рабочих процессов.
-Используется для увеличения ограничения без перезапуска основного процесса.
-</para>
-
-</directive>
-
-
 <directive name="working_directory">
 <syntax><value>каталог</value></syntax>
 <default/>