Mercurial > hg > nginx-site

changeset 289:df261b1ce71f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented the --with-pcre-jit configuration parameter and the "pcre_jit" directive.
author Ruslan Ermilov <ru@nginx.com>
date Wed, 28 Dec 2011 12:51:26 +0000
parents b33d3f3cd8ca
children 15f81ed48a43
files xml/en/docs/install.xml xml/en/docs/ngx_core_module.xml xml/ru/docs/install.xml xml/ru/docs/ngx_core_module.xml
diffstat 4 files changed, 65 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/xml/en/docs/install.xml
+++ b/xml/en/docs/install.xml
@@ -188,6 +188,13 @@ module.
 
 <listitem>
 <para>
+<literal>--with-pcre-jit</literal>&mdash;builds the PCRE library with
+“just-in-time compilation” support.
+</para>
+</listitem>
+
+<listitem>
+<para>
 <literal>--with-zlib=<value>path</value></literal>&mdash;sets
 the path to the sources of the zlib library.
 The library distribution (version
--- a/xml/en/docs/ngx_core_module.xml
+++ b/xml/en/docs/ngx_core_module.xml
@@ -177,6 +177,31 @@ This directive is intended for nginx dev
 </directive>
 
 
+<directive name="pcre_jit">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>main</context>
+<appeared-in>1.1.12</appeared-in>
+
+<para>
+Enables or disables the use of “just-in-time compilation” (PCRE JIT)
+for regular expressions known at configuration parse time.
+</para>
+
+<para>
+PCRE JIT can speed up processing of regular expressions significantly.
+<note>
+The JIT is available in PCRE libraries starting from version 8.20
+built with the <literal>--enable-jit</literal> configuration parameter.
+When building the PCRE library with nginx (<literal>--with-pcre=</literal>),
+the JIT support should be enabled with the
+<literal>--with-pcre-jit</literal> configuration parameter.
+</note>
+</para>
+
+</directive>
+
+
 <directive name="pid">
 <syntax><value>file</value></syntax>
 <default>nginx.pid</default>
--- a/xml/ru/docs/install.xml
+++ b/xml/ru/docs/install.xml
@@ -182,6 +182,13 @@ 4.4&mdash;8.21) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link>
 
 <listitem>
 <para>
+<literal>--with-pcre-jit</literal>&mdash;собирает библиотеку PCRE с
+поддержкой JIT-компиляции.
+</para>
+</listitem>
+
+<listitem>
+<para>
 <literal>--with-zlib=<value>путь</value></literal>&mdash;задаёт
 путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию
 1.1.3&mdash;1.2.5) нужно взять на сайте
--- a/xml/ru/docs/ngx_core_module.xml
+++ b/xml/ru/docs/ngx_core_module.xml
@@ -174,6 +174,32 @@ include vhosts/*.conf;
 </directive>
 
 
+<directive name="pcre_jit">
+<syntax><literal>on</literal> | <literal>off</literal></syntax>
+<default>off</default>
+<context>main</context>
+<appeared-in>1.1.12</appeared-in>
+
+<para>
+Разрешает или запрещает использование JIT-компиляции (PCRE JIT)
+для регулярных выражений, известных на момент парсинга конфигурации.
+</para>
+
+<para>
+Использование PCRE JIT способно существенно ускорить обработку
+регулярных выражений.
+<note>
+Для работы JIT необходима библиотека PCRE версии 8.20 или выше,
+собранная с параметром конфигурации <literal>--enable-jit</literal>.
+При сборке библиотеки PCRE вместе с nginx (<literal>--with-pcre=</literal>),
+для включения поддержки JIT необходимо использовать параметр
+конфигурации <literal>--with-pcre-jit</literal>.
+</note>
+</para>
+
+</directive>
+
+
 <directive name="pid">
 <syntax><value>файл</value></syntax>
 <default>nginx.pid</default>