diff xml/ru/docs/http/ngx_http_core_module.xml @ 1436:2333e08e277d

Documented thread pools.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 18 Mar 2015 19:01:42 +0300
parents 9012d7935c9b
children 42f288fc9ad3
line wrap: on
line diff
--- a/xml/ru/docs/http/ngx_http_core_module.xml	Wed Mar 18 14:19:44 2015 +0000
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Wed Mar 18 19:01:42 2015 +0300
@@ -17,7 +17,8 @@
 <directive name="aio">
 <syntax>
     <literal>on</literal> |
-    <literal>off</literal></syntax>
+    <literal>off</literal> |
+    <literal>threads</literal>[<literal>=</literal><value>pool</value>]</syntax>
 <default>off</default>
 <context>http</context>
 <context>server</context>
@@ -118,6 +119,35 @@
 </para>
 
 <para>
+Кроме того, читать и <link id="sendfile">отправлять</link>
+файлы можно в многопоточном режиме (1.7.11),
+не блокируя при этом рабочий процесс:
+<example>
+location /video/ {
+    sendfile       on;
+    aio            threads;
+}
+</example>
+Операции чтения или отправки файлов будут обрабатываться потоками из указанного
+<link doc="../ngx_core_module.xml" id="thread_pool">пула</link>.
+Если пул потоков не задан явно,
+используется пул с именем “<literal>default</literal>”.
+Имя пула может быть задано при помощи переменных:
+<example>
+aio threads=pool$disk;
+</example>
+По умолчанию поддержка многопоточности выключена, её сборку следует
+разрешить с помощью конфигурационного параметра
+<literal>--with-threads</literal>.
+В настоящий момент многопоточность совместима только с методами
+<link doc="../events.xml" id="epoll"/>,
+<link doc="../events.xml" id="kqueue"/>

+<link doc="../events.xml" id="eventport"/>.
+Отправка файлов в многопоточном режиме поддерживается только на Linux.
+</para>
+
+<para>
 См. также директиву <link id="sendfile"/>.
 </para>