annotate xml/ru/docs/configure.xml @ 2154:ebc9fb8139e4

Reworked configure description to use tag list.
author Maxim Dounin <mdounin@mdounin.ru>
date Mon, 23 Apr 2018 21:41:03 +0300
parents 7d9c836d14bf
children fd06f014e6db
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
1 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
2 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
3 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
4 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 509
diff changeset
5
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
7
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
8 <article name="Сборка nginx из исходных файлов"
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
9 link="/ru/docs/configure.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
10 lang="ru"
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
11 rev="12">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
12
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
13 <section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
14
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
15 <para>
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
16 Сборка настраивается командой <command>configure</command>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
17 Она определяет особенности системы и, в частности, методы, которые nginx
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
18 может использовать для обработки соединений.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
19 В конце концов она создаёт <path>Makefile</path>.
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
20 Команда <command>configure</command> поддерживает следующие параметры:
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
21 <list type="tag">
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
22
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
23 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
24 <literal>--prefix=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
25 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
26 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
27 задаёт каталог, в котором будут находиться файлы сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
28 Этот же каталог будет использоваться для всех относительных путей,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
29 задаваемых <command>configure</command> (кроме путей к исходным текстам
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
30 библиотек) и в конфигурационном файле <path>nginx.conf</path>.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
31 По умолчанию&mdash;каталог <path>/usr/local/nginx</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
32 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
33
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
34 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
35 <literal>--sbin-path=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
36 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
37 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
38 задаёт имя исполняемого файла nginx.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
39 Это имя используется только на стадии установки.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
40 По умолчанию файл называется
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
41 <path><value>префикс</value>/sbin/nginx</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
42 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
43
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
44 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
45 <literal>--conf-path=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
46 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
47 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
48 задаёт имя конфигурационного файла <path>nginx.conf</path>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
49 При желании nginx можно всегда запустить с другим конфигурационным файлом,
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
50 указав его в параметре командной строки
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
51 <nobr><literal>-c <value>файл</value></literal></nobr>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
52 По умолчанию файл называется
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
53 <path><value>префикс</value>/conf/nginx.conf</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
54 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
55
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
56 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
57 <literal>--pid-path=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
58 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
59 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
60 задаёт имя файла nginx.pid, в котором будет храниться номер главного процесса.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
61 После установки имя файла можно всегда поменять в конфигурационном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
62 файле <path>nginx.conf</path> с помощью директивы
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
63 <link doc="ngx_core_module.xml" id="pid"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
64 По умолчанию имя
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
65 файла&mdash;<path><value>префикс</value>/logs/nginx.pid</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
66 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
67
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
68 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
69 <literal>--error-log-path=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
70 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
71 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
72 задаёт имя основного файла ошибок, предупреждений и диагностики.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
73 После установки имя файла можно всегда поменять в конфигурационном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
74 файле <path>nginx.conf</path> с помощью директивы
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
75 <link doc="ngx_core_module.xml" id="error_log"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
76 По умолчанию имя
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
77 файла&mdash;<path><value>префикс</value>/logs/error.log</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
78 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
79
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
80 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
81 <literal>--http-log-path=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
82 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
83 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
84 задаёт имя основного файла регистрации запросов HTTP-сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
85 После установки имя файла можно всегда поменять в конфигурационном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
86 файле <path>nginx.conf</path> с помощью директивы
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
87 <link doc="http/ngx_http_log_module.xml" id="access_log"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
88 По умолчанию имя
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
89 файла&mdash;<path><value>префикс</value>/logs/access.log</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
90 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
91
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
92 <tag-name id="build">
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
93 <literal>--build=<value>имя</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
94 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
95 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
96 задаёт необязательное имя сборки nginx.
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
97 </tag-desc>
1952
3be7279397c8 Documented the "build" parameter of the "configure" command.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1894
diff changeset
98
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
99 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
100 <literal>--user=<value>имя</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
101 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
102 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
103 задаёт имя непривилегированного пользователя, с правами которого будут
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
104 выполняться рабочие процессы.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
105 После установки это имя можно всегда поменять в конфигурационном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
106 файле <path>nginx.conf</path> с помощью директивы
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
107 <link doc="ngx_core_module.xml" id="user"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
108 По умолчанию имя пользователя nobody.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
109 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
110
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
111 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
112 <literal>--group=<value>имя</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
113 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
114 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
115 задаёт имя группы, с правами которой будут выполняться рабочие процессы.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
116 После установки это имя можно всегда поменять в конфигурационном
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
117 файле <path>nginx.conf</path> с помощью директивы
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
118 <link doc="ngx_core_module.xml" id="user"/>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
119 По умолчанию группа совпадает с именем непривилегированного пользователя.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
120 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
121
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
122 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
123 <literal>--with-select_module</literal><br/>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
124 <literal>--without-select_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
125 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
126 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
127 разрешает или запрещает сборку модуля для работы сервера
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
128 с помощью метода <c-func>select</c-func>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
129 Этот модуль собирается автоматически, если на платформе не обнаружено
1465
eea7541e7c6a Removed "rtsig" and "worker_rlimit_sigpending".
Ruslan Ermilov <ru@nginx.com>
parents: 924
diff changeset
130 более подходящего метода&mdash;kqueue, epoll или /dev/poll.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
131 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
132
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
133 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
134 <literal>--with-poll_module</literal><br/>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
135 <literal>--without-poll_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
136 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
137 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
138 разрешает или запрещает сборку модуля для работы сервера
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
139 с помощью метода <c-func>poll</c-func>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
140 Этот модуль собирается автоматически, если на платформе не обнаружено
1465
eea7541e7c6a Removed "rtsig" and "worker_rlimit_sigpending".
Ruslan Ermilov <ru@nginx.com>
parents: 924
diff changeset
141 более подходящего метода&mdash;kqueue, epoll или /dev/poll.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
142 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
143
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
144 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
145 <literal>--without-http_gzip_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
146 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
147 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
148 запрещает сборку модуля
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
149 <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
150 Для сборки и работы этого модуля нужна библиотека zlib.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
151 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
152
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
153 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
154 <literal>--without-http_rewrite_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
155 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
156 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
157 запрещает сборку модуля HTTP-сервера, позволяющего
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
158 <link doc="http/ngx_http_rewrite_module.xml">делать
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
159 перенаправления и менять URI запросов</link>.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
160 Для сборки и работы этого модуля нужна библиотека PCRE.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
161 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
162
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
163 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
164 <literal>--without-http_proxy_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
165 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
166 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
167 запрещает сборку
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
168 <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link>
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
169 HTTP-сервера.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
170 <!--
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
171 Для сборки и работы этого модуля нужна библиотека md5.
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
172 -->
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
173 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
174
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
175 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
176 <literal>--with-http_ssl_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
177 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
178 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
179 разрешает сборку модуля для работы HTTP-сервера по
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
180 <link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>.
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
181 По умолчанию модуль не собирается.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
182 Для сборки и работы этого модуля нужна библиотека OpenSSL.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
183 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
184
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
185 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
186 <literal>--with-pcre=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
187 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
188 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
189 задаёт путь к исходным текстам библиотеки PCRE.
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
190 Дистрибутив библиотеки (версию
2043
7d9c836d14bf Updated PCRE version in "Building nginx".
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2018
diff changeset
191 4.4&mdash;8.41) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
192 и распаковать.
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
193 Всё остальное сделают <command>./configure</command> nginx’а и
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
194 <command>make</command>.
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
195 Библиотека нужна для использования регулярных выражений в директиве
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
196 <link doc="http/ngx_http_core_module.xml" id="location"/>
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
197 и для модуля
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
198 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
199 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
200
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
201 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
202 <literal>--with-pcre-jit</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
203 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
204 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
205 собирает библиотеку PCRE с
659
77a3314c74a7 Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents: 625
diff changeset
206 поддержкой JIT-компиляции (1.1.12, директива
509
0e55c9a48da9 Trimmed space at EOL.
Ruslan Ermilov <ru@nginx.com>
parents: 486
diff changeset
207 <link doc="ngx_core_module.xml" id="pcre_jit"/>).
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
208 </tag-desc>
289
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 282
diff changeset
209
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
210 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
211 <literal>--with-zlib=<value>путь</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
212 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
213 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
214 задаёт путь к исходным текстам библиотеки zlib.
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
215 Дистрибутив библиотеки (версию
1894
d011ffde3760 Updated zlib and PCRE versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1749
diff changeset
216 1.1.3&mdash;1.2.11) нужно взять на сайте
858
65e75e59a714 Updated versions of external libraries and link to zlib site.
Valentin Bartenev <vbart@nginx.com>
parents: 732
diff changeset
217 <link url="http://zlib.net">zlib</link> и распаковать.
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
218 Всё остальное сделают <command>./configure</command> nginx’а и
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
219 <command>make</command>.
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
220 Библиотека нужна для модуля
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
221 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
222 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
223
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
224 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
225 <literal>--with-cc-opt=<value>параметры</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
226 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
227 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
228 задаёт дополнительные параметры, которые будут добавлены к переменной CFLAGS.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
229 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
230 <literal>--with-cc-opt="-I /usr/local/include"</literal>.
261
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
231 Если нужно увеличить число файлов, с которыми может работать
e93ece6bd34e Fixed markup (added lot of links) and grammar.
Ruslan Ermilov <ru@nginx.com>
parents: 256
diff changeset
232 <c-func>select</c-func>, то это тоже можно задать здесь же:
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
233 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
234 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
235
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
236 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
237 <literal>--with-ld-opt=<value>параметры</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
238 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
239 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
240 задаёт дополнительные параметры, которые будут использованы при линковке.
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
241 При использовании системной библиотеки PCRE во FreeBSD, нужно указать
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 261
diff changeset
242 <literal>--with-ld-opt="-L /usr/local/lib"</literal>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
243 </tag-desc>
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
244
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
245 </list>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
246
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
247 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
248
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
249 <para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
250 Пример использования параметров (всё это нужно набрать в одной строке):
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
251 <programlisting>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
252 ./configure
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
253 --sbin-path=/usr/local/nginx/nginx
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
254 --conf-path=/usr/local/nginx/nginx.conf
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
255 --pid-path=/usr/local/nginx/nginx.pid
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
256 --with-http_ssl_module
2018
7ee425a5ae29 Updated PCRE version.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1952
diff changeset
257 --with-pcre=../pcre-8.41
1894
d011ffde3760 Updated zlib and PCRE versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1749
diff changeset
258 --with-zlib=../zlib-1.2.11
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
259 </programlisting>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
260 </para>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
261
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
262 <para>
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
263 После конфигурации
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
264 nginx компилируется и устанавливается с помощью <command>make</command>.
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
265 </para>
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
266
76
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
267 </section>
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
268
4a4caa566120 Russian documentation import.
Maxim Dounin <mdounin@mdounin.ru>
parents:
diff changeset
269 </article>