--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/xml/ru/docs/configure.xml	Fri May 31 13:05:51 2013 +0400
@@ -0,0 +1,255 @@
+<!--
+  Copyright (C) Igor Sysoev
+  Copyright (C) Nginx, Inc.
+  -->
+
+<!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
+
+<article name="Сборка nginx из исходных файлов"
+         link="/ru/docs/configure.html"
+         lang="ru"
+         rev="4">
+
+<section>
+
+<para>
+Сборка настраивается командой <command>configure</command>.
+Она определяет особенности системы и, в частности, методы, которые nginx
+может использовать для обработки соединений.
+В конце концов она создаёт <path>Makefile</path>.
+Команда <command>configure</command> поддерживает следующие параметры:
+<list type="bullet">
+
+<listitem>
+<para>
+<literal>--prefix=<value>путь</value></literal>&mdash;задаёт каталог,
+в котором будут находиться файлы сервера.
+Этот же каталог будет использоваться для всех относительных путей,
+задаваемых <command>configure</command> (кроме путей к исходным текстам
+библиотек) и в конфигурационном файле <path>nginx.conf</path>.
+По умолчанию&mdash;каталог <path>/usr/local/nginx</path>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--sbin-path=<value>путь</value></literal>&mdash;задаёт
+имя исполняемого файла nginx.
+Это имя используется только на стадии установки.
+По умолчанию файл называется
+<path><value>префикс</value>/sbin/nginx</path>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--conf-path=<value>путь</value></literal>&mdash;задаёт
+имя конфигурационного файла <path>nginx.conf</path>.
+При желании nginx можно всегда запустить с другим конфигурационным файлом,
+указав его в параметре командной строки
+<nobr><literal>-c <value>файл</value></literal></nobr>.
+По умолчанию файл называется
+<path><value>префикс</value>/conf/nginx.conf</path>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--pid-path=<value>путь</value></literal>&mdash;задаёт
+имя файла nginx.pid, в котором будет храниться номер главного процесса.
+После установки имя файла можно всегда поменять в конфигурационном
+файле <path>nginx.conf</path> с помощью директивы
+<link doc="ngx_core_module.xml" id="pid"/>.
+По умолчанию имя
+файла&mdash;<path><value>префикс</value>/logs/nginx.pid</path>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--error-log-path=<value>путь</value></literal>&mdash;задаёт
+имя основного файла ошибок, предупреждений и диагностики.
+После установки имя файла можно всегда поменять в конфигурационном
+файле <path>nginx.conf</path> с помощью директивы
+<link doc="ngx_core_module.xml" id="error_log"/>.
+По умолчанию имя
+файла&mdash;<path><value>префикс</value>/logs/error.log</path>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--http-log-path=<value>путь</value></literal>&mdash;задаёт
+имя основного файла регистрации запросов HTTP-сервера.
+После установки имя файла можно всегда поменять в конфигурационном
+файле <path>nginx.conf</path> с помощью директивы
+<link doc="http/ngx_http_log_module.xml" id="access_log"/>.
+По умолчанию имя
+файла&mdash;<path><value>префикс</value>/logs/access.log</path>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--user=<value>имя</value></literal>&mdash;задаёт
+имя непривилегированного пользователя, с правами которого будут
+выполняться рабочие процессы.
+После установки это имя можно всегда поменять в конфигурационном
+файле <path>nginx.conf</path> с помощью директивы
+<link doc="ngx_core_module.xml" id="user"/>.
+По умолчанию имя пользователя nobody.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--group=<value>имя</value></literal>&mdash;задаёт
+имя группы, с правами которой будут выполняться рабочие процессы.
+После установки это имя можно всегда поменять в конфигурационном
+файле <path>nginx.conf</path> с помощью директивы
+<link doc="ngx_core_module.xml" id="user"/>.
+По умолчанию группа совпадает с именем непривилегированного пользователя.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-select_module</literal><br/>
+<literal>--without-select_module</literal>&mdash;разрешает или запрещает
+сборку модуля для работы сервера с помощью метода <c-func>select</c-func>.
+Этот модуль собирается автоматически, если на платформе не обнаружено
+более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-poll_module</literal><br/>
+<literal>--without-poll_module</literal>&mdash;разрешает или запрещает
+сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>.
+Этот модуль собирается автоматически, если на платформе не обнаружено
+более подходящего метода&mdash;kqueue, epoll, rtsig или /dev/poll.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--without-http_gzip_module</literal>&mdash;запрещает сборку модуля
+<link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
+Для сборки и работы этого модуля нужна библиотека zlib.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--without-http_rewrite_module</literal>&mdash;запрещает сборку модуля
+HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать
+перенаправления и менять URI запросов</link>.
+Для сборки и работы этого модуля нужна библиотека PCRE.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--without-http_proxy_module</literal>&mdash;запрещает сборку
+<link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
+HTTP-сервера.
+<!--
+Для сборки и работы этого модуля нужна библиотека md5.
+-->
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-http_ssl_module</literal>&mdash;разрешает сборку модуля
+для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу
+HTTPS</link>.
+По умолчанию модуль не собирается.
+Для сборки и работы этого модуля нужна библиотека OpenSSL.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-pcre=<value>путь</value></literal>&mdash;задаёт
+путь к исходным текстам библиотеки PCRE.
+Дистрибутив библиотеки (версию
+4.4&mdash;8.32) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
+и распаковать.
+Всё остальное сделают <command>./configure</command> nginx’а и
+<command>make</command>.
+Библиотека нужна для использования регулярных выражений в директиве
+<link doc="http/ngx_http_core_module.xml" id="location"/>
+и для модуля
+<link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-pcre-jit</literal>&mdash;собирает библиотеку PCRE с
+поддержкой JIT-компиляции (1.1.12, директива
+<link doc="ngx_core_module.xml" id="pcre_jit"/>).
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
+путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
+1.1.3&mdash;1.2.7) нужно взять на сайте
+<link url="http://zlib.net">zlib</link> и распаковать.
+Всё остальное сделают <command>./configure</command> nginx’а и
+<command>make</command>.
+Библиотека нужна для модуля
+<link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-cc-opt=<value>параметры</value></literal>&mdash;задаёт
+дополнительные параметры, которые будут добавлены к переменной CFLAGS.
+При использовании системной библиотеки PCRE во FreeBSD, нужно указать
+<literal>--with-cc-opt="-I /usr/local/include"</literal>.
+Если нужно увеличить число файлов, с которыми может работать
+<c-func>select</c-func>, то это тоже можно задать здесь же:
+<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
+</para>
+</listitem>
+
+<listitem>
+<para>
+<literal>--with-ld-opt=<value>параметры</value></literal>&mdash;задаёт
+дополнительные параметры, которые будут использованы при линковке.
+При использовании системной библиотеки PCRE во FreeBSD, нужно указать
+<literal>--with-ld-opt="-L /usr/local/lib"</literal>.
+</para>
+</listitem>
+
+</list>
+
+</para>
+
+<para>
+Пример использования параметров (всё это нужно набрать в одной строке):
+<programlisting>
+./configure
+    --sbin-path=/usr/local/nginx/nginx
+    --conf-path=/usr/local/nginx/nginx.conf
+    --pid-path=/usr/local/nginx/nginx.pid
+    --with-http_ssl_module
+    --with-pcre=../pcre-4.4
+    --with-zlib=../zlib-1.1.3
+</programlisting>
+</para>
+
+<para>
+После конфигурации
+nginx компилируется и устанавливается с помощью <command>make</command>.
+</para>
+
+</section>
+
+</article>