annotate xml/en/docs/configure.xml @ 2277:4ad2cf470ed8

Updated OpenSSL and PCRE versions.
author Yaroslav Zhuravlev <yar@nginx.com>
date Thu, 15 Nov 2018 19:09:33 +0300
parents 224ca9f697a5
children aba11629abbf
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: 486
diff changeset
1 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 486
diff changeset
2 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 486
diff changeset
3 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 486
diff changeset
4 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 486
diff changeset
5
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
7
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
8 <article name="Building nginx from Sources"
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
9 link="/en/docs/configure.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
10 lang="en"
2277
4ad2cf470ed8 Updated OpenSSL and PCRE versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2156
diff changeset
11 rev="15">
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
12
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
13 <section>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <para>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16 The build is configured using the <command>configure</command> command.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 It defines various aspects of the system, including the methods nginx
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
18 is allowed to use for connection processing.
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
19 At the end it creates a <path>Makefile</path>.
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
20 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
21
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
22 <para>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23 The <command>configure</command> command supports the following parameters:
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
24 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
25
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
26 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
27 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
28
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
29 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
30 <literal>--help</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
31 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
32 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
33 prints a help message.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
34 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
35
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
36 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
37 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
38
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
39 <para>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
40 <list type="tag">
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
42 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
43 <literal>--prefix=<value>path</value></literal>
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 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
46 defines a directory that will keep server files.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 This same directory will also be used for all relative paths set by
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
48 <command>configure</command> (except for paths to libraries sources)
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
49 and in the <path>nginx.conf</path> configuration file.
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
50 It is set to the <path>/usr/local/nginx</path> directory by default.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
51 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
53 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
54 <literal>--sbin-path=<value>path</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
55 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
56 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
57 sets the name of an nginx executable file.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 This name is used only during installation.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 By default the file is named
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
60 <path><value>prefix</value>/sbin/nginx</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
61 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
63 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
64 <literal>--modules-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
65 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
66 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
67 defines a directory where nginx dynamic modules will be installed.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
68 By default the <path><value>prefix</value>/modules</path> directory is used.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
69 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
70
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
71 <tag-name>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
72 <literal>--conf-path=<value>path</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
73 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
74 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
75 sets the name of an <path>nginx.conf</path> configuration file.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
76 If needs be, nginx can always be started with a different configuration file,
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
77 by specifying it in the command-line parameter
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
78 <nobr><literal>-c <value>file</value></literal></nobr>.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
79 By default the file is named
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
80 <path><value>prefix</value>/conf/nginx.conf</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
81 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
82
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
83 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
84 <literal>--error-log-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
85 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
86 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
87 sets the name of the primary error, warnings, and diagnostic file.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
88 After installation, the file name can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
89 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
90 <link doc="ngx_core_module.xml" id="error_log"/> directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
91 By default the file is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
92 <path><value>prefix</value>/logs/error.log</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
93 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
94
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
95 <tag-name>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
96 <literal>--pid-path=<value>path</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
97 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
98 <tag-desc>
2155
fd06f014e6db Marked nginx.pid as path in configure description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2154
diff changeset
99 sets the name of an <path>nginx.pid</path> file
fd06f014e6db Marked nginx.pid as path in configure description.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2154
diff changeset
100 that will store the process ID of the main process.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 After installation, the file name can always be changed in the
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
102 <path>nginx.conf</path> configuration file using the
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 <link doc="ngx_core_module.xml" id="pid"/> directive.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104 By default the file is named
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
105 <path><value>prefix</value>/logs/nginx.pid</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
106 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
108 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
109 <literal>--lock-path=<value>path</value></literal>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
110 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
111 <tag-desc>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
112 sets a prefix for the names of lock files.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
113 After installation, the value can always be changed in the
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
114 <path>nginx.conf</path> configuration file using the
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
115 <link doc="ngx_core_module.xml" id="lock_file"/> directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
116 By default the value is
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
117 <path><value>prefix</value>/logs/nginx.lock</path>.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
118 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
119
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
120 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
121 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
122
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
123 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
124 <list type="tag">
1952
3be7279397c8 Documented the "build" parameter of the "configure" command.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1894
diff changeset
125
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
126 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
127 <literal>--user=<value>name</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
128 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
129 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
130 sets the name of an unprivileged user whose credentials will be used
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
131 by worker processes.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 After installation, the name can always be changed in the
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
133 <path>nginx.conf</path> configuration file using the
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 <link doc="ngx_core_module.xml" id="user"/> directive.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
135 The default user name is nobody.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
136 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
138 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
139 <literal>--group=<value>name</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
140 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
141 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
142 sets the name of a group whose credentials will be used
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143 by worker processes.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 After installation, the name can always be changed in the
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
145 <path>nginx.conf</path> configuration file using the
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146 <link doc="ngx_core_module.xml" id="user"/> directive.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 By default, a group name is set to the name of an unprivileged user.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
148 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
150 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
151 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
152
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
153 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
154 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
155
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
156 <tag-name id="build">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
157 <literal>--build=<value>name</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
158 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
159 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
160 sets an optional nginx build name.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
161 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
162
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
163 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
164 <literal>--builddir=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
165 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
166 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
167 sets a build directory.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
168 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
169
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
170 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
171 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
172
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
173 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
174 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
175
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
176 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
177 <literal>--with-select_module</literal><br/>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
178 <literal>--without-select_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
179 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
180 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
181 enables or disables building a module that allows the server to work
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
182 with the <c-func>select</c-func> method.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
183 This module is built automatically if the platform does not appear
1465
eea7541e7c6a Removed "rtsig" and "worker_rlimit_sigpending".
Ruslan Ermilov <ru@nginx.com>
parents: 924
diff changeset
184 to support more appropriate methods such as kqueue, epoll, or /dev/poll.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
185 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
186
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
187 <tag-name>
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
188 <literal>--with-poll_module</literal><br/>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
189 <literal>--without-poll_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
190 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
191 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
192 enables or disables building a module that allows the server to work
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
193 with the <c-func>poll</c-func> method.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
194 This module is built automatically if the platform does not appear
1465
eea7541e7c6a Removed "rtsig" and "worker_rlimit_sigpending".
Ruslan Ermilov <ru@nginx.com>
parents: 924
diff changeset
195 to support more appropriate methods such as kqueue, epoll, or /dev/poll.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
196 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
197
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
198 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
199 <literal>--with-threads</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
200 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
201 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
202 enables the use of
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
203 <link doc="ngx_core_module.xml" id="thread_pool">thread pools</link>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
204 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
205
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
206 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
207 <literal>--with-file-aio</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
208 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
209 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
210 enables the use of
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
211 <link doc="http/ngx_http_core_module.xml" id="aio">asynchronous file I/O</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
212 (AIO) on FreeBSD and Linux.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
213 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
214
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
215 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
216 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
217
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
218 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
219 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
220
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
221 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
222 <literal>--with-http_ssl_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
223 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
224 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
225 enables building a module that adds the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
226 <link doc="http/ngx_http_ssl_module.xml">HTTPS protocol support</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
227 to an HTTP server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
228 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
229 The OpenSSL library is required to build and run this module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
230 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
231
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
232 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
233 <literal>--with-http_v2_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
234 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
235 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
236 enables building a module that provides support for
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
237 <link doc="http/ngx_http_v2_module.xml">HTTP/2</link>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
238 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
239 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
240
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
241 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
242 <literal>--with-http_realip_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
243 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
244 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
245 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
246 <link doc="http/ngx_http_realip_module.xml">ngx_http_realip_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
247 module that changes the client address to the address
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
248 sent in the specified header field.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
249 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
250 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
251
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
252 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
253 <literal>--with-http_addition_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
254 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
255 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
256 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
257 <link doc="http/ngx_http_addition_module.xml">ngx_http_addition_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
258 module that adds text before and after a response.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
259 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
260 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
261
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
262 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
263 <literal>--with-http_xslt_module</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
264 <literal>--with-http_xslt_module=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
265 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
266 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
267 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
268 <link doc="http/ngx_http_xslt_module.xml">ngx_http_xslt_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
269 module that transforms XML responses using one or more XSLT stylesheets.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
270 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
271 The <link url="http://xmlsoft.org">libxml2</link> and
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
272 <link url="http://xmlsoft.org/XSLT/">libxslt</link> libraries
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
273 are required to build and run this module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
274 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
275
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
276 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
277 <literal>--with-http_image_filter_module</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
278 <literal>--with-http_image_filter_module=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
279 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
280 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
281 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
282 <link doc="http/ngx_http_image_filter_module.xml">ngx_http_image_filter_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
283 module that transforms images in JPEG, GIF, PNG, and WebP formats.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
284 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
285 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
286
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
287 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
288 <literal>--with-http_geoip_module</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
289 <literal>--with-http_geoip_module=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
290 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
291 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
292 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
293 <link doc="http/ngx_http_geoip_module.xml">ngx_http_geoip_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
294 module that creates variables depending on the client IP address
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
295 and the precompiled
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
296 <link url="http://www.maxmind.com">MaxMind</link> databases.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
297 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
298 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
299
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
300 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
301 <literal>--with-http_sub_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
302 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
303 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
304 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
305 <link doc="http/ngx_http_sub_module.xml">ngx_http_sub_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
306 module that modifies a response by replacing one specified string by another.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
307 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
308 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
309
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
310 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
311 <literal>--with-http_dav_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
312 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
313 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
314 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
315 <link doc="http/ngx_http_dav_module.xml">ngx_http_dav_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
316 module that provides file management automation via the WebDAV protocol.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
317 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
318 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
319
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
320 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
321 <literal>--with-http_flv_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
322 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
323 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
324 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
325 <link doc="http/ngx_http_flv_module.xml">ngx_http_flv_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
326 module that provides pseudo-streaming server-side support
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
327 for Flash Video (FLV) files.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
328 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
329 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
330
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
331 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
332 <literal>--with-http_mp4_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
333 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
334 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
335 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
336 <link doc="http/ngx_http_mp4_module.xml">ngx_http_mp4_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
337 module that provides pseudo-streaming server-side support
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
338 for MP4 files.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
339 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
340 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
341
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
342 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
343 <literal>--with-http_gunzip_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
344 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
345 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
346 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
347 <link doc="http/ngx_http_gunzip_module.xml">ngx_http_gunzip_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
348 module that decompresses responses
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
349 with “<literal>Content-Encoding: gzip</literal>”
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
350 for clients that do not support “gzip” encoding method.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
351 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
352 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
353
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
354 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
355 <literal>--with-http_gzip_static_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
356 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
357 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
358 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
359 <link doc="http/ngx_http_gzip_static_module.xml">ngx_http_gzip_static_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
360 module that enables sending precompressed files
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
361 with the “<literal>.gz</literal>” filename extension instead of regular files.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
362 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
363 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
364
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
365 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
366 <literal>--with-http_auth_request_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
367 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
368 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
369 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
370 <link doc="http/ngx_http_auth_request_module.xml">ngx_http_auth_request_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
371 module that implements client authorization
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
372 based on the result of a subrequest.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
373 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
374 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
375
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
376 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
377 <literal>--with-http_random_index_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
378 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
379 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
380 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
381 <link doc="http/ngx_http_random_index_module.xml">ngx_http_random_index_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
382 module that processes requests
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
383 ending with the slash character (‘<literal>/</literal>’) and picks a random
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
384 file in a directory to serve as an index file.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
385 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
386 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
387
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
388 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
389 <literal>--with-http_secure_link_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
390 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
391 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
392 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
393 <link doc="http/ngx_http_secure_link_module.xml">ngx_http_secure_link_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
394 module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
395 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
396 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
397
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
398 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
399 <literal>--with-http_degradation_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
400 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
401 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
402 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
403 <literal>ngx_http_degradation_module</literal> module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
404 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
405 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
406
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
407 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
408 <literal>--with-http_slice_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
409 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
410 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
411 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
412 <link doc="http/ngx_http_slice_module.xml">ngx_http_slice_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
413 module that splits a request into subrequests,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
414 each returning a certain range of response.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
415 The module provides more effective caching of big responses.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
416 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
417 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
418
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
419 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
420 <literal>--with-http_stub_status_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
421 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
422 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
423 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
424 <link doc="http/ngx_http_stub_status_module.xml">ngx_http_stub_status_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
425 module that provides access to basic status information.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
426 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
427 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
428
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
429 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
430 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
431
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
432 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
433 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
434
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
435 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
436 <literal>--without-http_charset_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
437 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
438 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
439 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
440 <link doc="http/ngx_http_charset_module.xml">ngx_http_charset_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
441 module that adds the specified charset to the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
442 <header>Content-Type</header> response header field
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
443 and can additionally convert data from one charset to another.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
444 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
445
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
446 <tag-name>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
447 <literal>--without-http_gzip_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
448 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
449 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
450 disables building a module
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
451 that <link doc="http/ngx_http_gzip_module.xml">compresses responses</link>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
452 of an HTTP server.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
453 The zlib library is required to build and run this module.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
454 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
455
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
456 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
457 <literal>--without-http_ssi_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
458 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
459 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
460 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
461 <link doc="http/ngx_http_ssi_module.xml">ngx_http_ssi_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
462 module that processes SSI (Server Side Includes) commands in responses
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
463 passing through it.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
464 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
465
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
466 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
467 <literal>--without-http_userid_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
468 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
469 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
470 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
471 <link doc="http/ngx_http_userid_module.xml">ngx_http_userid_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
472 module that sets cookies suitable for client identification.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
473 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
474
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
475 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
476 <literal>--without-http_access_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
477 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
478 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
479 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
480 <link doc="http/ngx_http_access_module.xml">ngx_http_access_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
481 module that allows limiting access to certain client addresses.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
482 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
483
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
484 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
485 <literal>--without-http_auth_basic_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
486 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
487 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
488 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
489 <link doc="http/ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
490 module that allows limiting access to resources by validating the user name
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
491 and password using the “HTTP Basic Authentication” protocol.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
492 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
493
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
494 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
495 <literal>--without-http_mirror_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
496 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
497 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
498 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
499 <link doc="http/ngx_http_mirror_module.xml">ngx_http_mirror_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
500 module that implements mirroring of an original request
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
501 by creating background mirror subrequests.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
502 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
503
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
504 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
505 <literal>--without-http_autoindex_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
506 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
507 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
508 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
509 <link doc="http/ngx_http_autoindex_module.xml">ngx_http_autoindex_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
510 module that processes requests
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
511 ending with the slash character (‘<literal>/</literal>’) and produces
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
512 a directory listing in case the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
513 <link doc="http/ngx_http_index_module.xml">ngx_http_index_module</link> module
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
514 cannot find an index file.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
515 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
516
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
517 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
518 <literal>--without-http_geo_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
519 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
520 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
521 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
522 <link doc="http/ngx_http_geo_module.xml">ngx_http_geo_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
523 module that creates variables
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
524 with values depending on the client IP address.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
525 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
526
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
527 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
528 <literal>--without-http_map_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
529 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
530 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
531 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
532 <link doc="http/ngx_http_map_module.xml">ngx_http_map_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
533 module that creates variables
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
534 with values depending on values of other variables.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
535 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
536
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
537 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
538 <literal>--without-http_split_clients_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
539 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
540 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
541 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
542 <link doc="http/ngx_http_split_clients_module.xml">ngx_http_split_clients_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
543 module that creates variables for A/B testing.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
544 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
545
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
546 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
547 <literal>--without-http_referer_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
548 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
549 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
550 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
551 <link doc="http/ngx_http_referer_module.xml">ngx_http_referer_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
552 module that can block access to a site for requests with invalid values
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
553 in the <header>Referer</header> header field.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
554 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
555
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
556 <tag-name>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
557 <literal>--without-http_rewrite_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
558 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
559 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
560 disables building a module that allows an HTTP server to
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
561 <link doc="http/ngx_http_rewrite_module.xml">redirect requests and change URI
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
562 of requests</link>.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
563 The PCRE library is required to build and run this module.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
564 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
565
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
566 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
567 <literal>--without-http_proxy_module</literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
568 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
569 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
570 disables building an HTTP server
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
571 <link doc="http/ngx_http_proxy_module.xml">proxying module</link>.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
572 <!--
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
573 The MD5 library is required to build and run this module.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
574 -->
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
575 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
576
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
577 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
578 <literal>--without-http_fastcgi_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
579 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
580 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
581 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
582 <link doc="http/ngx_http_fastcgi_module.xml">ngx_http_fastcgi_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
583 module that passes requests to a FastCGI server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
584 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
585
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
586 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
587 <literal>--without-http_uwsgi_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
588 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
589 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
590 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
591 <link doc="http/ngx_http_uwsgi_module.xml">ngx_http_uwsgi_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
592 module that passes requests to a uwsgi server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
593 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
594
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
595 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
596 <literal>--without-http_scgi_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
597 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
598 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
599 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
600 <link doc="http/ngx_http_scgi_module.xml">ngx_http_scgi_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
601 module that passes requests to an SCGI server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
602 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
603
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
604 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
605 <literal>--without-http_grpc_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
606 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
607 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
608 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
609 <link doc="http/ngx_http_grpc_module.xml">ngx_http_grpc_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
610 module that passes requests to a gRPC server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
611 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
612
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
613 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
614 <literal>--without-http_memcached_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
615 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
616 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
617 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
618 <link doc="http/ngx_http_memcached_module.xml">ngx_http_memcached_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
619 module that obtains responses from a memcached server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
620 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
621
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
622 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
623 <literal>--without-http_limit_conn_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
624 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
625 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
626 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
627 <link doc="http/ngx_http_limit_conn_module.xml">ngx_http_limit_conn_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
628 module that limits the number of connections per key, for example,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
629 the number of connections from a single IP address.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
630 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
631
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
632 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
633 <literal>--without-http_limit_req_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
634 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
635 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
636 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
637 <link doc="http/ngx_http_limit_req_module.xml">ngx_http_limit_req_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
638 module that limits the request processing rate per key, for example,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
639 the processing rate of requests coming from a single IP address.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
640 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
641
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
642 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
643 <literal>--without-http_empty_gif_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
644 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
645 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
646 disables building a module that
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
647 <link doc="http/ngx_http_empty_gif_module.xml">emits single-pixel
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
648 transparent GIF</link>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
649 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
650
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
651 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
652 <literal>--without-http_browser_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
653 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
654 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
655 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
656 <link doc="http/ngx_http_browser_module.xml">ngx_http_browser_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
657 module that creates variables whose values depend on the value of the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
658 <header>User-Agent</header> request header field.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
659 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
660
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
661 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
662 <literal>--without-http_upstream_hash_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
663 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
664 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
665 disables building a module that implements the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
666 <link doc="http/ngx_http_upstream_module.xml" id="hash"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
667 load balancing method.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
668 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
669
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
670 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
671 <literal>--without-http_upstream_ip_hash_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
672 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
673 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
674 disables building a module that implements the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
675 <link doc="http/ngx_http_upstream_module.xml" id="ip_hash"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
676 load balancing method.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
677 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
678
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
679 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
680 <literal>--without-http_upstream_least_conn_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
681 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
682 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
683 disables building a module that implements the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
684 <link doc="http/ngx_http_upstream_module.xml" id="least_conn"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
685 load balancing method.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
686 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
687
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
688 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
689 <literal>--without-http_upstream_keepalive_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
690 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
691 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
692 disables building a module that provides
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
693 <link doc="http/ngx_http_upstream_module.xml" id="keepalive">caching of
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
694 connections</link> to upstream servers.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
695 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
696
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
697 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
698 <literal>--without-http_upstream_zone_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
699 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
700 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
701 disables building a module that makes it possible to store run-time state
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
702 of an upstream group in a shared memory
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
703 <link doc="http/ngx_http_upstream_module.xml" id="zone"/>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
704 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
705
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
706 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
707 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
708
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
709 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
710 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
711
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
712 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
713 <literal>--with-http_perl_module</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
714 <literal>--with-http_perl_module=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
715 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
716 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
717 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
718 <link doc="http/ngx_http_perl_module.xml">embedded Perl module</link>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
719 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
720 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
721
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
722 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
723 <literal>--with-perl_modules_path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
724 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
725 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
726 defines a directory that will keep Perl modules.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
727 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
728
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
729 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
730 <literal>--with-perl=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
731 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
732 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
733 sets the name of the Perl binary.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
734 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
735
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
736 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
737 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
738
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
739 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
740 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
741
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
742 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
743 <literal>--http-log-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
744 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
745 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
746 sets the name of the primary request log file of the HTTP server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
747 After installation, the file name can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
748 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
749 <link doc="http/ngx_http_log_module.xml" id="access_log"/> directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
750 By default the file is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
751 <path><value>prefix</value>/logs/access.log</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
752 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
753
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
754 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
755 <literal>--http-client-body-temp-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
756 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
757 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
758 defines a directory for storing temporary files
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
759 that hold client request bodies.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
760 After installation, the directory can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
761 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
762 <link doc="http/ngx_http_core_module.xml" id="client_body_temp_path"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
763 directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
764 By default the directory is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
765 <path><value>prefix</value>/client_body_temp</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
766 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
767
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
768 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
769 <literal>--http-proxy-temp-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
770 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
771 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
772 defines a directory for storing temporary files
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
773 with data received from proxied servers.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
774 After installation, the directory can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
775 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
776 <link doc="http/ngx_http_proxy_module.xml" id="proxy_temp_path"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
777 directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
778 By default the directory is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
779 <path><value>prefix</value>/proxy_temp</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
780 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
781
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
782 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
783 <literal>--http-fastcgi-temp-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
784 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
785 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
786 defines a directory for storing temporary files
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
787 with data received from FastCGI servers.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
788 After installation, the directory can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
789 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
790 <link doc="http/ngx_http_fastcgi_module.xml" id="fastcgi_temp_path"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
791 directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
792 By default the directory is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
793 <path><value>prefix</value>/fastcgi_temp</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
794 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
795
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
796 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
797 <literal>--http-uwsgi-temp-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
798 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
799 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
800 defines a directory for storing temporary files
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
801 with data received from uwsgi servers.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
802 After installation, the directory can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
803 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
804 <link doc="http/ngx_http_uwsgi_module.xml" id="uwsgi_temp_path"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
805 directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
806 By default the directory is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
807 <path><value>prefix</value>/uwsgi_temp</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
808 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
809
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
810 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
811 <literal>--http-scgi-temp-path=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
812 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
813 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
814 defines a directory for storing temporary files
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
815 with data received from SCGI servers.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
816 After installation, the directory can always be changed in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
817 <path>nginx.conf</path> configuration file using the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
818 <link doc="http/ngx_http_scgi_module.xml" id="scgi_temp_path"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
819 directive.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
820 By default the directory is named
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
821 <path><value>prefix</value>/scgi_temp</path>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
822 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
823
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
824 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
825 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
826
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
827 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
828 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
829
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
830 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
831 <literal>--without-http</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
832 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
833 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
834 disables the <link doc="http/ngx_http_core_module.xml">HTTP</link> server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
835 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
836
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
837 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
838 <literal>--without-http-cache</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
839 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
840 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
841 disables HTTP cache.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
842 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
843
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
844 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
845 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
846
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
847 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
848 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
849
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
850 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
851 <literal>--with-mail</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
852 <literal>--with-mail=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
853 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
854 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
855 enables POP3/IMAP4/SMTP
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
856 <link doc="mail/ngx_mail_core_module.xml">mail proxy</link> server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
857 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
858
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
859 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
860 <literal>--with-mail_ssl_module</literal>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
861 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
862 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
863 enables building a module that adds the
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
864 <link doc="mail/ngx_mail_ssl_module.xml">SSL/TLS protocol support</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
865 to the mail proxy server.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
866 This module is not built by default.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
867 The OpenSSL library is required to build and run this module.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
868 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
869
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
870 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
871 <literal>--without-mail_pop3_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
872 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
873 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
874 disables the <link doc="mail/ngx_mail_pop3_module.xml">POP3</link> protocol
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
875 in mail proxy server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
876 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
877
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
878 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
879 <literal>--without-mail_imap_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
880 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
881 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
882 disables the <link doc="mail/ngx_mail_imap_module.xml">IMAP</link> protocol
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
883 in mail proxy server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
884 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
885
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
886 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
887 <literal>--without-mail_smtp_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
888 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
889 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
890 disables the <link doc="mail/ngx_mail_smtp_module.xml">SMTP</link> protocol
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
891 in mail proxy server.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
892 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
893
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
894 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
895 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
896
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
897 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
898 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
899
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
900 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
901 <literal>--with-stream</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
902 <literal>--with-stream=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
903 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
904 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
905 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
906 <link doc="stream/ngx_stream_core_module.xml">stream module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
907 for generic TCP/UDP proxying and load balancing.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
908 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
909 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
910
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
911 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
912 <literal>--with-stream_ssl_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
913 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
914 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
915 enables building a module that adds the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
916 <link doc="stream/ngx_stream_ssl_module.xml">SSL/TLS protocol support</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
917 to the stream module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
918 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
919 The OpenSSL library is required to build and run this module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
920 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
921
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
922 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
923 <literal>--with-stream_realip_module</literal>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
924 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
925 <tag-desc>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
926 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
927 <link doc="http/ngx_stream_realip_module.xml">ngx_stream_realip_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
928 module that changes the client address to the address
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
929 sent in the PROXY protocol header.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
930 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
931 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
932
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
933 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
934 <literal>--with-stream_geoip_module</literal><br/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
935 <literal>--with-stream_geoip_module=dynamic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
936 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
937 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
938 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
939 <link doc="stream/ngx_stream_geoip_module.xml">ngx_stream_geoip_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
940 module that creates variables depending on the client IP address
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
941 and the precompiled
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
942 <link url="http://www.maxmind.com">MaxMind</link> databases.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
943 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
944 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
945
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
946 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
947 <literal>--with-stream_ssl_preread_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
948 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
949 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
950 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
951 <link doc="stream/ngx_stream_ssl_preread_module.xml">ngx_stream_ssl_preread_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
952 module that allows extracting information from the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
953 <link url="https://tools.ietf.org/html/rfc5246#section-7.4.1.2">ClientHello</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
954 message without terminating SSL/TLS.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
955 This module is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
956 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
957
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
958 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
959 <literal>--without-stream_limit_conn_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
960 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
961 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
962 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
963 <link doc="stream/ngx_stream_limit_conn_module.xml">ngx_stream_limit_conn_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
964 module that limits the number of connections per key, for example,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
965 the number of connections from a single IP address.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
966 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
967
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
968 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
969 <literal>--without-stream_access_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
970 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
971 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
972 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
973 <link doc="stream/ngx_stream_access_module.xml">ngx_stream_access_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
974 module that allows limiting access to certain client addresses.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
975 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
976
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
977 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
978 <literal>--without-stream_geo_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
979 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
980 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
981 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
982 <link doc="stream/ngx_stream_geo_module.xml">ngx_stream_geo_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
983 module that creates variables
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
984 with values depending on the client IP address.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
985 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
986
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
987 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
988 <literal>--without-stream_map_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
989 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
990 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
991 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
992 <link doc="stream/ngx_stream_map_module.xml">ngx_stream_map_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
993 module that creates variables
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
994 with values depending on values of other variables.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
995 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
996
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
997 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
998 <literal>--without-stream_split_clients_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
999 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1000 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1001 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1002 <link doc="stream/ngx_stream_split_clients_module.xml">ngx_stream_split_clients_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1003 module that creates variables for A/B testing.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1004 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1005
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1006 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1007 <literal>--without-stream_return_module</literal>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1008 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1009 <tag-desc>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1010 disables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1011 <link doc="stream/ngx_stream_return_module.xml">ngx_stream_return_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1012 module that sends some specified value to the client
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1013 and then closes the connection.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1014 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1015
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1016 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1017 <literal>--without-stream_upstream_hash_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1018 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1019 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1020 disables building a module that implements the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1021 <link doc="stream/ngx_stream_upstream_module.xml" id="hash"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1022 load balancing method.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1023 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1024
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1025 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1026 <literal>--without-stream_upstream_least_conn_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1027 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1028 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1029 disables building a module that implements the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1030 <link doc="stream/ngx_stream_upstream_module.xml" id="least_conn"/>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1031 load balancing method.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1032 </tag-desc>
289
df261b1ce71f Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents: 282
diff changeset
1033
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1034 <tag-name>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1035 <literal>--without-stream_upstream_zone_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1036 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1037 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1038 disables building a module that makes it possible to store run-time state
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1039 of an upstream group in a shared memory
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1040 <link doc="stream/ngx_stream_upstream_module.xml" id="zone"/>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1041 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1042
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1043 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1044 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1045
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1046 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1047 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1048
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1049 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1050 <literal>--with-google_perftools_module</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1051 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1052 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1053 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1054 <link doc="ngx_google_perftools_module.xml">ngx_google_perftools_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1055 module that enables profiling of nginx worker processes using
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1056 <link url="https://github.com/gperftools/gperftools">Google Performance Tools</link>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1057 The module is intended for nginx developers and is not built by default.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1058 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1059
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1060 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1061 <literal>--with-cpp_test_module</literal>
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1062 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1063 <tag-desc>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1064 enables building the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1065 <literal>ngx_cpp_test_module</literal> module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1066 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1067
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1068 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1069 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1070
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1071 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1072 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1073
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1074 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1075 <literal>--add-module=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1076 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1077 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1078 enables an external module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1079 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1080
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1081 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1082 <literal>--add-dynamic-module=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1083 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1084 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1085 enables an external dynamic module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1086 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1087
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1088 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1089 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1090
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1091 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1092 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1093
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1094 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1095 <literal>--with-compat</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1096 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1097 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1098 enables dynamic modules compatibility.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1099 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1100
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1101 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1102 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1103
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1104 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1105 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1106
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1107 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1108 <literal>--with-cc=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1109 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1110 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1111 sets the name of the C compiler.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1112 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1113
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1114 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1115 <literal>--with-cpp=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1116 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1117 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1118 sets the name of the C preprocessor.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1119 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1120
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1121 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1122 <literal>--with-cc-opt=<value>parameters</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1123 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1124 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1125 sets additional parameters that will be added to the CFLAGS variable.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1126 When using the system PCRE library under FreeBSD,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
1127 <literal>--with-cc-opt="-I /usr/local/include"</literal>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1128 should be specified.
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1129 If the number of files supported by <c-func>select</c-func> needs to be
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1130 increased it can also be specified here such as this:
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
1131 <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
1132 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1133
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1134 <tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1135 <literal>--with-ld-opt=<value>parameters</value></literal>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1136 </tag-name>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1137 <tag-desc>
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1138 sets additional parameters that will be used during linking.
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1139 When using the system PCRE library under FreeBSD,
271
4c6d2c614d2c Cleaned up XML tag mess:
Ruslan Ermilov <ru@nginx.com>
parents: 264
diff changeset
1140 <literal>--with-ld-opt="-L /usr/local/lib"</literal>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1141 should be specified.
2154
ebc9fb8139e4 Reworked configure description to use tag list.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2043
diff changeset
1142 </tag-desc>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1143
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1144 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1145 <literal>--with-cpu-opt=<value>cpu</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1146 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1147 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1148 enables building per specified CPU:
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1149 <literal>pentium</literal>, <literal>pentiumpro</literal>,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1150 <literal>pentium3</literal>, <literal>pentium4</literal>,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1151 <literal>athlon</literal>, <literal>opteron</literal>,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1152 <literal>sparc32</literal>, <literal>sparc64</literal>,
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1153 <literal>ppc64</literal>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1154 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1155
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1156 </list>
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1157 </para>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1158
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1159 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1160 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1161
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1162 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1163 <literal>--without-pcre</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1164 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1165 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1166 disables the usage of the PCRE library.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1167 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1168
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1169 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1170 <literal>--with-pcre</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1171 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1172 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1173 forces the usage of the PCRE library.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1174 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1175
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1176 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1177 <literal>--with-pcre=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1178 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1179 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1180 sets the path to the sources of the PCRE library.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1181 The library distribution (version
2277
4ad2cf470ed8 Updated OpenSSL and PCRE versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2156
diff changeset
1182 4.4&mdash;8.42) needs to be downloaded from the
2156
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1183 <link url="http://www.pcre.org">PCRE</link> site and extracted.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1184 The rest is done by nginx’s <command>./configure</command> and
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1185 <command>make</command>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1186 The library is required for regular expressions support in the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1187 <link doc="http/ngx_http_core_module.xml" id="location"/> directive
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1188 and for the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1189 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1190 module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1191 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1192
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1193 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1194 <literal>--with-pcre-opt=<value>parameters</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1195 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1196 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1197 sets additional build options for PCRE.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1198 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1199
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1200 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1201 <literal>--with-pcre-jit</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1202 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1203 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1204 builds the PCRE library with
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1205 “just-in-time compilation” support (1.1.12, the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1206 <link doc="ngx_core_module.xml" id="pcre_jit"/> directive).
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1207 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1208
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1209 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1210 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1211
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1212 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1213 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1214
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1215 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1216 <literal>--with-zlib=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1217 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1218 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1219 sets the path to the sources of the zlib library.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1220 The library distribution (version
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1221 1.1.3&mdash;1.2.11) needs to be downloaded from the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1222 <link url="http://zlib.net">zlib</link> site and extracted.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1223 The rest is done by nginx’s <command>./configure</command> and
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1224 <command>make</command>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1225 The library is required for the
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1226 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link> module.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1227 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1228
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1229 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1230 <literal>--with-zlib-opt=<value>parameters</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1231 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1232 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1233 sets additional build options for zlib.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1234 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1235
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1236 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1237 <literal>--with-zlib-asm=<value>cpu</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1238 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1239 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1240 enables the use of the zlib assembler sources optimized
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1241 for one of the specified CPUs:
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1242 <literal>pentium</literal>, <literal>pentiumpro</literal>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1243 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1244
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1245 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1246 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1247
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1248 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1249 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1250
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1251 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1252 <literal>--with-libatomic</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1253 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1254 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1255 forces the libatomic_ops library usage.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1256 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1257
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1258 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1259 <literal>--with-libatomic=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1260 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1261 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1262 sets the path to the libatomic_ops library sources.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1263 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1264
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1265 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1266 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1267
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1268 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1269 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1270
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1271 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1272 <literal>--with-openssl=<value>path</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1273 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1274 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1275 sets the path to the OpenSSL library sources.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1276 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1277
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1278 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1279 <literal>--with-openssl-opt=<value>parameters</value></literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1280 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1281 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1282 sets additional build options for OpenSSL.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1283 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1284
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1285 </list>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1286 </para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1287
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1288 <para>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1289 <list type="tag">
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1290
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1291 <tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1292 <literal>--with-debug</literal>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1293 </tag-name>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1294 <tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1295 enables the <link doc="debugging_log.xml">debugging log</link>.
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1296 </tag-desc>
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1297
224ca9f697a5 Documented all configure options.
Maxim Dounin <mdounin@mdounin.ru>
parents: 2155
diff changeset
1298 </list>
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1299 </para>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1300
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1301 <para>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1302 Example of parameters usage (all of this needs to be typed in one line):
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1303 <programlisting>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1304 ./configure
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1305 --sbin-path=/usr/local/nginx/nginx
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1306 --conf-path=/usr/local/nginx/nginx.conf
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1307 --pid-path=/usr/local/nginx/nginx.pid
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1308 --with-http_ssl_module
2277
4ad2cf470ed8 Updated OpenSSL and PCRE versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 2156
diff changeset
1309 --with-pcre=../pcre-8.42
1894
d011ffde3760 Updated zlib and PCRE versions.
Yaroslav Zhuravlev <yar@nginx.com>
parents: 1749
diff changeset
1310 --with-zlib=../zlib-1.2.11
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1311 </programlisting>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1312 </para>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1313
924
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
1314 <para>
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
1315 After configuration,
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
1316 nginx is compiled and installed using <command>make</command>.
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
1317 </para>
a2aea48ff155 New "installation" article.
Ruslan Ermilov <ru@nginx.com>
parents: 858
diff changeset
1318
263
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1319 </section>
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1320
be3772a799a2 English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1321 </article>