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
+++ b/xml/en/docs/configure.xml
@@ -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 @@ By default, a group name is set to the n
 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 @@ to support more appropriate methods such
 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
+++ b/xml/en/docs/control.xml
@@ -8,7 +8,7 @@
 <article name="Controlling nginx"
          link="/en/docs/control.html"
          lang="en"
-         rev="5">
+         rev="6">
 
 <section>
 
@@ -189,15 +189,6 @@ 36267 36264 nobody   0.0  1364 kqread ng
 </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
+++ b/xml/en/docs/events.xml
@@ -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 @@ that add epoll support to 2.4 kernels.
 </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
+++ 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="13">
+        rev="14">
 
 <section id="example" name="Example Configuration">
 
@@ -46,11 +46,6 @@ worker processes will accept new connect
 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 @@ The directive is ignored if <link doc="e
 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 @@ Used to increase the limit without resta
 </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
+++ b/xml/ru/docs/configure.xml
@@ -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
+++ b/xml/ru/docs/control.xml
@@ -8,7 +8,7 @@
 <article name="Управление nginx"
          link="/ru/docs/control.html"
          lang="ru"
-         rev="5">
+         rev="6">
 
 <section>
 
@@ -180,15 +180,6 @@ 36267 36264 nobody   0.0  1364 kqread ng
 </para>
 
 <para>
-<note>
-При использовании метода rtsig новые процессы могут не принимать соединения
-даже после того, как старому главному процессу послан сигнал WINCH.
-В этом случае новому главному процессу нужно посылать сигнал USR1 до тех пор,
-пока новые процессы не начнут принимать соединения.
-</note>
-</para>
-
-<para>
 По истечении времени запросы будут обрабатывать только новые рабочие процессы:
 <programlisting>
   PID  PPID USER    %CPU   VSZ WCHAN  COMMAND
--- 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="2">
+         rev="3">
 
 <section>
 
@@ -66,28 +66,6 @@ nginx поддерживает различные методы обработки соединений.
 </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
+++ b/xml/ru/docs/example.xml
@@ -8,7 +8,7 @@
 <article name="Пример конфигурации nginx"
          link="/ru/docs/example.html"
          lang="ru"
-         rev="1">
+         rev="2">
 
 <section>
 
@@ -32,7 +32,7 @@ error_log  /var/log/nginx.error_log  inf
 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
+++ b/xml/ru/docs/ngx_core_module.xml
@@ -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 @@ events {
 В противном случае о новых соединениях будет сообщаться сразу всем рабочим
 процессам, и при низкой интенсивности поступления новых соединений
 часть рабочих процессов может работать вхолостую.
-<note>
-Использование метода обработки соединений
-<link doc="events.xml" id="rtsig"/>
-требует обязательного включения <literal>accept_mutex</literal>.
-</note>
 </para>
 
 </directive>
@@ -347,11 +342,6 @@ include vhosts/*.conf;
 <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 @@ worker_priority -10;
 </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/>