+ rev="12">

@@ -18,174 +18,178 @@ is allowed to use for connection processing. At the end it creates a Makefile. The configure command supports the following parameters: - + - - ---prefix=path—defines -a directory that will keep server files. + +--prefix=path + + +defines a directory that will keep server files. This same directory will also be used for all relative paths set by configure (except for paths to libraries sources) and in the nginx.conf configuration file. It is set to the /usr/local/nginx directory by default. - - + - - ---sbin-path=path—sets -the name of an nginx executable file. + +--sbin-path=path + + +sets the name of an nginx executable file. This name is used only during installation. By default the file is named prefix/sbin/nginx. - - + - - ---conf-path=path—sets -the name of an nginx.conf configuration file. + +--conf-path=path + + +sets the name of an nginx.conf configuration file. If needs be, nginx can always be started with a different configuration file, by specifying it in the command-line parameter -c file. By default the file is named prefix/conf/nginx.conf. - - + - - ---pid-path=path—sets -the name of an nginx.pid file that will store the process ID + +--pid-path=path + + +sets the name of an nginx.pid file that will store the process ID of the main process. After installation, the file name can always be changed in the nginx.conf configuration file using the directive. By default the file is named prefix/logs/nginx.pid. - - + - - ---error-log-path=path—sets -the name of the primary error, warnings, and diagnostic file. + +--error-log-path=path + + +sets the name of the primary error, warnings, and diagnostic file. After installation, the file name can always be changed in the nginx.conf configuration file using the directive. By default the file is named prefix/logs/error.log. - - + - - ---http-log-path=path—sets -the name of the primary request log file of the HTTP server. + +--http-log-path=path + + +sets the name of the primary request log file of the HTTP server. After installation, the file name can always be changed in the nginx.conf configuration file using the directive. By default the file is named prefix/logs/access.log. - - + - - ---build=name—sets -an optional nginx build name. - - + +--build=name + + +sets an optional nginx build name. + - - ---user=name—sets -the name of an unprivileged user whose credentials will be used + +--user=name + + +sets the name of an unprivileged user whose credentials will be used by worker processes. After installation, the name can always be changed in the nginx.conf configuration file using the directive. The default user name is nobody. - - + - - ---group=name—sets -the name of a group whose credentials will be used + +--group=name + + +sets the name of a group whose credentials will be used by worker processes. After installation, the name can always be changed in the nginx.conf configuration file using the directive. By default, a group name is set to the name of an unprivileged user. - - + - - + --with-select_module
---without-select_module—enables or disables -building a module that allows the server to work with the -select method. +--without-select_module + + +enables or disables building a module that allows the server to work +with the select method. This module is built automatically if the platform does not appear to support more appropriate methods such as kqueue, epoll, or /dev/poll. - - + - - + --with-poll_module
---without-poll_module—enables or disables -building a module that allows the server to work with the -poll method. +--without-poll_module + + +enables or disables building a module that allows the server to work +with the poll method. This module is built automatically if the platform does not appear to support more appropriate methods such as kqueue, epoll, or /dev/poll. - - + - - ---without-http_gzip_module—disables building a module + +--without-http_gzip_module + + +disables building a module that compresses responses of an HTTP server. The zlib library is required to build and run this module. - - + - - ---without-http_rewrite_module—disables building a -module that allows an HTTP server to + +--without-http_rewrite_module + + +disables building a module that allows an HTTP server to redirect requests and change URI of requests. The PCRE library is required to build and run this module. - - + - - ---without-http_proxy_module—disables building an -HTTP server proxying module. + +--without-http_proxy_module + + +disables building an HTTP server +proxying module. - - + - - ---with-http_ssl_module—enables building a module -that adds the HTTPS protocol -support to an HTTP server. + +--with-http_ssl_module + + +enables building a module that adds the +HTTPS protocol support +to an HTTP server. This module is not built by default. The OpenSSL library is required to build and run this module. - - + - - ---with-pcre=path—sets -the path to the sources of the PCRE library. + +--with-pcre=path + + +sets the path to the sources of the PCRE library. The library distribution (version 4.4—8.41) needs to be downloaded from the PCRE site and extracted. @@ -196,21 +200,22 @@ and for the ngx_http_rewrite_module module. - - + - - ---with-pcre-jit—builds the PCRE library with + +--with-pcre-jit + + +builds the PCRE library with “just-in-time compilation” support (1.1.12, the directive). - - + - - ---with-zlib=path—sets -the path to the sources of the zlib library. + +--with-zlib=path + + +sets the path to the sources of the zlib library. The library distribution (version 1.1.3—1.2.11) needs to be downloaded from the zlib site and extracted. @@ -218,31 +223,30 @@ make. The library is required for the ngx_http_gzip_module module. - - + - - ---with-cc-opt=parameters—sets -additional parameters that will be added to the CFLAGS variable. + +--with-cc-opt=parameters + + +sets additional parameters that will be added to the CFLAGS variable. When using the system PCRE library under FreeBSD, --with-cc-opt="-I /usr/local/include" should be specified. If the number of files supported by select needs to be increased it can also be specified here such as this: --with-cc-opt="-D FD_SETSIZE=2048". - - + - - ---with-ld-opt=parameters—sets -additional parameters that will be used during linking. + +--with-ld-opt=parameters + + +sets additional parameters that will be used during linking. When using the system PCRE library under FreeBSD, --with-ld-opt="-L /usr/local/lib" should be specified. - - + diff -r ccc41545bf55 -r ebc9fb8139e4 xml/ru/docs/configure.xml --- a/xml/ru/docs/configure.xml Mon Apr 23 15:47:07 2018 +0300 +++ b/xml/ru/docs/configure.xml Mon Apr 23 21:41:03 2018 +0300 @@ -8,7 +8,7 @@

+ rev="12">

@@ -18,169 +18,175 @@ может использовать для обработки соединений. В конце концов она создаёт Makefile. Команда configure поддерживает следующие параметры: - + - - ---prefix=путь—задаёт каталог, -в котором будут находиться файлы сервера. + +--prefix=путь + + +задаёт каталог, в котором будут находиться файлы сервера. Этот же каталог будет использоваться для всех относительных путей, задаваемых configure (кроме путей к исходным текстам библиотек) и в конфигурационном файле nginx.conf. По умолчанию—каталог /usr/local/nginx. - - + - - ---sbin-path=путь—задаёт -имя исполняемого файла nginx. + +--sbin-path=путь + + +задаёт имя исполняемого файла nginx. Это имя используется только на стадии установки. По умолчанию файл называется префикс/sbin/nginx. - - + - - ---conf-path=путь—задаёт -имя конфигурационного файла nginx.conf. + +--conf-path=путь + + +задаёт имя конфигурационного файла nginx.conf. При желании nginx можно всегда запустить с другим конфигурационным файлом, указав его в параметре командной строки -c файл. По умолчанию файл называется префикс/conf/nginx.conf. - - + - - ---pid-path=путь—задаёт -имя файла nginx.pid, в котором будет храниться номер главного процесса. + +--pid-path=путь + + +задаёт имя файла nginx.pid, в котором будет храниться номер главного процесса. После установки имя файла можно всегда поменять в конфигурационном файле nginx.conf с помощью директивы . По умолчанию имя файла—префикс/logs/nginx.pid. - - + - - ---error-log-path=путь—задаёт -имя основного файла ошибок, предупреждений и диагностики. + +--error-log-path=путь + + +задаёт имя основного файла ошибок, предупреждений и диагностики. После установки имя файла можно всегда поменять в конфигурационном файле nginx.conf с помощью директивы . По умолчанию имя файла—префикс/logs/error.log. - - + - - ---http-log-path=путь—задаёт -имя основного файла регистрации запросов HTTP-сервера. + +--http-log-path=путь + + +задаёт имя основного файла регистрации запросов HTTP-сервера. После установки имя файла можно всегда поменять в конфигурационном файле nginx.conf с помощью директивы . По умолчанию имя файла—префикс/logs/access.log. - - + - - ---build=имя—задаёт -необязательное имя сборки nginx. - - + +--build=имя + + +задаёт необязательное имя сборки nginx. + - - ---user=имя—задаёт -имя непривилегированного пользователя, с правами которого будут + +--user=имя + + +задаёт имя непривилегированного пользователя, с правами которого будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном файле nginx.conf с помощью директивы . По умолчанию имя пользователя nobody. - - + - - ---group=имя—задаёт -имя группы, с правами которой будут выполняться рабочие процессы. + +--group=имя + + +задаёт имя группы, с правами которой будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном файле nginx.conf с помощью директивы . По умолчанию группа совпадает с именем непривилегированного пользователя. - - + - - + --with-select_module
---without-select_module—разрешает или запрещает -сборку модуля для работы сервера с помощью метода select. +--without-select_module + + +разрешает или запрещает сборку модуля для работы сервера +с помощью метода select. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll или /dev/poll. - - + - - + --with-poll_module
---without-poll_module—разрешает или запрещает -сборку модуля для работы сервера с помощью метода poll. +--without-poll_module + + +разрешает или запрещает сборку модуля для работы сервера +с помощью метода poll. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll или /dev/poll. - - + - - ---without-http_gzip_module—запрещает сборку модуля + +--without-http_gzip_module + + +запрещает сборку модуля сжатия ответов HTTP-сервера. Для сборки и работы этого модуля нужна библиотека zlib. - - + - - ---without-http_rewrite_module—запрещает сборку модуля -HTTP-сервера, позволяющего делать + +--without-http_rewrite_module + + +запрещает сборку модуля HTTP-сервера, позволяющего +делать перенаправления и менять URI запросов. Для сборки и работы этого модуля нужна библиотека PCRE. - - + - - ---without-http_proxy_module—запрещает сборку + +--without-http_proxy_module + + +запрещает сборку проксирующего модуля HTTP-сервера. - - + - - ---with-http_ssl_module—разрешает сборку модуля -для работы HTTP-сервера по протоколу -HTTPS. + +--with-http_ssl_module + + +разрешает сборку модуля для работы HTTP-сервера по +протоколу HTTPS. По умолчанию модуль не собирается. Для сборки и работы этого модуля нужна библиотека OpenSSL. - - + - - ---with-pcre=путь—задаёт -путь к исходным текстам библиотеки PCRE. + +--with-pcre=путь + + +задаёт путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию 4.4—8.41) нужно взять на сайте PCRE и распаковать. @@ -190,50 +196,51 @@ и для модуля ngx_http_rewrite_module. - - + - - ---with-pcre-jit—собирает библиотеку PCRE с + +--with-pcre-jit + + +собирает библиотеку PCRE с поддержкой JIT-компиляции (1.1.12, директива ). - - + - - ---with-zlib=путь—задаёт -путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию + +--with-zlib=путь + + +задаёт путь к исходным текстам библиотеки zlib. +Дистрибутив библиотеки (версию 1.1.3—1.2.11) нужно взять на сайте zlib и распаковать. Всё остальное сделают ./configure nginx’а и make. Библиотека нужна для модуля ngx_http_gzip_module. - - + - - ---with-cc-opt=параметры—задаёт -дополнительные параметры, которые будут добавлены к переменной CFLAGS. + +--with-cc-opt=параметры + + +задаёт дополнительные параметры, которые будут добавлены к переменной CFLAGS. При использовании системной библиотеки PCRE во FreeBSD, нужно указать --with-cc-opt="-I /usr/local/include". Если нужно увеличить число файлов, с которыми может работать select, то это тоже можно задать здесь же: --with-cc-opt="-D FD_SETSIZE=2048". - - + - - ---with-ld-opt=параметры—задаёт -дополнительные параметры, которые будут использованы при линковке. + +--with-ld-opt=параметры + + +задаёт дополнительные параметры, которые будут использованы при линковке. При использовании системной библиотеки PCRE во FreeBSD, нужно указать --with-ld-opt="-L /usr/local/lib". - - +