Mercurial > hg > nginx-site
annotate xml/en/docs/configure.xml @ 1009:135920b5c61d
Marked strings with entities in japanese translation as literal.
This allows to preserve information and produce correct output if the XML
parser expands entities on input. The markup is similar to english and
russian versions of the document.
author | Vladimir Homutov <vl@nginx.com> |
---|---|
date | Mon, 11 Nov 2013 11:54:16 +0400 |
parents | a2aea48ff155 |
children | eea7541e7c6a |
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 | 8 <article name="Building nginx from Sources" |
9 link="/en/docs/configure.html" | |
589 | 10 lang="en" |
924 | 11 rev="4"> |
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 | 19 At the end it creates a <path>Makefile</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
20 The <command>configure</command> command supports the following parameters: |
461 | 21 <list type="bullet"> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
22 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
23 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
24 <para> |
271 | 25 <literal>--prefix=<value>path</value></literal>—defines |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
26 a directory that will keep server files. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
27 This same directory will also be used for all relative paths set by |
271 | 28 <command>configure</command> (except for paths to libraries sources) |
29 and in the <path>nginx.conf</path> configuration file. | |
30 It is set to the <path>/usr/local/nginx</path> directory by default. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
31 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
32 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
33 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
34 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
35 <para> |
271 | 36 <literal>--sbin-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
37 the name of an nginx executable file. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
38 This name is used only during installation. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
39 By default the file is named |
271 | 40 <path><value>prefix</value>/sbin/nginx</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
41 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
42 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
43 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
44 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
45 <para> |
271 | 46 <literal>--conf-path=<value>path</value></literal>—sets |
47 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
|
48 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
|
49 by specifying it in the command-line parameter |
271 | 50 <nobr><literal>-c <value>file</value></literal></nobr>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
51 By default the file is named |
271 | 52 <path><value>prefix</value>/conf/nginx.conf</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
53 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
54 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
55 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
56 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
57 <para> |
271 | 58 <literal>--pid-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
59 the name of an nginx.pid file that will store the process ID |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
60 of the main process. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
61 After installation, the file name can always be changed in the |
271 | 62 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
63 <link doc="ngx_core_module.xml" id="pid"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
64 By default the file is named |
271 | 65 <path><value>prefix</value>/logs/nginx.pid</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
66 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
67 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
68 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
69 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
70 <para> |
271 | 71 <literal>--error-log-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
72 the name of the primary error, warnings, and diagnostic file. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
73 After installation, the file name can always be changed in the |
271 | 74 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
75 <link doc="ngx_core_module.xml" id="error_log"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
76 By default the file is named |
271 | 77 <path><value>prefix</value>/logs/error.log</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
78 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
79 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
80 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
81 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
82 <para> |
271 | 83 <literal>--http-log-path=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
84 the name of the primary request log file of the HTTP server. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
85 After installation, the file name can always be changed in the |
271 | 86 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
87 <link doc="http/ngx_http_log_module.xml" id="access_log"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
88 By default the file is named |
271 | 89 <path><value>prefix</value>/logs/access.log</path>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
90 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
91 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
92 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
93 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
94 <para> |
271 | 95 <literal>--user=<value>name</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
96 the name of an unprivileged user whose credentials will be used |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
97 by worker processes. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
98 After installation, the name can always be changed in the |
271 | 99 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
100 <link doc="ngx_core_module.xml" id="user"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
101 The default user name is nobody. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
102 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
103 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
104 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
105 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
106 <para> |
271 | 107 <literal>--group=<value>name</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
108 the name of a group whose credentials will be used |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
109 by worker processes. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
110 After installation, the name can always be changed in the |
271 | 111 <path>nginx.conf</path> configuration file using the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
112 <link doc="ngx_core_module.xml" id="user"/> directive. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
113 By default, a group name is set to the name of an unprivileged user. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
114 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
115 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
116 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
117 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
118 <para> |
271 | 119 <literal>--with-select_module</literal><br/> |
120 <literal>--without-select_module</literal>—enables or disables | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
121 building a module that allows the server to work with the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
122 <c-func>select</c-func> method. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
123 This module is built automatically if the platform does not appear |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
124 to support more appropriate methods such as kqueue, epoll, rtsig, or /dev/poll. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
125 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
126 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
127 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
128 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
129 <para> |
271 | 130 <literal>--with-poll_module</literal><br/> |
131 <literal>--without-poll_module</literal>—enables or disables | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
132 building a module that allows the server to work with the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
133 <c-func>poll</c-func> method. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
134 This module is built automatically if the platform does not appear |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
135 to support more appropriate methods such as kqueue, epoll, rtsig, or /dev/poll. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
136 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
137 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
138 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
139 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
140 <para> |
271 | 141 <literal>--without-http_gzip_module</literal>—disables building a module |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
142 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
|
143 of an HTTP server. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
144 The zlib library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
145 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
146 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
147 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
148 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
149 <para> |
271 | 150 <literal>--without-http_rewrite_module</literal>—disables building a |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
151 module that allows an HTTP server to |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
152 <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
|
153 of requests</link>. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
154 The PCRE library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
155 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
156 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
157 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
158 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
159 <para> |
271 | 160 <literal>--without-http_proxy_module</literal>—disables building an |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
161 HTTP server <link doc="http/ngx_http_proxy_module.xml">proxying module</link>. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
162 <!-- |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
163 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
|
164 --> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
165 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
166 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
167 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
168 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
169 <para> |
271 | 170 <literal>--with-http_ssl_module</literal>—enables building a module |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
171 that adds the <link doc="http/ngx_http_ssl_module.xml">HTTPS protocol |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
172 support</link> to an HTTP server. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
173 This module is not built by default. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
174 The OpenSSL library is required to build and run this module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
175 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
176 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
177 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
178 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
179 <para> |
271 | 180 <literal>--with-pcre=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
181 the path to the sources of the PCRE library. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
182 The library distribution (version |
858
65e75e59a714
Updated versions of external libraries and link to zlib site.
Valentin Bartenev <vbart@nginx.com>
parents:
732
diff
changeset
|
183 4.4—8.32) needs to be downloaded from the |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
184 <link url="http://www.pcre.org">PCRE</link> site and extracted. |
924 | 185 The rest is done by nginx’s <command>./configure</command> and |
186 <command>make</command>. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
187 The library is required for regular expressions support in the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
188 <link doc="http/ngx_http_core_module.xml" id="location"/> directive |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
189 and for the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
190 <link doc="http/ngx_http_rewrite_module.xml">ngx_http_rewrite_module</link> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
191 module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
192 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
193 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
194 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
195 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
196 <para> |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
197 <literal>--with-pcre-jit</literal>—builds the PCRE library with |
659
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
625
diff
changeset
|
198 “just-in-time compilation” support (1.1.12, the |
77a3314c74a7
Avoid the uses of second person.
Ruslan Ermilov <ru@nginx.com>
parents:
625
diff
changeset
|
199 <link doc="ngx_core_module.xml" id="pcre_jit"/> directive). |
289
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
200 </para> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
201 </listitem> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
202 |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
203 <listitem> |
df261b1ce71f
Documented the --with-pcre-jit configuration parameter
Ruslan Ermilov <ru@nginx.com>
parents:
282
diff
changeset
|
204 <para> |
271 | 205 <literal>--with-zlib=<value>path</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
206 the path to the sources of the zlib library. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
207 The library distribution (version |
858
65e75e59a714
Updated versions of external libraries and link to zlib site.
Valentin Bartenev <vbart@nginx.com>
parents:
732
diff
changeset
|
208 1.1.3—1.2.7) needs to be downloaded from the |
65e75e59a714
Updated versions of external libraries and link to zlib site.
Valentin Bartenev <vbart@nginx.com>
parents:
732
diff
changeset
|
209 <link url="http://zlib.net">zlib</link> site and extracted. |
924 | 210 The rest is done by nginx’s <command>./configure</command> and |
211 <command>make</command>. | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
212 The library is required for the |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
213 <link doc="http/ngx_http_gzip_module.xml">ngx_http_gzip_module</link> module. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
214 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
215 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
216 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
217 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
218 <para> |
271 | 219 <literal>--with-cc-opt=<value>parameters</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
220 additional parameters that will be added to the CFLAGS variable. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
221 When using the system PCRE library under FreeBSD, |
271 | 222 <literal>--with-cc-opt="-I /usr/local/include"</literal> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
223 should be specified. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
224 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
|
225 increased it can also be specified here such as this: |
271 | 226 <literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
227 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
228 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
229 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
230 <listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
231 <para> |
271 | 232 <literal>--with-ld-opt=<value>parameters</value></literal>—sets |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
233 additional parameters that will be used during linking. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
234 When using the system PCRE library under FreeBSD, |
271 | 235 <literal>--with-ld-opt="-L /usr/local/lib"</literal> |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
236 should be specified. |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
237 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
238 </listitem> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
239 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
240 </list> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
241 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
242 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
243 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
244 <para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
245 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
|
246 <programlisting> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
247 ./configure |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
248 --sbin-path=/usr/local/nginx/nginx |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
249 --conf-path=/usr/local/nginx/nginx.conf |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
250 --pid-path=/usr/local/nginx/nginx.pid |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
251 --with-http_ssl_module |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
252 --with-pcre=../pcre-4.4 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
253 --with-zlib=../zlib-1.1.3 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
254 </programlisting> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
255 </para> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
256 |
924 | 257 <para> |
258 After configuration, | |
259 nginx is compiled and installed using <command>make</command>. | |
260 </para> | |
261 | |
263
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
262 </section> |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
263 |
be3772a799a2
English translation of "Installing nginx".
Ruslan Ermilov <ru@nginx.com>
parents:
diff
changeset
|
264 </article> |