nginx-site: xml/en/docs/configure.xml annotate

annotate xml/en/docs/configure.xml @ 1878:127ae107e5a9

Removed clause about shared memory and Windows versions with ASLR. Starting with nginx 1.9.0 shared memory can be used on Windows versions with address space layout randomization.

author	Maxim Dounin <mdounin@mdounin.ru>
date	Mon, 26 Dec 2016 19:38:06 +0300
parents	153a99d25210
children	d011ffde3760

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"
1749 153a99d25210 Updated versions of PCRE, zlib, and OpenSSL. Yaroslav Zhuravlev <yar@nginx.com> parents: 1653 diff changeset	11 rev="7">
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>.
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 6135f3c95bf6 Unified markup for lists. Ruslan Ermilov <ru@nginx.com> parents: 289 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	28 <command>configure</command> (except for paths to libraries sources)
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	29 and in the <path>nginx.conf</path> configuration file.
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	46 <literal>--conf-path=<value>path</value></literal>—sets
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	119 <literal>--with-select_module</literal><br/>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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
1465 eea7541e7c6a Removed "rtsig" and "worker_rlimit_sigpending". Ruslan Ermilov <ru@nginx.com> parents: 924 diff changeset	124 to support more appropriate methods such as kqueue, epoll, or /dev/poll.
263 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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	130 <literal>--with-poll_module</literal><br/>
4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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
1465 eea7541e7c6a Removed "rtsig" and "worker_rlimit_sigpending". Ruslan Ermilov <ru@nginx.com> parents: 924 diff changeset	135 to support more appropriate methods such as kqueue, epoll, or /dev/poll.
263 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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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
1749 153a99d25210 Updated versions of PCRE, zlib, and OpenSSL. Yaroslav Zhuravlev <yar@nginx.com> parents: 1653 diff changeset	183 4.4—8.39) 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 a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	185 The rest is done by nginx’s <command>./configure</command> and
a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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
1653 dad548cf5b5f Updated pcre and zlib versions. Yaroslav Zhuravlev <yar@nginx.com> parents: 1465 diff changeset	208 1.1.3—1.2.8) needs to be downloaded from the
858 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 a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	210 The rest is done by nginx’s <command>./configure</command> and
a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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 4c6d2c614d2c Cleaned up XML tag mess: Ruslan Ermilov <ru@nginx.com> parents: 264 diff changeset	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
1749 153a99d25210 Updated versions of PCRE, zlib, and OpenSSL. Yaroslav Zhuravlev <yar@nginx.com> parents: 1653 diff changeset	252 --with-pcre=../pcre-8.39
1653 dad548cf5b5f Updated pcre and zlib versions. Yaroslav Zhuravlev <yar@nginx.com> parents: 1465 diff changeset	253 --with-zlib=../zlib-1.2.8
263 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 a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	257 <para>
a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	258 After configuration,
a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	259 nginx is compiled and installed using <command>make</command>.
a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	260 </para>
a2aea48ff155 New "installation" article. Ruslan Ermilov <ru@nginx.com> parents: 858 diff changeset	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>

Mercurial > hg > nginx-site

annotate xml/en/docs/configure.xml @ 1878:127ae107e5a9