Mercurial > hg > nginx-site
changeset 271:4c6d2c614d2c
Cleaned up XML tag mess:
- all of <parameter> and <code>, and some of <dirname>, <value>,
and <command> were replaced by <literal>;
- the rest of <dirname> were replaced by links;
- <argument> were replaced by <value>;
- <value> is now rendered in HTML in italic;
- <literal> and <path> can now contain <value>.
Cleaned up terminology mess:
- directives take "parameters".
line wrap: on
line diff
--- a/dtd/content.dtd +++ b/dtd/content.dtd @@ -6,8 +6,8 @@ > <!ELEMENT para (#PCDATA | a | link | br | list | orderedlist | note | - i | b | nobr | table | url | code | command | - dirname | path | header | value | programlisting | + i | b | nobr | table | url | literal | command | + path | header | value | programlisting | initial | development_version | stable_version | registered | c-func)* > @@ -28,9 +28,8 @@ <!ELEMENT i (#PCDATA) > <!ELEMENT b (#PCDATA) > <!ELEMENT command (#PCDATA | value)* > -<!ELEMENT dirname (#PCDATA | i)* > -<!ELEMENT path (#PCDATA | development_version | stable_version)* > -<!ELEMENT code (#PCDATA | i)* > +<!ELEMENT path (#PCDATA | value | development_version | stable_version)* > +<!ELEMENT literal (#PCDATA | value)* > <!ELEMENT header (#PCDATA) > <!ELEMENT initial (#PCDATA) > <!ELEMENT url (#PCDATA) > @@ -39,21 +38,21 @@ <!ELEMENT registered (#PCDATA) > <!ELEMENT c-func (#PCDATA)* > -<!ELEMENT programlisting (#PCDATA | i | b | dirname | path | +<!ELEMENT programlisting (#PCDATA | i | b | path | development_version | stable_version)* > -<!ELEMENT nobr (#PCDATA | i | b | code | command | dirname | path)* > +<!ELEMENT nobr (#PCDATA | b | command | i | literal | path)* > <!ELEMENT list (item+ | listitem+) > <!ELEMENT orderedlist (item+) > <!ELEMENT item (#PCDATA | para | a | br | nobr | list | i | b | url | - dirname | path | command | value | programlisting | - link | registered | code)* > + path | command | value | programlisting | + link | registered | literal)* > <!ELEMENT listitem (#PCDATA | para | a | br | nobr | list | i | b | url | - dirname | path | command | value | programlisting)* > + path | literal | value | programlisting)* > <!ELEMENT note (#PCDATA | para | a | br | list | orderedlist | i | b | - nobr | table | url | code | command | dirname | path | + nobr | table | url | literal | command | path | header | programlisting | initial | paypal | development_version | stable_version )* > @@ -63,7 +62,7 @@ width CDATA #IMPLIED > <!ELEMENT tr (td+) > -<!ELEMENT td (#PCDATA | code | i)* > +<!ELEMENT td (#PCDATA | literal | i)* > <!ATTLIST td width CDATA #IMPLIED >
--- a/dtd/module.dtd +++ b/dtd/module.dtd @@ -17,7 +17,7 @@ name ID #REQUIRED > -<!ELEMENT syntax (#PCDATA | argument | code | parameter | value)* > +<!ELEMENT syntax (#PCDATA | literal | value)* > <!ATTLIST syntax block (yes | no) "no" > @@ -28,25 +28,21 @@ <!ELEMENT appeared-in (#PCDATA)* > -<!ELEMENT para (#PCDATA | argument | c-def | c-func | code | command | +<!ELEMENT para (#PCDATA | c-def | c-func | command | emphasis | example | header | http-status | link | - list | note | parameter | path | value | var)* > - -<!ELEMENT argument (#PCDATA)* > + list | literal | note | path | value | var)* > <!ELEMENT c-def (#PCDATA)* > <!ELEMENT c-func (#PCDATA)* > -<!ELEMENT code (#PCDATA | value)* > - <!ELEMENT command (#PCDATA)* > <!ELEMENT emphasis (#PCDATA | value)* > <!ELEMENT example (#PCDATA | value | emphasis)* > -<!ELEMENT header (#PCDATA | argument)* > +<!ELEMENT header (#PCDATA | value)* > <!ELEMENT http-status EMPTY > <!ATTLIST http-status @@ -70,9 +66,9 @@ <!ELEMENT tag-name ANY > <!ELEMENT tag-desc ANY > -<!ELEMENT note ANY > +<!ELEMENT literal (#PCDATA)* > -<!ELEMENT parameter (#PCDATA)* > +<!ELEMENT note ANY > <!ELEMENT path (#PCDATA)* >
--- a/xml/en/docs/debugging_log.xml +++ b/xml/en/docs/debugging_log.xml @@ -15,7 +15,7 @@ debugging during the build: ./configure --with-debug ... </programlisting> -Then the <value>debug</value> level should be set with the +Then the <literal>debug</literal> level should be set with the <link doc="ngx_core_module.xml" id="error_log"/> directive: <programlisting> @@ -23,11 +23,12 @@ error_log /path/to/log debug; </programlisting> The nginx binary version for Windows is always built with the debugging log -support, so only setting the <value>debug</value> level will suffice. +support, so only setting the <literal>debug</literal> level will suffice. </para> <para> -Note that redefining the log without also specifying the <value>debug</value> +Note that redefining the log without also specifying the +<literal>debug</literal> level will disable the debugging log. In the example below, redefining the log on the <link doc="http/ngx_http_core_module.xml" id="server"/> @@ -41,7 +42,7 @@ http { ... </programlisting> To avoid this, either the line redefining the log should be -commented out, or the <value>debug</value> level specification should +commented out, or the <literal>debug</literal> level specification should also be added: <programlisting> error_log /path/to/log debug;
--- a/xml/en/docs/freebsd_tuning.xml +++ b/xml/en/docs/freebsd_tuning.xml @@ -100,10 +100,10 @@ By default nginx uses the maximum value When a client sends a data, the data first is received by the kernel which places the data in the socket receiving buffer. Then an application such as the web server -may call <code>recv()</code> or <code>read()</code> system calls +may call <c-func>recv</c-func> or <c-func>read</c-func> system calls to get the data from the buffer. When the application wants to send a data, it calls -<code>send()</code> or <code>write()</code> +<c-func>send</c-func> or <c-func>write</c-func> system calls to place the data in the socket sending buffer. Then the kernel manages to send the data from the buffer to the client. In modern FreeBSD versions the default sizes of the socket receiving @@ -239,7 +239,7 @@ and memory usage by using the cached fil <para> And again, the amd64 sendfile implementation is the best: -the zeros in the <nobr>“<code>netstat -m</code>”</nobr> output +the zeros in the <nobr>“<literal>netstat -m</literal>”</nobr> output <programlisting> ... <b>0/0/0</b> sfbufs in use (current/peak/max)
--- a/xml/en/docs/http/configuring_https_servers.xml +++ b/xml/en/docs/http/configuring_https_servers.xml @@ -43,11 +43,12 @@ only the certificate is sent to a client </para> <para> -The directives <dirname>ssl_protocols</dirname> and -<dirname>ssl_ciphers</dirname> can be used to limit connections +The directives <link doc="ngx_http_ssl_module.xml" id="ssl_protocols"/> and +<link doc="ngx_http_ssl_module.xml" id="ssl_ciphers"/> +can be used to limit connections to include only the strong versions and ciphers of SSL/TLS. -Since version 1.0.5, nginx uses <dirname>ssl_protocols SSLv3 TLSv1</dirname> -and <dirname>ssl_ciphers HIGH:!aNULL:!MD5</dirname> by default, +Since version 1.0.5, nginx uses “<literal>ssl_protocols SSLv3 TLSv1</literal>” +and “<literal>ssl_ciphers HIGH:!aNULL:!MD5</literal>” by default, so configuring them explicitly only makes sense for the earlier nginx versions. </para> @@ -78,10 +79,14 @@ the first is by enabling keepalive conne requests via one connection and the second is to reuse SSL session parameters to avoid SSL handshakes for parallel and subsequent connections. The sessions are stored in an SSL session cache shared between workers -and configured by an <dirname>ssl_session_cache</dirname> directive. +and configured by the +<link doc="ngx_http_ssl_module.xml" id="ssl_session_cache"/> +directive. One megabyte of the cache contains about 4000 sessions. -The default cache timeout is 5 minutes. It can be increased by using -the <dirname>ssl_session_timeout</dirname> directive. +The default cache timeout is 5 minutes. +It can be increased by using the +<link doc="ngx_http_ssl_module.xml" id="ssl_session_timeout"/> +directive. Here is a sample configuration optimized for a quad core system with 10M shared session cache: @@ -128,7 +133,8 @@ in the combined file: $ cat www.nginx.com.crt bundle.crt > www.nginx.com.chained.crt </programlisting> -The resulting file should be used in the <dirname>ssl_certificate</dirname> +The resulting file should be used in the +<link doc="ngx_http_ssl_module.xml" id="ssl_certificate"/> directive: <programlisting> @@ -216,8 +222,8 @@ and using a consolidated server may beco However, if HTTP and HTTPS servers are equal, and you prefer not to think about the future, you may configure a single server that handles both HTTP and HTTPS requests -by deleting the directive <dirname>ssl on</dirname> -and adding the <dirname>ssl</dirname> parameter for *:443 port: +by deleting the directive “<literal>ssl on</literal>” +and adding the <literal>ssl</literal> parameter for *:443 port: <programlisting> server { @@ -231,8 +237,8 @@ server { </programlisting> <note> -Prior to 0.8.21, nginx only allows the <dirname>ssl</dirname> parameter -to be set on listen sockets with the <dirname>default</dirname> parameter: +Prior to 0.8.21, nginx only allows the <literal>ssl</literal> parameter +to be set on listen sockets with the <literal>default</literal> parameter: <programlisting> listen 443 default ssl; </programlisting> @@ -428,7 +434,8 @@ since 0.8.21 and 0.7.62. </item> <item> -The <dirname>ssl</dirname> parameter of the <dirname>listen</dirname> +The <literal>ssl</literal> parameter of the +<link doc="ngx_http_core_module.xml" id="listen"/> directive has been supported since 0.7.14. </item> @@ -463,22 +470,22 @@ SSLv3, and TLSv1. <item> Version 1.0.5 and later: the default SSL ciphers are -<dirname>HIGH:!aNULL:!MD5</dirname>. +“<literal>HIGH:!aNULL:!MD5</literal>”. </item> <item> Version 0.7.65, 0.8.20 and later: the default SSL ciphers are -<dirname>HIGH:!ADH:!MD5</dirname>. +“<literal>HIGH:!ADH:!MD5</literal>”. </item> <item> Version 0.8.19: the default SSL ciphers are -<dirname>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM</dirname>. +“<literal>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM</literal>”. </item> <item> Version 0.7.64, 0.8.18 and earlier: the default SSL ciphers are<br/> -<dirname>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP</dirname>. +“<literal>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP</literal>”. </item> </list>
--- a/xml/en/docs/http/ngx_http_core_module.xml +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -10,9 +10,9 @@ <directive name="aio"> <syntax> - <value>on</value> | - <value>off</value> | - <value>sendfile</value></syntax> + <literal>on</literal> | + <literal>off</literal> | + <literal>sendfile</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -132,7 +132,7 @@ is used. <directive name="alias"> -<syntax><argument>path</argument></syntax> +<syntax><value>path</value></syntax> <default/> <context>location</context> @@ -145,20 +145,20 @@ location /i/ { } </example> the request of -“<code>/i/top.gif</code>” will be responded +“<literal>/i/top.gif</literal>” will be responded with the file <path>/data/w3/images/top.gif</path>. </para> <para> -The <argument>path</argument> value can contain variables +The <value>path</value> value can contain variables except <var>$document_root</var> and <var>$realpath_root</var>. </para> <para> -If <code>alias</code> is used inside a location defined +If <literal>alias</literal> is used inside a location defined with a regular expression then such regular expression should -contain captures and <code>alias</code> should refer to +contain captures and <literal>alias</literal> should refer to these captures (0.7.40), for example: <example> location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ { @@ -188,7 +188,7 @@ location /images/ { <directive name="chunked_transfer_encoding"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -205,7 +205,7 @@ chunked encoding though the standard req <directive name="client_body_buffer_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>8k|16k</default> <context>http</context> <context>server</context> @@ -226,9 +226,9 @@ It is usually 16K on other 64-bit platfo <directive name="client_body_in_file_only"> <syntax> - <value>on</value> | - <value>clean</value> | - <value>off</value></syntax> + <literal>on</literal> | + <literal>clean</literal> | + <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -246,12 +246,12 @@ method of the module </para> <para> -When set to the value <value>on</value>, temporary files are not +When set to the value <literal>on</literal>, temporary files are not removed after request processing. </para> <para> -The value <value>clean</value> will cause the temporary files +The value <literal>clean</literal> will cause the temporary files left after request processing to be removed. </para> @@ -259,7 +259,7 @@ left after request processing to be remo <directive name="client_body_in_single_buffer"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -278,10 +278,10 @@ variable, to save the number of copy ope <directive name="client_body_temp_path"> <syntax> - <argument>path</argument> - [<argument>level1</argument> - [<argument>level2</argument> - [<argument>level3</argument>]]]</syntax> + <value>path</value> + [<value>level1</value> + [<value>level2</value> + [<value>level3</value>]]]</syntax> <default>client_body_temp</default> <context>http</context> <context>server</context> @@ -305,7 +305,7 @@ a temporary file might look like this: <directive name="client_body_timeout"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -325,7 +325,7 @@ is returned. <directive name="client_header_buffer_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>1k</default> <context>http</context> <context>server</context> @@ -345,7 +345,7 @@ directive. <directive name="client_header_timeout"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -362,7 +362,7 @@ is returned. <directive name="client_max_body_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>1m</default> <context>http</context> <context>server</context> @@ -379,7 +379,7 @@ is returned. Please be aware that <!--link doc="/web/upload.xml"-->browsers cannot correctly display this error<!--/link-->. -Setting <argument>size</argument> to 0 disables client +Setting <value>size</value> to 0 disables client request body size checking. </para> @@ -387,7 +387,7 @@ request body size checking. <directive name="connection_pool_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>256</default> <context>http</context> <context>server</context> @@ -402,7 +402,7 @@ and should not generally be used. <directive name="default_type"> -<syntax><argument>mime-type</argument></syntax> +<syntax><value>mime-type</value></syntax> <default>text/plain</default> <context>http</context> <context>server</context> @@ -417,7 +417,7 @@ See also the <link id="types"/> directiv <directive name="directio"> -<syntax><argument>size</argument> | <value>off</value></syntax> +<syntax><value>size</value> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -430,7 +430,7 @@ the <c-def>O_DIRECT</c-def> flag (FreeBS the <c-def>F_NOCACHE</c-def> flag (Mac OS X), or the <c-func>directio</c-func> function (Solaris), when reading files that are larger than or equal to -the specified <argument>size</argument>. +the specified <value>size</value>. It automatically disables (0.7.15) the use of <link id="sendfile"/> for a given request. @@ -445,7 +445,7 @@ or when using <link id="aio"/> on Linux. <directive name="directio_alignment"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>512</default> <context>http</context> <context>server</context> @@ -464,9 +464,9 @@ using XFS under Linux, it needs to be in <directive name="error_page"> <syntax> - <argument>code</argument> ... - [<value>=</value>[<argument>response</argument>]] - <argument>uri</argument></syntax> + <value>code</value> ... + [<literal>=</literal>[<value>response</value>]] + <value>uri</value></syntax> <default/> <context>http</context> <context>server</context> @@ -477,7 +477,7 @@ using XFS under Linux, it needs to be in Defines the URI that will be shown for the specified errors. These directives are inherited from the previous level if and only if there are no -<code>error_page</code> +<literal>error_page</literal> directives on the current level. A URI value can contain variables. @@ -527,9 +527,9 @@ location @fallback { <directive name="if_modified_since"> <syntax> - <value>off</value> | - <value>exact</value> | - <value>before</value></syntax> + <literal>off</literal> | + <literal>exact</literal> | + <literal>before</literal></syntax> <default>exact</default> <context>http</context> <context>server</context> @@ -544,18 +544,18 @@ request header field: <list type="tag"> -<tag-name><value>off</value></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> the <header>If-Modified-Since</header> request header field is ignored (0.7.34); </tag-desc> -<tag-name><value>exact</value></tag-name> +<tag-name><literal>exact</literal></tag-name> <tag-desc> exact match; </tag-desc> -<tag-name><value>before</value></tag-name> +<tag-name><literal>before</literal></tag-name> <tag-desc> modification time of a response is less than or equal to the time in the <header>If-Modified-Since</header> @@ -569,7 +569,7 @@ request header field. <directive name="ignore_invalid_headers"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -604,7 +604,7 @@ requests redirected by the <link id="err <listitem> subrequests formed by the -<command>include virtual</command> +“<command>include virtual</command>” command of the module <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>; </listitem> @@ -633,7 +633,7 @@ location /404.html { <directive name="keepalive_disable"> -<syntax><value>none</value> | <argument>browser</argument> ...</syntax> +<syntax><literal>none</literal> | <value>browser</value> ...</syntax> <default>msie6 safari</default> <context>http</context> <context>server</context> @@ -641,13 +641,13 @@ location /404.html { <para> Disables keep-alive connections with misbehaving browsers. -The <argument>browser</argument> arguments specify which +The <value>browser</value> parameters specify which browsers will be affected. -The value <value>msie6</value> disables keep-alive connections +The value <literal>msie6</literal> disables keep-alive connections with old versions of MSIE, after seeing a POST request. -The value <value>safari</value> disables keep-alive connections +The value <literal>safari</literal> disables keep-alive connections with Safari browsers. -The value <value>none</value> enables keep-alive connections +The value <literal>none</literal> enables keep-alive connections with all browsers. </para> @@ -655,7 +655,7 @@ with all browsers. <directive name="keepalive_requests"> -<syntax><argument>number</argument></syntax> +<syntax><value>number</value></syntax> <default>100</default> <context>http</context> <context>server</context> @@ -673,25 +673,25 @@ After this many requests are made, the c <directive name="keepalive_timeout"> <syntax> - <argument>timeout</argument> - [<argument>header_timeout</argument>]</syntax> + <value>timeout</value> + [<value>header_timeout</value>]</syntax> <default>75s</default> <context>http</context> <context>server</context> <context>location</context> <para> -The first argument sets a timeout during which a keep-alive +The first parameter sets a timeout during which a keep-alive client connection will stay open on the server side. -The optional second argument sets a value in the -<header>Keep-Alive: timeout=<argument>time</argument></header> +The optional second parameter sets a value in the +<header>Keep-Alive: timeout=<value>time</value></header> response header field. -Two arguments may differ. +Two parameters may differ. </para> <para> The -<header>Keep-Alive: timeout=<argument>time</argument></header> +<header>Keep-Alive: timeout=<value>time</value></header> header field is understood by Mozilla and Konqueror. MSIE will close keep-alive connection in about 60 seconds. </para> @@ -700,13 +700,13 @@ MSIE will close keep-alive connection in <directive name="large_client_header_buffers"> -<syntax><argument>number</argument> <argument>size</argument></syntax> +<syntax><value>number</value> <value>size</value></syntax> <default>4 8k</default> <context>http</context> <context>server</context> <para> -Sets the maximum <argument>number</argument> and <argument>size</argument> of +Sets the maximum <value>number</value> and <value>size</value> of buffers used when reading large client request header. A request line cannot exceed the size of one buffer, or the client error <http-status code="414" text="Request-URI Too Large"/> @@ -725,30 +725,30 @@ into the keep-alive state, these buffers <directive name="limit_except"> -<syntax block="yes"><argument>method</argument> ...</syntax> +<syntax block="yes"><value>method</value> ...</syntax> <default/> <context>location</context> <para> Limits allowed HTTP methods inside a location. -The <argument>method</argument> argument can be one of the following: -<value>GET</value>, -<value>HEAD</value>, -<value>POST</value>, -<value>PUT</value>, -<value>DELETE</value>, -<value>MKCOL</value>, -<value>COPY</value>, -<value>MOVE</value>, -<value>OPTIONS</value>, -<value>PROPFIND</value>, -<value>PROPPATCH</value>, -<value>LOCK</value>, -<value>UNLOCK</value>, +The <value>method</value> parameter can be one of the following: +<literal>GET</literal>, +<literal>HEAD</literal>, +<literal>POST</literal>, +<literal>PUT</literal>, +<literal>DELETE</literal>, +<literal>MKCOL</literal>, +<literal>COPY</literal>, +<literal>MOVE</literal>, +<literal>OPTIONS</literal>, +<literal>PROPFIND</literal>, +<literal>PROPPATCH</literal>, +<literal>LOCK</literal>, +<literal>UNLOCK</literal>, or -<value>PATCH</value>. -Allowing the <value>GET</value> method also allows the -<value>HEAD</value> method. +<literal>PATCH</literal>. +Allowing the <literal>GET</literal> method also allows the +<literal>HEAD</literal> method. Access to other methods can be limited using the <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> and @@ -768,7 +768,7 @@ Please note that this will limit access <directive name="limit_rate"> -<syntax><argument>rate</argument></syntax> +<syntax><value>rate</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -777,7 +777,7 @@ Please note that this will limit access <para> Rate limits the transmission of a response to a client. -The <argument>rate</argument> is specified in bytes per second. +The <value>rate</value> is specified in bytes per second. Value 0 (the default) disables rate limiting. <!-- The smaller the rate, the more accurate will be the limitation. @@ -810,7 +810,7 @@ server { <directive name="limit_rate_after"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -838,7 +838,10 @@ location /flv/ { <directive name="lingering_close"> -<syntax><value>off</value> | <value>on</value> | <value>always</value></syntax> +<syntax> + <literal>off</literal> | + <literal>on</literal> | + <literal>always</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -851,7 +854,7 @@ Controls how nginx closes client connect </para> <para> -The default value “<value>on</value>” instructs nginx to +The default value “<literal>on</literal>” instructs nginx to <link id="lingering_timeout">wait for</link> and <link id="lingering_time">process</link> additional data from a client before fully closing a connection, but only @@ -859,12 +862,12 @@ if heuristics suggests that a client may </para> <para> -The value “<value>always</value>” will cause nginx to unconditionally +The value “<literal>always</literal>” will cause nginx to unconditionally wait for and process additional client data. </para> <para> -The value “<value>off</value>” tells nginx to never wait for +The value “<literal>off</literal>” tells nginx to never wait for more data and close the connection immediately. This breaks the protocol and should not be used under normal circumstances. </para> @@ -873,7 +876,7 @@ This breaks the protocol and should not <directive name="lingering_time"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>30s</default> <context>http</context> <context>server</context> @@ -890,7 +893,7 @@ After that, the connection is closed, ev <directive name="lingering_timeout"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>5s</default> <context>http</context> <context>server</context> @@ -910,52 +913,52 @@ The “wait-read-ignore” cycle is repeated, but no longer than specified by the <directive name="listen"> <syntax> - <argument>address</argument>[:<argument>port</argument>] - [<parameter>default_server</parameter>] - [<parameter>setfib</parameter>=<argument>number</argument>] - [<parameter>backlog</parameter>=<argument>number</argument>] - [<parameter>rcvbuf</parameter>=<argument>size</argument>] - [<parameter>sndbuf</parameter>=<argument>size</argument>] - [<parameter>accept_filter</parameter>=<argument>filter</argument>] - [<parameter>deferred</parameter>] - [<parameter>bind</parameter>] - [<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>] - [<parameter>ssl</parameter>] - [<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax> + <value>address</value>[:<value>port</value>] + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>number</value>] + [<literal>backlog</literal>=<value>number</value>] + [<literal>rcvbuf</literal>=<value>size</value>] + [<literal>sndbuf</literal>=<value>size</value>] + [<literal>accept_filter</literal>=<value>filter</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <argument>port</argument> - [<parameter>default_server</parameter>] - [<parameter>setfib</parameter>=<argument>number</argument>] - [<parameter>backlog</parameter>=<argument>number</argument>] - [<parameter>rcvbuf</parameter>=<argument>size</argument>] - [<parameter>sndbuf</parameter>=<argument>size</argument>] - [<parameter>accept_filter</parameter>=<argument>filter</argument>] - [<parameter>deferred</parameter>] - [<parameter>bind</parameter>] - [<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>] - [<parameter>ssl</parameter>] - [<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax> + <value>port</value> + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>number</value>] + [<literal>backlog</literal>=<value>number</value>] + [<literal>rcvbuf</literal>=<value>size</value>] + [<literal>sndbuf</literal>=<value>size</value>] + [<literal>accept_filter</literal>=<value>filter</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <value>unix:</value><argument>path</argument> - [<parameter>default_server</parameter>] - [<parameter>backlog</parameter>=<argument>number</argument>] - [<parameter>rcvbuf</parameter>=<argument>size</argument>] - [<parameter>sndbuf</parameter>=<argument>size</argument>] - [<parameter>accept_filter</parameter>=<argument>filter</argument>] - [<parameter>deferred</parameter>] - [<parameter>bind</parameter>] - [<parameter>ssl</parameter>] - [<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax> + <literal>unix:</literal><value>path</value> + [<literal>default_server</literal>] + [<literal>backlog</literal>=<value>number</value>] + [<literal>rcvbuf</literal>=<value>size</value>] + [<literal>sndbuf</literal>=<value>size</value>] + [<literal>accept_filter</literal>=<value>filter</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <default>*:80 | *:8000</default> <context>server</context> <para> -Sets an <argument>address</argument> and a <argument>port</argument> for IP, -or a <argument>path</argument> for a UNIX-domain socket, on which +Sets an <value>address</value> and a <value>port</value> for IP, +or a <value>path</value> for a UNIX-domain socket, on which the server will accept requests. -Only one of <argument>address</argument> or <argument>port</argument> may be +Only one of <value>address</value> or <value>port</value> may be specified. -An <argument>address</argument> may also be a hostname, for example: +An <value>address</value> may also be a hostname, for example: <example> listen 127.0.0.1:8000; listen 127.0.0.1; @@ -968,51 +971,51 @@ IPv6 addresses (0.7.36) are specified in listen [::]:8000; listen [fe80::1]; </example> -UNIX-domain sockets (0.8.21) are specified with the “<code>unix:</code>” prefix: +UNIX-domain sockets (0.8.21) are specified with the “<literal>unix:</literal>” prefix: <example> listen unix:/var/run/nginx.sock; </example> </para> <para> -If only <argument>address</argument> is given, the port 80 is used. +If only <value>address</value> is given, the port 80 is used. </para> <para> -If directive is not present then either the <code>*:80</code> is used -if nginx runs with superuser privileges, or <code>*:8000</code> otherwise. +If directive is not present then either the <literal>*:80</literal> is used +if nginx runs with superuser privileges, or <literal>*:8000</literal> otherwise. </para> <para> -The <parameter>default_server</parameter> parameter, if present, +The <literal>default_server</literal> parameter, if present, will cause the server to become the default server for the specified -<argument>address</argument>:<argument>port</argument> pair. -If none of the directives have the <parameter>default_server</parameter> +<value>address</value>:<value>port</value> pair. +If none of the directives have the <literal>default_server</literal> parameter then the first server with the -<argument>address</argument>:<argument>port</argument> pair will be +<value>address</value>:<value>port</value> pair will be the default server for this pair. <note> In versions prior to 0.8.21 this parameter is named simply -<parameter>default</parameter>. +<literal>default</literal>. </note> </para> <para> -A <code>listen</code> directive +A <literal>listen</literal> directive can have several additional parameters specific to system calls <c-func>listen</c-func> and <c-func>bind</c-func>. They can be specified in any -<code>listen</code> directive, but only once for the given -<argument>address</argument>:<argument>port</argument> pair. +<literal>listen</literal> directive, but only once for the given +<value>address</value>:<value>port</value> pair. <note> In versions prior to 0.8.21, they could only be -specified in the <code>listen</code> directive with the -<parameter>default</parameter> parameter. +specified in the <literal>listen</literal> directive with the +<literal>default</literal> parameter. </note> <list type="tag"> <tag-name> -<parameter>setfib</parameter>=<argument>number</argument> +<literal>setfib</literal>=<value>number</value> </tag-name> <tag-desc> this parameter (0.8.44) sets the associated FIB (routing table) @@ -1021,43 +1024,43 @@ This currently works only on FreeBSD. </tag-desc> <tag-name> -<parameter>backlog</parameter>=<argument>number</argument> +<literal>backlog</literal>=<value>number</value> </tag-name> <tag-desc> -sets the <parameter>backlog</parameter> parameter in the +sets the <literal>backlog</literal> parameter in the <c-func>listen</c-func> call. -By default, <parameter>backlog</parameter> equals -1 on FreeBSD +By default, <literal>backlog</literal> equals -1 on FreeBSD and 511 on other platforms. </tag-desc> <tag-name> -<parameter>rcvbuf</parameter>=<argument>size</argument> +<literal>rcvbuf</literal>=<value>size</value> </tag-name> <tag-desc> sets the <c-def>SO_RCVBUF</c-def> parameter for the listening socket. </tag-desc> <tag-name> -<parameter>sndbuf</parameter>=<argument>size</argument> +<literal>sndbuf</literal>=<value>size</value> </tag-name> <tag-desc> sets the <c-def>SO_SNDBUF</c-def> parameter for the listening socket. </tag-desc> <tag-name> -<parameter>accept_filter</parameter>=<argument>filter</argument> +<literal>accept_filter</literal>=<value>filter</value> </tag-name> <tag-desc> sets the name of the accept filter. -This works only on FreeBSD, acceptable values are <value>dataready</value> -and <value>httpready</value>. +This works only on FreeBSD, acceptable values are <literal>dataready</literal> +and <literal>httpready</literal>. On receipt of the <c-def>SIGHUP</c-def> signal, an accept filter can only be changed in recent versions of FreeBSD, starting from 6.0, 5.4-STABLE and 4.11-STABLE. </tag-desc> <tag-name> -<parameter>deferred</parameter> +<literal>deferred</literal> </tag-name> <tag-desc> instructs to use a deferred <c-func>accept</c-func> on Linux @@ -1065,30 +1068,30 @@ using the <c-def>TCP_DEFER_ACCEPT</c-def </tag-desc> <tag-name> -<parameter>bind</parameter> +<literal>bind</literal> </tag-name> <tag-desc> instructs to make a separate <c-func>bind</c-func> call for a given -<argument>address</argument>:<argument>port</argument> pair. +<value>address</value>:<value>port</value> pair. This is because nginx will <c-func>bind</c-func> only to -<code>*</code>:<argument>port</argument> -if there are several <code>listen</code> directives with +<literal>*:</literal><value>port</value> +if there are several <literal>listen</literal> directives with the same port but different addresses, and one of the -<code>listen</code> directives listens on all addresses -for the given port (<code>*</code>:<argument>port</argument>). +<literal>listen</literal> directives listens on all addresses +for the given port (<literal>*:</literal><value>port</value>). It should be noted that in this case a <c-func>getsockname</c-func> system call will be made to determine an address that accepted a connection. -If parameters <parameter>backlog</parameter>, <parameter>rcvbuf</parameter>, -<parameter>sndbuf</parameter>, <parameter>accept_filter</parameter>, -<parameter>deferred</parameter>, or <parameter>so_keepalive</parameter> +If parameters <literal>backlog</literal>, <literal>rcvbuf</literal>, +<literal>sndbuf</literal>, <literal>accept_filter</literal>, +<literal>deferred</literal>, or <literal>so_keepalive</literal> are used then for a given -<argument>address</argument>:<argument>port</argument> pair +<value>address</value>:<value>port</value> pair a separate <c-func>bind</c-func> call will always be made. </tag-desc> <tag-name> -<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value> +<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal> </tag-name> <tag-desc> this parameter (0.7.42) sets the value of the <c-def>IPV6_V6ONLY</c-def> @@ -1097,7 +1100,7 @@ This parameter can only be set once on s </tag-desc> <tag-name> -<parameter>ssl</parameter> +<literal>ssl</literal> </tag-name> <tag-desc> this parameter (0.7.14) does not relate to system calls @@ -1113,24 +1116,24 @@ listen 443 default ssl; </tag-desc> <tag-name> -<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>] +<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>] </tag-name> <tag-desc> this parameter (1.1.11) configures the “TCP keepalive” behavior for the listening socket. If this parameter is omitted then the system default setting will be in effect for the socket. -If set to the value “<value>on</value>”, the <c-def>SO_KEEPALIVE</c-def> +If set to the value “<literal>on</literal>”, the <c-def>SO_KEEPALIVE</c-def> socket option is turned on for the socket. -If set to the value “<value>off</value>”, the <c-def>SO_KEEPALIVE</c-def> +If set to the value “<literal>off</literal>”, the <c-def>SO_KEEPALIVE</c-def> socket option is turned off for the socket. Some operating systems support tuning TCP keepalive parameters on a per-socket basis using the <c-def>TCP_KEEPIDLE</c-def>, <c-def>TCP_KEEPINTVL</c-def>, and <c-def>TCP_KEEPCNT</c-def> socket options. On such systems (currently, Linux 2.4+ and NetBSD 5+) they can be configured -using the <argument>keepidle</argument>, <argument>keepintvl</argument>, and -<argument>keepcnt</argument> arguments. -One or two arguments may be omitted, in which case the system default setting +using the <value>keepidle</value>, <value>keepintvl</value>, and +<value>keepcnt</value> parameters. +One or two parameters may be omitted, in which case the system default setting for the corresponding socket option will be in effect. For example, <example>so_keepalive=30m::10</example> @@ -1154,12 +1157,12 @@ listen 127.0.0.1 default accept_filter=d <directive name="location"> <syntax block="yes">[ - <value>=</value> | - <value>~</value> | - <value>~*</value> | - <value>^~</value> - ] <argument>uri</argument></syntax> -<syntax block="yes"><value>@</value><argument>name</argument></syntax> + <literal>=</literal> | + <literal>~</literal> | + <literal>~*</literal> | + <literal>^~</literal> + ] <value>uri</value></syntax> +<syntax block="yes"><literal>@</literal><value>name</value></syntax> <default/> <context>server</context> <context>location</context> @@ -1168,8 +1171,8 @@ listen 127.0.0.1 default accept_filter=d Sets a configuration based on a request URI. A location can either be defined by a prefix string, or by a regular expression. Regular expressions are specified by prepending them with the -“<value>~*</value>” prefix (for case-insensitive matching), or with the -“<value>~</value>” prefix (for case-sensitive matching). +“<literal>~*</literal>” prefix (for case-insensitive matching), or with the +“<literal>~</literal>” prefix (for case-sensitive matching). To find a location matching a given request, nginx first checks locations defined using the prefix strings (prefix locations). Among them, the most specific one is searched. @@ -1197,16 +1200,16 @@ be used in other directives. </para> <para> -If the most specific prefix location has the “<value>^~</value>” prefix +If the most specific prefix location has the “<literal>^~</literal>” prefix then regular expressions are not checked. </para> <para> -Also, using the “<value>=</value>” prefix it is possible to define +Also, using the “<literal>=</literal>” prefix it is possible to define an exact match of URI and location. If an exact match is found, the search terminates. -For example, if a “<code>/</code>” request happens frequently, -defining “<code>location = /</code>” will speed up the processing +For example, if a “<literal>/</literal>” request happens frequently, +defining “<literal>location = /</literal>” will speed up the processing of these requests, as search terminates right after the first comparison. Such a location cannot obviously contain nested locations. @@ -1215,7 +1218,7 @@ Such a location cannot obviously contain <para> <note> In versions from 0.7.1 to 0.8.41, if a request matched the prefix -location without the “<value>=</value>” and “<value>^~</value>” +location without the “<literal>=</literal>” and “<literal>^~</literal>” prefixes, the search also terminated and regular expressions were not checked. </note> @@ -1240,15 +1243,15 @@ location ~* \.(gif|jpg|jpeg)$ { [ configuration D ] } </example> -The “<code>/</code>” request will match configuration A, -the “<code>/documents/document.html</code>” request will match +The “<literal>/</literal>” request will match configuration A, +the “<literal>/documents/document.html</literal>” request will match configuration B, -the “<code>/images/1.gif</code>” request will match configuration C, and -the “<code>/documents/1.jpg</code>” request will match configuration D. +the “<literal>/images/1.gif</literal>” request will match configuration C, and +the “<literal>/documents/1.jpg</literal>” request will match configuration D. </para> <para> -The “<value>@</value>” prefix defines a named location. +The “<literal>@</literal>” prefix defines a named location. Such a location is not used for a regular request processing, but instead used for request redirection. They cannot be nested, and cannot contain nested locations. @@ -1262,7 +1265,7 @@ They cannot be nested, and cannot contai <directive name="log_not_found"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1277,7 +1280,7 @@ Enables or disables logging of errors ab <directive name="log_subrequest"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1292,7 +1295,7 @@ Enables or disables logging of subreques <directive name="max_ranges"> -<syntax><argument>number</argument></syntax> +<syntax><value>number</value></syntax> <default/> <context>http</context> <context>server</context> @@ -1310,7 +1313,7 @@ The value of zero disables the byte-rang <directive name="merge_slashes"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1323,19 +1326,19 @@ in a URI into a single slash. <para> Note that compression is essential for the correct prefix string and regular expressions location matching. -Without it, the “<code>//scripts/one.php</code>” request would not match +Without it, the “<literal>//scripts/one.php</literal>” request would not match <example> location /scripts/ { ... } </example> and might be processed as a static file, -so it gets converted to “<code>/scripts/one.php</code>”. +so it gets converted to “<literal>/scripts/one.php</literal>”. </para> <para> -Turning the compression <value>off</value> can become necessary if a URI -contains base64-encoded names, since base64 uses the “<code>/</code>” +Turning the compression <literal>off</literal> can become necessary if a URI +contains base64-encoded names, since base64 uses the “<literal>/</literal>” character internally. However, for security considerations, it is better to avoid turning off the compression. @@ -1352,7 +1355,7 @@ all virtual servers listening on the sam <directive name="msie_padding"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1367,7 +1370,7 @@ greater than 400 for MSIE clients, to pa <directive name="msie_refresh"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1381,10 +1384,10 @@ Enables or disables issuing refreshes in <directive name="open_file_cache"> -<syntax><value>off</value></syntax> +<syntax><literal>off</literal></syntax> <syntax> -<parameter>max</parameter>=<argument>N</argument> -[<parameter>inactive</parameter>=<argument>time</argument>]</syntax> +<literal>max</literal>=<value>N</value> +[<literal>inactive</literal>=<value>time</value>]</syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1420,7 +1423,7 @@ The directive has the following paramete <list type="tag"> <tag-name> -<parameter>max</parameter> +<literal>max</literal> </tag-name> <tag-desc> sets the maximum number of elements in the cache; @@ -1428,7 +1431,7 @@ on cache overflow the least recently use </tag-desc> <tag-name> -<parameter>inactive</parameter> +<literal>inactive</literal> </tag-name> <tag-desc> defines a time, after which an element gets removed from the cache @@ -1437,7 +1440,7 @@ by default, it is 60 seconds; </tag-desc> <tag-name> -<value>off</value> +<literal>off</literal> </tag-name> <tag-desc> disables the cache. @@ -1462,7 +1465,7 @@ open_file_cache_events on; <directive name="open_file_cache_errors"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1479,7 +1482,7 @@ Enables or disables caching of file look <!-- <directive name="open_file_cache_events"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1504,15 +1507,15 @@ file systems such as UFS or FFS. <directive name="open_file_cache_min_uses"> -<syntax><argument>number</argument></syntax> +<syntax><value>number</value></syntax> <default>1</default> <context>http</context> <context>server</context> <context>location</context> <para> -Sets the minimum <argument>number</argument> of file accesses during -the period configured by the <parameter>inactive</parameter> parameter +Sets the minimum <value>number</value> of file accesses during +the period configured by the <literal>inactive</literal> parameter of the <link id="open_file_cache"/> directive, after which a file descriptor will remain open in the cache. </para> @@ -1521,7 +1524,7 @@ after which a file descriptor will remai <directive name="open_file_cache_valid"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -1543,7 +1546,7 @@ are checked only once, and then updated <directive name="optimize_server_names"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1571,7 +1574,7 @@ optimization needs to be disabled. <directive name="port_in_redirect"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1589,7 +1592,7 @@ See also the <link id="server_name_in_re <directive name="postpone_output"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>1460</default> <context>http</context> <context>server</context> @@ -1597,7 +1600,7 @@ See also the <link id="server_name_in_re <para> If possible, the output of client data will be postponed until -nginx has at least <argument>size</argument> bytes of data to send. +nginx has at least <value>size</value> bytes of data to send. Value of zero disables postponing. </para> @@ -1605,7 +1608,7 @@ Value of zero disables postponing. <directive name="read_ahead"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -1617,13 +1620,14 @@ Sets the amount of pre-reading when work <para> On Linux, the -<code>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</code> -system call is used, so the <argument>size</argument> argument is ignored. +<literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal> +system call is used, so the <value>size</value> parameter is ignored. </para> <para> On FreeBSD, the -<code>fcntl(O_READAHEAD,</code><argument>size</argument><code>)</code> +<literal>fcntl(O_READAHEAD,</literal> +<value>size</value><literal>)</literal> system call is used, supported in FreeBSD 9.0-CURRENT. FreeBSD 7 needs to be <link url="http://sysoev.ru/freebsd/patch.readahead.txt">patched</link>. @@ -1633,7 +1637,7 @@ FreeBSD 7 needs to be <directive name="recursive_error_pages"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1649,7 +1653,7 @@ directive. <directive name="request_pool_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>4k</default> <context>http</context> <context>server</context> @@ -1665,7 +1669,7 @@ and should not generally be used. <directive name="reset_timedout_connection"> <syntax> - <value>on</value> | <value>off</value></syntax> + <literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1692,8 +1696,8 @@ closed normally. <directive name="resolver"> <syntax> -<argument>address</argument> ... -[<parameter>valid</parameter>=<argument>time</argument>]</syntax> +<value>address</value> ... +[<literal>valid</literal>=<value>time</value>]</syntax> <default/> <context>http</context> <context>server</context> @@ -1705,7 +1709,7 @@ for example: <example> resolver 127.0.0.1 192.0.2.1; </example> -An <argument>address</argument> argument may be specified as +An <value>address</value> parameter may be specified as either an IPv4 address or a hostname; in the latter case, the first resolved IPv4 address is used. Name servers are queried in a round-robin fashion. @@ -1713,7 +1717,7 @@ Name servers are queried in a round-robi Before version 1.1.7, only a single name server could be configured. </note> By default, nginx caches answers using the TTL value of a response. -An optional <parameter>valid</parameter> parameter allows to override it: +An optional <literal>valid</literal> parameter allows to override it: <example> resolver 127.0.0.1 192.0.2.1 valid=30s; </example> @@ -1727,7 +1731,7 @@ and nginx always cached answers for the <directive name="resolver_timeout"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>30s</default> <context>http</context> <context>server</context> @@ -1744,7 +1748,7 @@ resolver_timeout 5s; <directive name="root"> -<syntax><argument>path</argument></syntax> +<syntax><value>path</value></syntax> <default>html</default> <context>http</context> <context>server</context> @@ -1759,19 +1763,19 @@ location /i/ { root /data/w3; } </example> -“<code>/i/top.gif</code>” will be responded +“<literal>/i/top.gif</literal>” will be responded with the file <path>/data/w3/i/top.gif</path>. </para> <para> -The <argument>path</argument> value can contain variables +The <value>path</value> value can contain variables except <var>$document_root</var> and <var>$realpath_root</var>. </para> <para> A path to the file is constructed by merely adding a URI to the value -of the <code>root</code> directive. +of the <literal>root</literal> directive. If a URI need to be modified, the <link id="alias"/> directive should be used. </para> @@ -1780,14 +1784,14 @@ If a URI need to be modified, the <directive name="satisfy"> -<syntax><value>all</value> | <value>any</value></syntax> +<syntax><literal>all</literal> | <literal>any</literal></syntax> <default>all</default> <context>http</context> <context>server</context> <context>location</context> <para> -Allows access if <value>all</value> or <value>any</value> of the +Allows access if <literal>all</literal> or <literal>any</literal> of the <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> or <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> modules grant access. @@ -1812,7 +1816,7 @@ location / { <directive name="satisfy_any"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1827,7 +1831,7 @@ directive. <directive name="send_lowat"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -1839,7 +1843,7 @@ of send operations on client sockets by <c-def>NOTE_LOWAT</c-def> flag of <link doc="../events.xml" id="kqueue"/>, or the <c-def>SO_SNDLOWAT</c-def> socket option, -with the specified <argument>size</argument>. +with the specified <value>size</value>. </para> <para> @@ -1850,7 +1854,7 @@ This directive is ignored on Linux, Sola <directive name="send_timeout"> -<syntax><argument>time</argument></syntax> +<syntax><value>time</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -1869,7 +1873,7 @@ a connection is closed. <directive name="sendfile"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1886,7 +1890,7 @@ Enables or disables the use of <directive name="sendfile_max_chunk"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -1923,7 +1927,7 @@ Setting Up Virtual Servers</link> docume <directive name="server_name"> -<syntax><argument>name</argument> ...</syntax> +<syntax><value>name</value> ...</syntax> <default>""</default> <context>server</context> @@ -1938,7 +1942,7 @@ server { <para> The first name becomes the primary server name. -Server names can include an asterisk (“<code>*</code>”) +Server names can include an asterisk (“<literal>*</literal>”) to replace the first or last part of a name: <example> server { @@ -1957,13 +1961,13 @@ server { </para> <para> -If the argument equals “<var>$hostname</var>” (0.9.4), the +If the parameter equals “<var>$hostname</var>” (0.9.4), the machine's hostname is substituted. </para> <para> It is also possible to use regular expressions in server names, -prepending the name with a tilde (“<code>~</code>”): +prepending the name with a tilde (“<literal>~</literal>”): <example> server { server_name www.example.com ~^www\d+\.example\.com$; @@ -2039,11 +2043,11 @@ full names </listitem> <listitem> -names with the prefix mask, e.g. “<code>*.example.com</code>” +names with the prefix mask, e.g. “<literal>*.example.com</literal>” </listitem> <listitem> -names with the suffix mask, e.g. “<code>mail.*</code>” +names with the suffix mask, e.g. “<literal>mail.*</literal>” </listitem> <listitem> @@ -2057,7 +2061,7 @@ regular expressions <directive name="server_name_in_redirect"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2080,7 +2084,7 @@ See also the <link id="port_in_redirect" <directive name="server_names_hash_bucket_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>32|64|128</default> <context>http</context> @@ -2095,12 +2099,12 @@ For more information, please refer to <directive name="server_names_hash_max_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>512</default> <context>http</context> <para> -Sets the maximum <argument>size</argument> of the server names hash tables. +Sets the maximum <value>size</value> of the server names hash tables. For more information, please refer to <link doc="../hash.xml">Setting Up Hashes</link>. </para> @@ -2109,7 +2113,7 @@ For more information, please refer to <directive name="server_tokens"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -2124,7 +2128,7 @@ Enables or disables emitting of nginx ve <directive name="tcp_nodelay"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -2140,7 +2144,7 @@ keep-alive state. <directive name="tcp_nopush"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2171,11 +2175,11 @@ send a file in full packets. <directive name="try_files"> <syntax> - <argument>file</argument> ... - <argument>uri</argument></syntax> + <value>file</value> ... + <value>uri</value></syntax> <syntax> - <argument>file</argument> ... - =<argument>code</argument></syntax> + <value>file</value> ... + =<value>code</value></syntax> <default/> <context>server</context> <context>location</context> @@ -2185,13 +2189,13 @@ Checks the existence of files in the spe the first found file for request processing; the processing is performed in the current context. A path to the file is constructed from the -<argument>file</argument> argument +<value>file</value> parameter according to the <link id="root"/> and <link id="alias"/> directives. It is possible to check the directory existence by specifying -a slash at the end of a name, e.g. “<code>$uri/</code>”. +a slash at the end of a name, e.g. “<literal>$uri/</literal>”. If none of the files were found, an internal redirect to the -<argument>uri</argument> specified by the last argument is made. +<value>uri</value> specified by the last parameter is made. For example: <example> location /images/ { @@ -2202,10 +2206,10 @@ location = /images/default.gif { expires 30s; } </example> -The last argument can also point to a named location, +The last parameter can also point to a named location, see examples below. -As of version 0.7.51, the last argument can also be a -<argument>code</argument>: +As of version 0.7.51, the last parameter can also be a +<value>code</value>: <example> location / { try_files $uri $uri/index.html $uri.html =404; @@ -2263,7 +2267,7 @@ location / { try_files $uri $uri/ @drupal; } </example> -the <code>try_files</code> directive is equivalent to +the <literal>try_files</literal> directive is equivalent to <example> location / { error_page 404 = @drupal; @@ -2282,7 +2286,7 @@ location ~ \.php$ { ... } </example> -<code>try_files</code> checks the existence of the PHP file +<literal>try_files</literal> checks the existence of the PHP file before passing the request to the FastCGI server. </para> @@ -2345,7 +2349,7 @@ A sufficiently full mapping table is dis <para> To make a particular location emit the -“<code>application/octet-stream</code>” +“<literal>application/octet-stream</literal>” MIME type for all requests, try the following: <example> location /download/ { @@ -2359,7 +2363,7 @@ location /download/ { <directive name="types_hash_bucket_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>32|64|128</default> <context>http</context> <context>server</context> @@ -2376,14 +2380,14 @@ For more information, please refer to <directive name="types_hash_max_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>1024</default> <context>http</context> <context>server</context> <context>location</context> <para> -Sets the maximum <argument>size</argument> of the types hash tables. +Sets the maximum <value>size</value> of the types hash tables. For more information, please refer to <link doc="../hash.xml">Setting Up Hashes</link>. </para> @@ -2392,7 +2396,7 @@ For more information, please refer to <directive name="underscores_in_headers"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2408,7 +2412,7 @@ directive. <directive name="variables_hash_bucket_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>64</default> <context>http</context> @@ -2422,12 +2426,12 @@ For more information, please refer to <directive name="variables_hash_max_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>512</default> <context>http</context> <para> -Sets the maximum <argument>size</argument> of the variables hash table. +Sets the maximum <value>size</value> of the variables hash table. For more information, please refer to <link doc="../hash.xml">Setting Up Hashes</link>. </para> @@ -2439,17 +2443,17 @@ For more information, please refer to <section id="variables" name="Embedded Variables"> <para> -The module <code>ngx_http_core_module</code> supports embedded variables with -names matching those of the Apache Server. +The module <literal>ngx_http_core_module</literal> supports embedded variables +with names matching those of the Apache Server. First of all, these are variables representing client request header fields, such as <var>$http_user_agent</var>, <var>$http_cookie</var>, and so on. It also supports other variables: <list type="tag"> -<tag-name><var>$arg_</var><argument>name</argument></tag-name> +<tag-name><var>$arg_</var><value>name</value></tag-name> <tag-desc> -argument <argument>name</argument> in the request line +argument <value>name</value> in the request line </tag-desc> <tag-name><var>$args</var></tag-name> @@ -2477,9 +2481,9 @@ number of bytes sent to a client, not co <header>Content-Type</header> request header field </tag-desc> -<tag-name><var>$cookie_</var><argument>name</argument></tag-name> +<tag-name><var>$cookie_</var><value>name</value></tag-name> <tag-desc> -the <argument>name</argument> cookie +the <value>name</value> cookie </tag-desc> <tag-name><var>$document_root</var></tag-name> @@ -2503,21 +2507,21 @@ or the server name matching a request if host name </tag-desc> -<tag-name><var>$http_</var><argument>name</argument></tag-name> +<tag-name><var>$http_</var><value>name</value></tag-name> <tag-desc> -the <argument>name</argument> request header field +the <value>name</value> request header field </tag-desc> <tag-name><var>$https</var></tag-name> <tag-desc> -“<code>on</code>” +“<literal>on</literal>” if connection operates in SSL mode, or an empty string otherwise </tag-desc> <tag-name><var>$is_args</var></tag-name> <tag-desc> -“<code>?</code>” if a request line has arguments, +“<literal>?</literal>” if a request line has arguments, or an empty string otherwise </tag-desc> @@ -2602,7 +2606,7 @@ directives, respectively. <tag-name><var>$request_completion</var></tag-name> <tag-desc> -“<code>OK</code>” if a request has completed, +“<literal>OK</literal>” if a request has completed, or an empty string otherwise </tag-desc> @@ -2616,7 +2620,7 @@ directives, and the request URI <tag-name><var>$request_method</var></tag-name> <tag-desc> request method, usually -“<code>GET</code>” or “<code>POST</code>” +“<literal>GET</literal>” or “<literal>POST</literal>” </tag-desc> <tag-name><var>$request_uri</var></tag-name> @@ -2626,12 +2630,12 @@ full original request URI (with argument <tag-name><var>$scheme</var></tag-name> <tag-desc> -request scheme, “<code>http</code>” or “<code>https</code>” +request scheme, “<literal>http</literal>” or “<literal>https</literal>” </tag-desc> -<tag-name><var>$sent_http_</var><argument>name</argument></tag-name> +<tag-name><var>$sent_http_</var><value>name</value></tag-name> <tag-desc> -the <argument>name</argument> response header field +the <value>name</value> response header field </tag-desc> <tag-name><var>$server_addr</var></tag-name> @@ -2640,7 +2644,7 @@ an address of the server which accepted <para> Computing a value of this variable usually requires one system call. To avoid a system call, the <link id="listen"/> directives -must specify addresses and use the <parameter>bind</parameter> parameter. +must specify addresses and use the <literal>bind</literal> parameter. </para> </tag-desc> @@ -2657,9 +2661,9 @@ port of the server which accepted a requ <tag-name><var>$server_protocol</var></tag-name> <tag-desc> request protocol, usually -“<code>HTTP/1.0</code>” +“<literal>HTTP/1.0</literal>” or -“<code>HTTP/1.1</code>” +“<literal>HTTP/1.1</literal>” </tag-desc> <tag-name><var>$uri</var></tag-name>
--- a/xml/en/docs/http/ngx_http_empty_gif_module.xml +++ b/xml/en/docs/http/ngx_http_empty_gif_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -The module <code>ngx_http_empty_gif_module</code> emits +The module <literal>ngx_http_empty_gif_module</literal> emits single-pixel transparent GIF. </para>
--- a/xml/en/docs/http/ngx_http_flv_module.xml +++ b/xml/en/docs/http/ngx_http_flv_module.xml @@ -9,12 +9,12 @@ <section id="summary"> <para> -The module <code>ngx_http_flv_module</code> provides pseudo-streaming +The module <literal>ngx_http_flv_module</literal> provides pseudo-streaming server-side support for Flash Video (FLV) files. </para> <para> -It handles requests with the <parameter>start</parameter> argument in +It handles requests with the <literal>start</literal> argument in the request URI’s query string specially, by sending back the contents of a file starting from the requested byte offset, and with the FLV header prepended. @@ -22,7 +22,7 @@ header prepended. <para> This module is not built by default, it should be enabled with the -<code>--with-http_flv_module</code> +<literal>--with-http_flv_module</literal> configuration parameter. </para>
--- a/xml/en/docs/http/ngx_http_image_filter_module.xml +++ b/xml/en/docs/http/ngx_http_image_filter_module.xml @@ -9,13 +9,13 @@ <section id="summary"> <para> -The <code>ngx_http_image_filter_module</code> module is a filter +The <literal>ngx_http_image_filter_module</literal> module is a filter that transforms images in JPEG, GIF, and PNG (0.7.54+) formats. </para> <para> This module is not built by default, it should be enabled with the -<code>--with-http_image_filter_module</code> +<literal>--with-http_image_filter_module</literal> configuration parameter. <note> This module utilizes the @@ -51,19 +51,19 @@ location = /empty { <section id="directives" name="Directives"> <directive name="image_filter"> - <syntax><parameter>off</parameter></syntax> - <syntax><parameter>test</parameter></syntax> - <syntax><parameter>size</parameter></syntax> - <syntax><parameter>rotate</parameter> - <value>90</value> | <value>180</value> | <value>270</value></syntax> + <syntax><literal>off</literal></syntax> + <syntax><literal>test</literal></syntax> + <syntax><literal>size</literal></syntax> + <syntax><literal>rotate</literal> + <literal>90</literal> | <literal>180</literal> | <literal>270</literal></syntax> <syntax> - <parameter>resize</parameter> - <argument>width</argument> - <argument>height</argument></syntax> + <literal>resize</literal> + <value>width</value> + <value>height</value></syntax> <syntax> - <parameter>crop</parameter> - <argument>width</argument> - <argument>height</argument></syntax> + <literal>crop</literal> + <value>width</value> + <value>height</value></syntax> <default/> <context>location</context> @@ -71,12 +71,12 @@ location = /empty { Sets the type of transformation to perform on images: <list type="tag"> -<tag-name><parameter>off</parameter></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> turns off module processing in a surrounding location. </tag-desc> -<tag-name><parameter>test</parameter></tag-name> +<tag-name><literal>test</literal></tag-name> <tag-desc> ensures that answers are images in either JPEG, GIF, or PNG format. Otherwise, the error @@ -84,7 +84,7 @@ Otherwise, the error is returned. </tag-desc> -<tag-name><parameter>size</parameter></tag-name> +<tag-name><literal>size</literal></tag-name> <tag-desc> outputs information about images in a JSON format, e.g.: <example> @@ -96,44 +96,44 @@ In case of an error, the following is ou </example> </tag-desc> -<tag-name><parameter>rotate</parameter> -<value>90</value>|<value>180</value>|<value>270</value> +<tag-name><literal>rotate</literal> +<literal>90</literal>|<literal>180</literal>|<literal>270</literal> </tag-name> <tag-desc> rotates images counter-clockwise by the specified number of degrees. -The argument value can contain variables. +Value of the parameter can contain variables. Can be used either alone, or along with the -<parameter>resize</parameter> and <parameter>crop</parameter> transformations. +<literal>resize</literal> and <literal>crop</literal> transformations. </tag-desc> -<tag-name><parameter>resize</parameter> -<argument>width</argument> -<argument>height</argument> +<tag-name><literal>resize</literal> +<value>width</value> +<value>height</value> </tag-name> <tag-desc> proportionally reduces an image to the specified sizes. To reduce by only one dimension, another dimension can be specified as -“<code>-</code>”. +“<literal>-</literal>”. In case of an error, the server will return code <http-status code="415" text="Unsupported Media Type"/>. -Values of arguments can contain variables. -When used along with the <parameter>rotate</parameter> parameter, +Values of parameters can contain variables. +When used along with the <literal>rotate</literal> parameter, the rotation happens <emphasis>after</emphasis> reduction. </tag-desc> -<tag-name><parameter>crop</parameter> -<argument>width</argument> -<argument>height</argument> +<tag-name><literal>crop</literal> +<value>width</value> +<value>height</value> </tag-name> <tag-desc> proportionally reduces an image to the size of the largest side and crops extraneous edges by another side. To reduce by only one dimension, another dimension can be specified as -“<code>-</code>”. +“<literal>-</literal>”. In case of an error, the server will return code <http-status code="415" text="Unsupported Media Type"/>. -Values of arguments can contain variables. -When used along with the <parameter>rotate</parameter> parameter, +Values of parameters can contain variables. +When used along with the <literal>rotate</literal> parameter, the rotation happens <emphasis>before</emphasis> reduction. </tag-desc> @@ -160,24 +160,25 @@ When a size is exceeded the server will <directive name="image_filter_jpeg_quality"> -<syntax><value>1..100</value></syntax> +<syntax><value>quality</value></syntax> <default>75</default> <context>http</context> <context>server</context> <context>location</context> <para> -Sets the desired quality of the transformed JPEG images. +Sets the desired <value>quality</value> of the transformed JPEG images. +Acceptable values are in the 1..100 range. Lesser values usually imply both lower image quality and less data to transfer. The maximum recommended value is 95. -The argument value can contain variables. +Value of the parameter can contain variables. </para> </directive> <directive name="image_filter_sharpen"> -<syntax><argument>percent</argument></syntax> +<syntax><value>percent</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -187,14 +188,14 @@ The argument value can contain variables Increases sharpness of the final image. The sharpness percentage can exceed 100. The value of 0 disables sharpening. -The argument value can contain variables. +Value of the parameter can contain variables. </para> </directive> <directive name="image_filter_transparency"> -<syntax><value>on</value>|<value>off</value></syntax> +<syntax><literal>on</literal>|<literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context>
--- a/xml/en/docs/http/ngx_http_index_module.xml +++ b/xml/en/docs/http/ngx_http_index_module.xml @@ -9,8 +9,8 @@ <section id="summary"> <para> -The module <code>ngx_http_index_module</code> processes requests -ending with the slash character (‘<code>/</code>’). +The module <literal>ngx_http_index_module</literal> processes requests +ending with the slash character (‘<literal>/</literal>’). </para> </section> @@ -32,7 +32,7 @@ ending with the slash character (‘<code>/</code>’). <section name="Directives" id="directives"> <directive name="index"> -<syntax><argument>file</argument>...</syntax> +<syntax><value>file</value> ...</syntax> <default>index.html</default> <context>http</context> <context>server</context> @@ -40,7 +40,7 @@ ending with the slash character (‘<code>/</code>’). <para> Defines files that will be used as an index. -The <argument>file</argument> name can contain variables. +The <value>file</value> name can contain variables. Files are checked in the specified order. The last element of the list can be a file with an absolute path. Example: @@ -62,8 +62,8 @@ For example, with the following configur ... } </example> -a request of “<code>/</code>” will actually be processed in the -second location as “<code>/index.html</code>”. +a request of “<literal>/</literal>” will actually be processed in the +second location as “<literal>/index.html</literal>”. </para> </directive>
--- a/xml/en/docs/http/ngx_http_limit_conn_module.xml +++ b/xml/en/docs/http/ngx_http_limit_conn_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -The <code>ngx_http_limit_conn_module</code> module allows +The <literal>ngx_http_limit_conn_module</literal> module allows to limit the number of connections per defined key, in particular, the number of connections from a single IP address. </para> @@ -48,7 +48,7 @@ http { <section id="directives" name="Directives"> <directive name="limit_conn"> -<syntax><argument>zone</argument> <argument>number</argument></syntax> +<syntax><value>zone</value> <value>number</value></syntax> <default/> <context>http</context> <context>server</context> @@ -72,7 +72,7 @@ allow for only a single connection at a </para> <para> -When several <code>limit_conn</code> directives are specified, +When several <literal>limit_conn</literal> directives are specified, any configured limit will apply. For example, the following configuration will limit the number of connections to the server per client IP and at the same time @@ -93,7 +93,7 @@ will limit the total number of connectio <para> These directives are inherited from the previous level if and only if there are no -<code>limit_conn</code> +<literal>limit_conn</literal> directives on the current level. </para> @@ -102,10 +102,10 @@ directives on the current level. <directive name="limit_conn_log_level"> <syntax> -<value>info</value> | -<value>notice</value> | -<value>warn</value> | -<value>error</value></syntax> +<literal>info</literal> | +<literal>notice</literal> | +<literal>warn</literal> | +<literal>error</literal></syntax> <default>error</default> <context>http</context> <context>server</context> @@ -122,8 +122,8 @@ limits the number of connections. <directive name="limit_conn_zone"> <syntax> - <argument>$variable</argument> - <parameter>zone</parameter>=<argument>name</argument>:<argument>size</argument></syntax> + <value>$variable</value> + <literal>zone</literal>=<value>name</value>:<value>size</value></syntax> <default/> <context>http</context> @@ -156,9 +156,9 @@ to all further requests. <directive name="limit_zone"> <syntax> - <argument>name</argument> - <argument>$variable</argument> - <argument>size</argument></syntax> + <value>name</value> + <value>$variable</value> + <value>size</value></syntax> <default/> <context>http</context> @@ -167,9 +167,9 @@ This directive is made obsolete in versi an equivalent <link id="limit_conn_zone"/> directive with a changed syntax should be used instead: <note> -<code>limit_conn_zone</code> -<argument>$variable</argument> -<parameter>zone</parameter>=<argument>name</argument>:<argument>size</argument>; +<literal>limit_conn_zone</literal> +<value>$variable</value> +<literal>zone</literal>=<value>name</value>:<value>size</value>; </note> </para>
--- a/xml/en/docs/http/ngx_http_limit_req_module.xml +++ b/xml/en/docs/http/ngx_http_limit_req_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -The <code>ngx_http_limit_req_module</code> module (0.7.21) allows +The <literal>ngx_http_limit_req_module</literal> module (0.7.21) allows to limit the number of requests per defined key, in particular, the number of requests from a single IP address. @@ -45,9 +45,9 @@ http { <directive name="limit_req"> <syntax> - <parameter>zone</parameter>=<argument>name</argument> - [<parameter>burst</parameter>=<argument>number</argument>] - [<parameter>nodelay</parameter>]</syntax> + <literal>zone</literal>=<value>name</value> + [<literal>burst</literal>=<value>number</value>] + [<literal>nodelay</literal>]</syntax> <default/> <context>http</context> <context>server</context> @@ -79,7 +79,7 @@ with bursts not exceeding 5 requests. <para> If delaying of excessive requests while requests are being limited is not -desired, the parameter <parameter>nodelay</parameter> should be used: +desired, the parameter <literal>nodelay</literal> should be used: <example> limit_req zone=one burst=5 nodelay; </example> @@ -90,10 +90,10 @@ desired, the parameter <parameter>nodela <directive name="limit_req_log_level"> <syntax> -<value>info</value> | -<value>notice</value> | -<value>warn</value> | -<value>error</value></syntax> +<literal>info</literal> | +<literal>notice</literal> | +<literal>warn</literal> | +<literal>error</literal></syntax> <default>error</default> <context>http</context> <context>server</context> @@ -104,8 +104,8 @@ desired, the parameter <parameter>nodela Sets the desired logging level for cases when the server limits the number of requests, or delays request processing. Delays are logged with the level one less than limits; for example, -if <command>limit_req_log_level notice</command> is specified, -delays are logged with the <value>info</value> level. +if “<literal>limit_req_log_level notice</literal>” is specified, +delays are logged with the <literal>info</literal> level. </para> </directive> @@ -113,9 +113,9 @@ delays are logged with the <value>info</ <directive name="limit_req_zone"> <syntax> - <argument>$variable</argument> - <parameter>zone</parameter>=<argument>name</argument>:<argument>size</argument> - <parameter>rate</parameter>=<argument>rate</argument></syntax> + <value>$variable</value> + <literal>zone</literal>=<value>name</value>:<value>size</value> + <literal>rate</literal>=<value>rate</value></syntax> <default/> <context>http</context>
--- a/xml/en/docs/http/ngx_http_log_module.xml +++ b/xml/en/docs/http/ngx_http_log_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -The <code>ngx_http_log_module</code> module writes request logs +The <literal>ngx_http_log_module</literal> module writes request logs in the specified format. </para> @@ -35,10 +35,10 @@ in the specified format. <directive name="access_log"> <syntax> - <argument>path</argument> - [<argument>format</argument> - [<parameter>buffer</parameter>=<argument>size</argument>]]</syntax> -<syntax><value>off</value></syntax> + <value>path</value> + [<value>format</value> + [<literal>buffer</literal>=<value>size</value>]]</syntax> +<syntax><literal>off</literal></syntax> <default>log/access.log combined</default> <context>http</context> <context>server</context> @@ -49,10 +49,10 @@ in the specified format. <para> Sets the path, format, and buffer size for the buffered log writes. Several logs can be specified on the same level. -The special value <value>off</value> cancels all <code>access_log</code> +The special value <literal>off</literal> cancels all <literal>access_log</literal> directives on the current level. If format is not specified then the predefined format -“<code>combined</code>” is used. +“<literal>combined</literal>” is used. </para> <para> @@ -80,7 +80,7 @@ buffered writes do not work; a file is opened and closed for each log write. However, since the descriptors of frequently used files can be stored in a <link id="open_log_file_cache">cache</link>, writes during the -time specified by the <parameter>valid</parameter> parameter of the +time specified by the <literal>valid</literal> parameter of the <link id="open_log_file_cache"/> directive can continue to be made to the old file. </listitem> @@ -92,7 +92,7 @@ is checked, and if it does not exist the created. It is thus a good idea to specify both <link doc="ngx_http_core_module.xml" id="root"/> -and <code>access_log</code> on the same level: +and <literal>access_log</literal> on the same level: <example> server { root /spool/vhost/data/$host; @@ -109,8 +109,8 @@ server { <directive name="log_format"> <syntax> - <argument>name</argument> - <argument>string</argument> ...</syntax> + <value>name</value> + <value>string</value> ...</syntax> <default>combined "..."</default> <context>http</context> @@ -126,8 +126,8 @@ exist only at the time of a log write: <tag-name><var>$body_bytes_sent</var></tag-name> <tag-desc> the number of bytes sent to a client not counting the response header; -this variable is compatible with the “<code>%B</code>” parameter of the -<code>mod_log_config</code> +this variable is compatible with the “<literal>%B</literal>” parameter of the +<literal>mod_log_config</literal> Apache module </tag-desc> @@ -148,7 +148,8 @@ time in seconds with a milliseconds reso <tag-name><var>$pipe</var></tag-name> <tag-desc> -“<code>p</code>” if request was pipelined, “<code>.</code>” otherwise +“<literal>p</literal>” if request was pipelined, “<literal>.</literal>” +otherwise </tag-desc> <tag-name><var>$request_length</var></tag-name> @@ -183,13 +184,13 @@ local time in the Common Log Format <para> Header lines sent to a client have the prefix -“<code>sent_http_</code>”, for example, +“<literal>sent_http_</literal>”, for example, <var>$sent_http_content_range</var>. </para> <para> The configuration always includes the predefined format -“<code>combined</code>”: +“<literal>combined</literal>”: <example> log_format combined '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' @@ -202,11 +203,11 @@ The configuration always includes the pr <directive name="open_log_file_cache"> <syntax> -<parameter>max</parameter>=<argument>N</argument> -[<parameter>inactive</parameter>=<argument>time</argument>] -[<parameter>min_uses</parameter>=<argument>N</argument>] -[<parameter>valid</parameter>=<argument>time</argument>]</syntax> -<syntax><value>off</value></syntax> +<literal>max</literal>=<value>N</value> +[<literal>inactive</literal>=<value>time</value>] +[<literal>min_uses</literal>=<value>N</value>] +[<literal>valid</literal>=<value>time</value>]</syntax> +<syntax><literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -218,35 +219,35 @@ whose names contain variables. The directive has the following parameters: <list type="tag"> -<tag-name><parameter>max</parameter></tag-name> +<tag-name><literal>max</literal></tag-name> <tag-desc> sets a maximum number of descriptors in a cache; if cache becomes full the least recently used (LRU) descriptors are closed </tag-desc> -<tag-name><parameter>inactive</parameter></tag-name> +<tag-name><literal>inactive</literal></tag-name> <tag-desc> sets a time after which the cached descriptor is closed if there were no access during this time; by default, 10 seconds </tag-desc> -<tag-name><parameter>min_uses</parameter></tag-name> +<tag-name><literal>min_uses</literal></tag-name> <tag-desc> sets a minimum number of file uses during the time -defined by the <parameter>inactive</parameter> parameter +defined by the <literal>inactive</literal> parameter after which the descriptor will stay open in a cache; by default, 1 </tag-desc> -<tag-name><parameter>valid</parameter></tag-name> +<tag-name><literal>valid</literal></tag-name> <tag-desc> sets a time after which it should be checked that the file still exists with the same name; by default, 60 seconds </tag-desc> -<tag-name><value>off</value></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> disables caching </tag-desc>
--- a/xml/en/docs/http/ngx_http_mp4_module.xml +++ b/xml/en/docs/http/ngx_http_mp4_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -The module <code>ngx_http_mp4_module</code> provides pseudo-streaming +The module <literal>ngx_http_mp4_module</literal> provides pseudo-streaming server-side support for H.264/AAC files typically having filename extensions <path>.mp4</path>, <path>.m4v</path>, and <path>.m4a</path>. </para> @@ -18,7 +18,7 @@ server-side support for H.264/AAC files Pseudo-streaming works in alliance with conforming Flash players. A player sends an HTTP request to the server with a start time argument in the request URI’s query string (named simply -<parameter>start</parameter> +<literal>start</literal> and specified in seconds), and the server responds with a stream so that its start position corresponds to the requested time, for example: @@ -39,7 +39,7 @@ whole file. <para> To start playback, a player first needs to read metadata. This is done by sending a special request with the -<parameter>start=0</parameter> +<literal>start=0</literal> argument. Many encoding software will insert the metadata at the end of the file. This is bad for pseudo-streaming: the metadata needs to be located at the beginning of the file, @@ -58,7 +58,7 @@ rather than having nginx do this on ever <para> For a matching request with a non-zero -<parameter>start</parameter> +<literal>start</literal> argument, nginx will read metadata from the file, prepare the stream starting from the requested offset, and send it to a client. This has the same overhead as described above. @@ -66,7 +66,7 @@ This has the same overhead as described <para> If a matching request does not include the -<parameter>start</parameter> +<literal>start</literal> argument, there is no overhead, and the file is just sent as a static resource. Some players also support byte-range requests, and thus do not require this module at all. @@ -74,7 +74,7 @@ this module at all. <para> This module is not built by default, it should be enabled with the -<code>--with-http_mp4_module</code> +<literal>--with-http_mp4_module</literal> configuration parameter. <note> If you were using the third-party mp4 module, be sure to disable it. @@ -119,7 +119,7 @@ Turns on module processing in a surround <directive name="mp4_buffer_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>512K</default> <context>http</context> <context>server</context> @@ -133,7 +133,7 @@ Sets the initial size of a memory buffer <directive name="mp4_max_buffer_size"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default>10M</default> <context>http</context> <context>server</context> @@ -141,7 +141,7 @@ Sets the initial size of a memory buffer <para> During metadata processing, a larger buffer may become necessary. -Its size cannot exceed the specified <argument>size</argument>, +Its size cannot exceed the specified <value>size</value>, or else nginx will return the server error <http-status code="500" text="Internal Server Error"/>, and log the following:
--- a/xml/en/docs/http/ngx_http_random_index_module.xml +++ b/xml/en/docs/http/ngx_http_random_index_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -The module <code>ngx_http_random_index_module</code> picks a random +The module <literal>ngx_http_random_index_module</literal> picks a random file in a directory as an index file. It works before the <link doc="ngx_http_index_module.xml">ngx_http_index_module</link> @@ -18,7 +18,7 @@ module. <para> This module is not built by default, it should be enabled with the -<code>--with-http_random_index_module</code> +<literal>--with-http_random_index_module</literal> configuration parameter. </para> @@ -41,7 +41,7 @@ configuration parameter. <section name="Directives" id="directives"> <directive name="random_index"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>location</context>
--- a/xml/en/docs/http/request_processing.xml +++ b/xml/en/docs/http/request_processing.xml @@ -44,8 +44,8 @@ then nginx will route the request to the In the configuration above, the default server is the first one—which is nginx’s standard default behaviour. If you do not want the first server listed to be the default server, -you may set it explicitly with the <dirname>default_server</dirname> parameter -in the <dirname>listen</dirname> directive: +you may set it explicitly with the <literal>default_server</literal> parameter +in the <link doc="ngx_http_core_module.xml" id="listen"/> directive: <programlisting> server { @@ -56,9 +56,9 @@ server { </programlisting> <note> -The <dirname>default_server</dirname> parameter has been available since +The <literal>default_server</literal> parameter has been available since version 0.8.21. -In earlier versions the <dirname>default</dirname> parameter should be used +In earlier versions the <literal>default</literal> parameter should be used instead. </note> @@ -89,7 +89,7 @@ requests without the <header>Host</heade and a special nginx’s non-standard code 444 is returned that closes the connection. Since version 0.8.48, this is the default setting for the -server name, so the <code>server_name ""</code> can be omitted. +server name, so the <literal>server_name ""</literal> can be omitted. In earlier versions, the machine's <i>hostname</i> was used as a default server name. </para> @@ -125,10 +125,16 @@ server { </programlisting> In this configuration, nginx first tests the IP address and port -of the request against the <dirname>listen</dirname> directives -of the <dirname>server</dirname> blocks. It then tests the “Host” -header line of the request against the <dirname>server_name</dirname> -entries of the <dirname>server</dirname> blocks that matched +of the request against the +<link doc="ngx_http_core_module.xml" id="listen"/> directives +of the +<link doc="ngx_http_core_module.xml" id="server"/> blocks. +It then tests the “Host” +header line of the request against the +<link doc="ngx_http_core_module.xml" id="server_name"/> +entries of the +<link doc="ngx_http_core_module.xml" id="server"/> +blocks that matched the IP address and port. If the server name is not found, the request will be processed by @@ -201,7 +207,7 @@ server { <para> nginx first searches for the most specific location given by literal strings regardless of the listed order. In the configuration above -the only literal location is “<code>/</code>” and since it matches +the only literal location is “<literal>/</literal>” and since it matches any request it will be used as a last resort. Then nginx checks locations given by regular expression in the order listed in the configuration file. @@ -235,11 +241,11 @@ in the configuration above: <item> <para> -A request “<code>/logo.gif</code>” is matched by the literal location -“<code>/</code>” first and then by the regular expression -“<code>\.(gif|jpg|png)$</code>”, +A request “<literal>/logo.gif</literal>” is matched by the literal location +“<literal>/</literal>” first and then by the regular expression +“<literal>\.(gif|jpg|png)$</literal>”, therefore, it is handled by the latter location. -Using the directive “<code>root /data/www</code>” the request +Using the directive “<literal>root /data/www</literal>” the request is mapped to a file <path>/data/www/logo.gif</path>, and the file is sent to the client. </para> @@ -247,25 +253,29 @@ is sent to the client. <item> <para> -A request “<code>/index.php</code>” is also matched by the literal location -“<code>/</code>” first and then by the regular expression -“<code>\.(php)$</code>”. Therefore, it is handled by the latter location +A request “<literal>/index.php</literal>” is also matched by the literal location +“<literal>/</literal>” first and then by the regular expression +“<literal>\.(php)$</literal>”. Therefore, it is handled by the latter location and the request is passed to a FastCGI server listening on localhost:9000. -The <dirname>fastcgi_param</dirname> directive sets the FastCGI parameter -SCRIPT_FILENAME to “<code>/data/www/index.php</code>”, +The +<link doc="ngx_http_fastcgi_module.xml" id="fastcgi_param"/> +directive sets the FastCGI parameter +SCRIPT_FILENAME to “<literal>/data/www/index.php</literal>”, and the FastCGI server executes the file. The variable $document_root is equal to -the value of the <dirname>root</dirname> directive and +the value of the +<link doc="ngx_http_core_module.xml" id="root"/> +directive and the variable $fastcgi_script_name is equal to the request URI, -i.e. “<code>/index.php</code>”. +i.e. “<literal>/index.php</literal>”. </para> </item> <item> <para> -A request “<code>/about.html</code>” is matched by the literal location -“<code>/</code>” only, therefore, it is handled in this location. -Using the directive “<code>root /data/www</code>” the request is mapped +A request “<literal>/about.html</literal>” is matched by the literal location +“<literal>/</literal>” only, therefore, it is handled in this location. +Using the directive “<literal>root /data/www</literal>” the request is mapped to the file <path>/data/www/about.html</path>, and the file is sent to the client. </para> @@ -273,15 +283,18 @@ to the client. <item> <para> -Handling a request “<code>/</code>” is more complex. -It is matched by the literal location “<code>/</code>” only, +Handling a request “<literal>/</literal>” is more complex. +It is matched by the literal location “<literal>/</literal>” only, therefore, it is handled by this location. -Then the <dirname>index</dirname> directive tests for the existence +Then the +<link doc="ngx_http_index_module.xml" id="index"/> +directive tests for the existence of an index file according to its parameters and -the “<code>root /data/www</code>” directive. +the “<literal>root /data/www</literal>” directive. If a file <path>/data/www/index.php</path> exists, -then the directive does an internal redirect to “<code>/index.php</code>”, and -nginx searches the locations again as if the request had been sent by a client. +then the directive does an internal redirect to “<literal>/index.php</literal>”, +and nginx searches the locations again +as if the request had been sent by a client. As we saw before, the redirected request will eventually be handled by the FastCGI server. </para>
--- a/xml/en/docs/http/server_names.xml +++ b/xml/en/docs/http/server_names.xml @@ -10,7 +10,9 @@ <section> <para> -Server names are defined using the <dirname>server_name</dirname> directive +Server names are defined using the +<link doc="ngx_http_core_module.xml" id="server_name"/> +directive and determine which server block is used for a given request. See also “<a href="/en/docs/http/request_processing.xml" />”. They may be defined using exact names, wildcard names, or regular expressions: @@ -73,20 +75,20 @@ The first match stops the search. <para> A wildcard name may contain an asterisk only on the name's start or end, -and only on a dot border. The names <dirname>www.*.nginx.org</dirname> -and <dirname>w*.nginx.org</dirname> are invalid. +and only on a dot border. The names “<literal>www.*.nginx.org</literal>” +and “<literal>w*.nginx.org</literal>” are invalid. However, these names can be specified using regular expressions, -for example, <dirname>~^www\..+\.nginx\.org$</dirname> and -<dirname>~^w.*\.nginx\.org$</dirname>. +for example, “<literal>~^www\..+\.nginx\.org$</literal>” and +“<literal>~^w.*\.nginx\.org$</literal>”. An asterisk can match several name parts. -The name <dirname>*.nginx.org</dirname> matches not only +The name “<literal>*.nginx.org</literal>” matches not only <url>www.nginx.org</url> but <url>www.sub.nginx.org</url> as well. </para> <para> -A special wildcard in the form <dirname>.nginx.org</dirname> can be used -to match both the exact name <dirname>nginx.org</dirname> -and the wildcard name <dirname>*.nginx.org</dirname>. +A special wildcard in the form “<literal>.nginx.org</literal>” can be used +to match both the exact name “<literal>nginx.org</literal>” +and the wildcard name “<literal>*.nginx.org</literal>”. </para> </section> @@ -140,17 +142,17 @@ The PCRE library supports named captures <table note="yes"> <tr> -<td><code>?<<i>name</i>></code></td> +<td><literal>?<<value>name</value>></literal></td> <td>Perl 5.10 compatible syntax, supported since PCRE-7.0</td> </tr> <tr> -<td><code>?'<i>name</i>'</code></td> +<td><literal>?'<value>name</value>'</literal></td> <td>Perl 5.10 compatible syntax, supported since PCRE-7.0</td> </tr> <tr> -<td><code>?P<<i>name</i>></code></td> +<td><literal>?P<<value>name</value>></literal></td> <td>Python compatible syntax, supported since PCRE-4.0</td> </tr> @@ -163,7 +165,7 @@ pcre_compile() failed: unrecognized char </programlisting> this means that the PCRE library is old -and you should try the syntax <dirname>?P<<i>name</i>></dirname>. +and you should try the syntax “<literal>?P<<value>name</value>></literal>”. The captures can also be used in digital form: <programlisting> @@ -201,7 +203,9 @@ server { </para> <para> -If no <dirname>server_name</dirname> is defined in a server block, +If no +<link doc="ngx_http_core_module.xml" id="server_name"/> +is defined in a server block, then nginx uses the empty name as the server name. <note> nginx versions up to 0.8.48 used the <i>hostname</i> as the server name @@ -248,13 +252,23 @@ nginx versions up to 0.6.25 supported th which was erroneously interpreted to be a catch-all name. It never functioned as a catch-all or wildcard server name. Instead, it supplied the functionality that is now provided -by the <dirname>server_name_in_redirect</dirname> directive. +by the +<link doc="ngx_http_core_module.xml" id="server_name_in_redirect"/> +directive. The special name “*” is now deprecated -and the <dirname>server_name_in_redirect</dirname> directive should be used. +and the +<link doc="ngx_http_core_module.xml" id="server_name_in_redirect"/> +directive should be used. Note that there is no way to specify the catch-all name or -the <i>default</i> server using the <dirname>server_name</dirname> directive. -This is a property of the <dirname>listen</dirname> directive -and not of the <dirname>server_name</dirname> directive. +the <i>default</i> server using the +<link doc="ngx_http_core_module.xml" id="server_name"/> +directive. +This is a property of the +<link doc="ngx_http_core_module.xml" id="listen"/> +directive +and not of the +<link doc="ngx_http_core_module.xml" id="server_name"/> +directive. See also “<a href="/en/docs/http/request_processing.xml" />”. You can define servers listening on ports *:80 and *:8080, and direct that one will be the default server for port *:8080, @@ -298,7 +312,7 @@ If the name is not found there, the wild ending with an asterisk is searched. Searching wildcard names hashes is slower than searching exact name hash because names are searched by domain parts. -Note that the special wildcard form <dirname>.nginx.org</dirname> +Note that the special wildcard form “<literal>.nginx.org</literal>” is stored in a wildcard names hash and not in an exact names hash. Regular expressions are tested sequentially and therefore are the slowest method and are non-scalable. @@ -332,10 +346,11 @@ server { <para> If you have defined a large number of server names, or defined unusually long server names, you may need to tune -the <dirname>server_names_hash_max_size</dirname> -and <dirname>server_names_hash_bucket_size</dirname> directives -at the <i>http</i> level. -The default value of the <dirname>server_names_hash_bucket_size</dirname> +the <link doc="ngx_http_core_module.xml" id="server_names_hash_max_size"/> +and <link doc="ngx_http_core_module.xml" id="server_names_hash_bucket_size"/> +directives at the <i>http</i> level. +The default value of the +<link doc="ngx_http_core_module.xml" id="server_names_hash_bucket_size"/> may be equal to 32, or 64, or another value, depending on your CPU cache line size. If the default value is 32 and you define @@ -364,18 +379,22 @@ you should increase either server_names_ or server_names_hash_bucket_size: 32 </programlisting> -You should first try to set <dirname>server_names_hash_max_size</dirname> +You should first try to set +<link doc="ngx_http_core_module.xml" id="server_names_hash_max_size"/> to a number close to the number of server names. Only if this does not help, or if nginx’s start time is unacceptably long, -should you try to increase <dirname>server_names_hash_bucket_size</dirname>. +should you try to increase +<link doc="ngx_http_core_module.xml" id="server_names_hash_bucket_size"/>. </para> <para> If a server is the only server for a listen port, then nginx will not test server names at all (and will not build the hashes for the listen port). However, there is one exception. -If a <dirname>server_name</dirname> is a regular expression with captures, +If a +<link doc="ngx_http_core_module.xml" id="server_name"/> +is a regular expression with captures, then nginx has to execute the expression to get the captures. </para>
--- a/xml/en/docs/install.xml +++ b/xml/en/docs/install.xml @@ -10,87 +10,87 @@ The build is configured using the <command>configure</command> command. It defines various aspects of the system, including the methods nginx is allowed to use for connection processing. -At the end it creates a <command>Makefile</command>. +At the end it creates a <path>Makefile</path>. The <command>configure</command> command supports the following parameters: <list> <listitem> <para> -<command>--prefix=<<value>path</value>></command>—defines +<literal>--prefix=<value>path</value></literal>—defines a directory that will keep server files. This same directory will also be used for all relative paths set by -<command>./configure</command> (except for paths to libraries sources) -and in the <command>nginx.conf</command> configuration file. -It is set to the <command>/usr/local/nginx</command> directory by default. +<command>configure</command> (except for paths to libraries sources) +and in the <path>nginx.conf</path> configuration file. +It is set to the <path>/usr/local/nginx</path> directory by default. </para> </listitem> <listitem> <para> -<command>--sbin-path=<<value>path</value>></command>—sets +<literal>--sbin-path=<value>path</value></literal>—sets the name of an nginx executable file. This name is used only during installation. By default the file is named -<command><<value>prefix</value>>/sbin/nginx</command>. +<path><value>prefix</value>/sbin/nginx</path>. </para> </listitem> <listitem> <para> -<command>--conf-path=<<value>path</value>></command>—sets -the name of an <command>nginx.conf</command> configuration file. +<literal>--conf-path=<value>path</value></literal>—sets +the name of an <path>nginx.conf</path> configuration file. If needs be, nginx can always be started with a different configuration file, by specifying it in the command-line parameter -<nobr><command>-c <<value>file</value>></command></nobr>. +<nobr><literal>-c <value>file</value></literal></nobr>. By default the file is named -<command><<value>prefix</value>>/conf/nginx.conf</command>. +<path><value>prefix</value>/conf/nginx.conf</path>. </para> </listitem> <listitem> <para> -<command>--pid-path=<<value>path</value>></command>—sets +<literal>--pid-path=<value>path</value></literal>—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 -<command>nginx.conf</command> configuration file using the +<path>nginx.conf</path> configuration file using the <link doc="ngx_core_module.xml" id="pid"/> directive. By default the file is named -<command><<value>prefix</value>>/logs/nginx.pid</command>. +<path><value>prefix</value>/logs/nginx.pid</path>. </para> </listitem> <listitem> <para> -<command>--error-log-path=<<value>path</value>></command>—sets +<literal>--error-log-path=<value>path</value></literal>—sets the name of the primary error, warnings, and diagnostic file. After installation, the file name can always be changed in the -<command>nginx.conf</command> configuration file using the +<path>nginx.conf</path> configuration file using the <link doc="ngx_core_module.xml" id="error_log"/> directive. By default the file is named -<command><<value>prefix</value>>/logs/error.log</command>. +<path><value>prefix</value>/logs/error.log</path>. </para> </listitem> <listitem> <para> -<command>--http-log-path=<<value>path</value>></command>—sets +<literal>--http-log-path=<value>path</value></literal>—sets the name of the primary request log file of the HTTP server. After installation, the file name can always be changed in the -<command>nginx.conf</command> configuration file using the +<path>nginx.conf</path> configuration file using the <link doc="http/ngx_http_log_module.xml" id="access_log"/> directive. By default the file is named -<command><<value>prefix</value>>/logs/access.log</command>. +<path><value>prefix</value>/logs/access.log</path>. </para> </listitem> <listitem> <para> -<command>--user=<<value>name</value>></command>—sets +<literal>--user=<value>name</value></literal>—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 -<command>nginx.conf</command> configuration file using the +<path>nginx.conf</path> configuration file using the <link doc="ngx_core_module.xml" id="user"/> directive. The default user name is nobody. </para> @@ -98,11 +98,11 @@ The default user name is nobody. <listitem> <para> -<command>--group=<<value>name</value>></command>—sets +<literal>--group=<value>name</value></literal>—sets the name of a group whose credentials will be used by worker processes. After installation, the name can always be changed in the -<command>nginx.conf</command> configuration file using the +<path>nginx.conf</path> configuration file using the <link doc="ngx_core_module.xml" id="user"/> directive. By default, a group name is set to the name of an unprivileged user. </para> @@ -110,8 +110,8 @@ By default, a group name is set to the n <listitem> <para> -<command>--with-select_module</command><br/> -<command>--without-select_module</command>—enables or disables +<literal>--with-select_module</literal><br/> +<literal>--without-select_module</literal>—enables or disables building a module that allows the server to work with the <c-func>select</c-func> method. This module is built automatically if the platform does not appear @@ -121,8 +121,8 @@ to support more appropriate methods such <listitem> <para> -<command>--with-poll_module</command><br/> -<command>--without-poll_module</command>—enables or disables +<literal>--with-poll_module</literal><br/> +<literal>--without-poll_module</literal>—enables or disables building a module that allows the server to work with the <c-func>poll</c-func> method. This module is built automatically if the platform does not appear @@ -132,7 +132,7 @@ to support more appropriate methods such <listitem> <para> -<command>--without-http_gzip_module</command>—disables building a module +<literal>--without-http_gzip_module</literal>—disables building a module that <link doc="http/ngx_http_gzip_module.xml">compresses responses</link> of an HTTP server. The zlib library is required to build and run this module. @@ -141,7 +141,7 @@ The zlib library is required to build an <listitem> <para> -<command>--without-http_rewrite_module</command>—disables building a +<literal>--without-http_rewrite_module</literal>—disables building a module that allows an HTTP server to <link doc="http/ngx_http_rewrite_module.xml">redirect requests and change URI of requests</link>. @@ -152,7 +152,7 @@ The module is experimental—its dir <listitem> <para> -<command>--without-http_proxy_module</command>—disables building an +<literal>--without-http_proxy_module</literal>—disables building an HTTP server <link doc="http/ngx_http_proxy_module.xml">proxying module</link>. <!-- The MD5 library is required to build and run this module. @@ -162,7 +162,7 @@ The MD5 library is required to build and <listitem> <para> -<command>--with-http_ssl_module</command>—enables building a module +<literal>--with-http_ssl_module</literal>—enables building a module that adds the <link doc="http/ngx_http_ssl_module.xml">HTTPS protocol support</link> to an HTTP server. This module is not built by default. @@ -172,7 +172,7 @@ The OpenSSL library is required to build <listitem> <para> -<command>--with-pcre=<<value>path</value>></command>—sets +<literal>--with-pcre=<value>path</value></literal>—sets the path to the sources of the PCRE library. The library distribution (version 4.4—6.1) needs to be downloaded from the @@ -188,7 +188,7 @@ module. <listitem> <para> -<command>--with-zlib=<<value>path</value>></command>—sets +<literal>--with-zlib=<value>path</value></literal>—sets the path to the sources of the zlib library. The library distribution (version 1.1.3—1.2.2) needs to be downloaded from the @@ -201,23 +201,23 @@ The library is required for the <listitem> <para> -<command>--with-cc-opt=<<value>parameters</value>></command>—sets +<literal>--with-cc-opt=<value>parameters</value></literal>—sets additional parameters that will be added to the CFLAGS variable. When using the system PCRE library under FreeBSD, -<command>--with-cc-opt="-I /usr/local/include"</command> +<literal>--with-cc-opt="-I /usr/local/include"</literal> should be specified. If the number of files supported by <c-func>select</c-func> needs to be increased it can also be specified here such as this: -<command>--with-cc-opt="-D FD_SETSIZE=2048"</command>. +<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. </para> </listitem> <listitem> <para> -<command>--with-ld-opt=<<value>parameters</value>></command>—sets +<literal>--with-ld-opt=<value>parameters</value></literal>—sets additional parameters that will be used during linking. When using the system PCRE library under FreeBSD, -<command>--with-ld-opt="-L /usr/local/lib"</command> +<literal>--with-ld-opt="-L /usr/local/lib"</literal> should be specified. </para> </listitem>
--- a/xml/en/docs/ngx_core_module.xml +++ b/xml/en/docs/ngx_core_module.xml @@ -30,7 +30,7 @@ events { <section id="directives" name="Directives"> <directive name="daemon"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>main</context> @@ -44,15 +44,15 @@ Mainly used during development. <directive name="error_log"> <syntax> -<argument>file</argument> -[<value>debug</value> | -<value>info</value> | -<value>notice</value> | -<value>warn</value> | -<value>error</value> | -<value>crit</value> | -<value>alert</value> | -<value>emerg</value>]</syntax> +<value>file</value> +[<literal>debug</literal> | +<literal>info</literal> | +<literal>notice</literal> | +<literal>warn</literal> | +<literal>error</literal> | +<literal>crit</literal> | +<literal>alert</literal> | +<literal>emerg</literal>]</syntax> <default>logs/error.log error</default> <context>main</context> <context>http</context> @@ -64,24 +64,24 @@ Configures logging. </para> <para> -The first argument defines a file that will store the log. +The first parameter defines a file that will store the log. <!-- If filename is not absolute, it is prefixed with the prefix path. --> </para> <para> -The second argument determines the level of logging. +The second parameter determines the level of logging. Log levels above are listed in the order of increasing severity. Setting a certain log level will cause all messages of the specified and more severe log levels to be logged. -For example, the default level <value>error</value> will -cause <value>error</value>, <value>crit</value>, -<value>alert</value>, and <value>emerg</value> messages +For example, the default level <literal>error</literal> will +cause <literal>error</literal>, <literal>crit</literal>, +<literal>alert</literal>, and <literal>emerg</literal> messages to be logged. <note> -For <value>debug</value> logging to work, nginx needs to -be built with <code>--with-debug</code>. +For <literal>debug</literal> logging to work, nginx needs to +be built with <literal>--with-debug</literal>. </note> </para> @@ -89,7 +89,7 @@ be built with <code>--with-debug</code>. <directive name="env"> -<syntax><argument>variable</argument>[=<argument>value</argument>]</syntax> +<syntax><value>variable</value>[=<value>value</value>]</syntax> <default>TZ</default> <context>main</context> @@ -142,13 +142,13 @@ env OPENSSL_ALLOW_PROXY_CERTS=1; <directive name="include"> -<syntax><argument>file</argument> | <argument>mask</argument></syntax> +<syntax><value>file</value> | <value>mask</value></syntax> <default/> <context/> <para> -Includes another <argument>file</argument>, or files matching the -specified <argument>mask</argument>, into configuration. +Includes another <value>file</value>, or files matching the +specified <value>mask</value>, into configuration. Included files should consist of syntactically correct directives and blocks. </para> @@ -165,7 +165,7 @@ include vhosts/*.conf; <directive name="master_process"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>main</context> @@ -178,19 +178,19 @@ This directive is intended for nginx dev <directive name="pid"> -<syntax><argument>file</argument></syntax> +<syntax><value>file</value></syntax> <default>nginx.pid</default> <context>main</context> <para> -Defines a <argument>file</argument> which will store the process ID of the main process. +Defines a <value>file</value> that will store the process ID of the main process. </para> </directive> <directive name="ssl_engine"> -<syntax><argument>device</argument></syntax> +<syntax><value>device</value></syntax> <default/> <context>main</context> @@ -202,7 +202,7 @@ Defines the name of the hardware SSL acc <directive name="timer_resolution"> -<syntax><argument>interval</argument></syntax> +<syntax><value>interval</value></syntax> <default/> <context>main</context> @@ -212,7 +212,7 @@ number of <c-func>gettimeofday</c-func> By default, <c-func>gettimeofday</c-func> is called each time on receiving a kernel event. With reduced resolution, <c-func>gettimeofday</c-func> is only -called once per specified <argument>interval</argument>. +called once per specified <value>interval</value>. </para> <para> @@ -227,11 +227,11 @@ An internal implementation of interval d <list type="bullet"> <listitem> -an <c-def>EVFILT_TIMER</c-def> filter if <value>kqueue</value> is used; +an <c-def>EVFILT_TIMER</c-def> filter if <literal>kqueue</literal> is used; </listitem> <listitem> -<c-func>timer_create</c-func> if <value>eventport</value> is used; +<c-func>timer_create</c-func> if <literal>eventport</literal> is used; </listitem> <listitem> @@ -245,29 +245,29 @@ an <c-def>EVFILT_TIMER</c-def> filter if <directive name="user"> -<syntax><argument>user</argument> [<argument>group</argument>]</syntax> +<syntax><value>user</value> [<value>group</value>]</syntax> <default>nobody nobody</default> <context>main</context> <para> -Defines <argument>user</argument> and <argument>group</argument> +Defines <value>user</value> and <value>group</value> credentials used by worker processes. -If <argument>group</argument> is omitted, a group whose name equals -that of <argument>user</argument> is used. +If <value>group</value> is omitted, a group whose name equals +that of <value>user</value> is used. </para> </directive> <directive name="worker_priority"> -<syntax><argument>number</argument></syntax> +<syntax><value>number</value></syntax> <default>0</default> <context>main</context> <para> Defines a scheduling priority for worker processes like is done by the <command>nice</command> command: a negative -<argument>number</argument> +<value>number</value> means higher priority. Allowed range normally varies from -20 to 20. </para> @@ -283,7 +283,7 @@ worker_priority -10; <directive name="worker_processes"> -<syntax><argument>number</argument></syntax> +<syntax><value>number</value></syntax> <default>1</default> <context>main</context> @@ -303,7 +303,7 @@ would be a good start. <directive name="worker_rlimit_core"> -<syntax><argument>size</argument></syntax> +<syntax><value>size</value></syntax> <default/> <context>main</context> @@ -317,7 +317,7 @@ Used to increase the limit without resta <directive name="worker_rlimit_nofile"> -<syntax><argument>number</argument></syntax> +<syntax><value>number</value></syntax> <default/> <context>main</context> @@ -331,7 +331,7 @@ Used to increase the limit without resta <directive name="working_directory"> -<syntax><argument>directory</argument></syntax> +<syntax><value>directory</value></syntax> <default/> <context>main</context>
--- a/xml/en/download.xml +++ b/xml/en/download.xml @@ -150,7 +150,7 @@ <item> Read-only Subversion repository: -<code>svn://svn.nginx.org/nginx</code> +<literal>svn://svn.nginx.org/nginx</literal> </item> <item> @@ -173,7 +173,7 @@ or the apt repository for the Debian/Ubu <para> To set up the yum repository for RHEL/CentOS, choose the corresponding -<code>nginx-release</code> package from the list: +<literal>nginx-release</literal> package from the list: <list> @@ -203,7 +203,7 @@ yum install nginx </programlisting> Alternatively, a repository configuration can be added manually -without installing the <code>nginx-release</code> package. +without installing the <literal>nginx-release</literal> package. Create the file named <path>/etc/yum.repos.d/nginx.repo</path> with the following contents: @@ -215,9 +215,10 @@ gpgcheck=0 enabled=1 </programlisting> -Replace “<code>OS</code>” with “<code>rhel</code>” or “<code>centos</code>”, -depending on the distribution used, and “<code>OSRELEASE</code>” -with “<code>5</code>” or “<code>6</code>”, +Replace “<literal>OS</literal>” with “<literal>rhel</literal>” or +“<literal>centos</literal>”, +depending on the distribution used, and “<literal>OSRELEASE</literal>” +with “<literal>5</literal>” or “<literal>6</literal>”, for 5.x or 6.x versions, respectively. </para>
--- a/xml/he/docs/http/server_names.xml +++ b/xml/he/docs/http/server_names.xml @@ -9,7 +9,7 @@ <section> <para> -שמות שרת מוגדרים על ידי המאפיין <dirname>server_name</dirname> +שמות שרת מוגדרים על ידי המאפיין <literal>server_name</literal> והם קובעים איזה בלוק תצורת שרת מקובץ התצורה יהיה בשימוש לכל בקשה ובקשה לשרת. ראו גם “<a href="/en/docs/http/request_processing.xml" />”. ניתן להגדירם באמצעות שמות מדוייקים, שמות Wildcard, או באמצעות ביטויים רגולריים: @@ -72,20 +72,20 @@ server { <para> שם wildcard יכול להכיל כוכבית רק בתחילת או בסוף השם, וחייב להיות בגבול של נקודה. -השמות <dirname>www.*.nginx.org</dirname> -ו <dirname>w*.nginx.org</dirname> הם שגויים. +השמות <literal>www.*.nginx.org</literal> +ו <literal>w*.nginx.org</literal> הם שגויים. למרות זאת, ניתן לציין שמות כאלה באמצעות ביטויים רגולריים, -לדוגמא, <dirname>~^www\..+\.nginx\.org$</dirname> ו -<dirname>~^w.*\.nginx\.org$</dirname>. +לדוגמא, <literal>~^www\..+\.nginx\.org$</literal> ו +<literal>~^w.*\.nginx\.org$</literal>. סימן הכוכבית יכול להחליף מספר חלקי שם. -השם <dirname>*.nginx.org</dirname> מתאים לא רק ל +השם <literal>*.nginx.org</literal> מתאים לא רק ל <url>www.nginx.org</url> אלא גם ל <url>www.sub.nginx.org</url>. </para> <para> -ניתן להשתמש ב wildcard מיוחד בצורה של <dirname>.nginx.org</dirname> -כדי להתאים גם לשם המדוייק <dirname>nginx.org</dirname> -וגם לשם ה wildcard הבא: <dirname>*.nginx.org</dirname>. +ניתן להשתמש ב wildcard מיוחד בצורה של <literal>.nginx.org</literal> +כדי להתאים גם לשם המדוייק <literal>nginx.org</literal> +וגם לשם ה wildcard הבא: <literal>*.nginx.org</literal>. </para> </section> @@ -139,17 +139,17 @@ server { <table note="yes"> <tr> -<td><code>?<<i>name</i>></code></td> +<td><literal>?<<value>name</value>></literal></td> <td>תחביר תואם פרל 5.10, נתמך החל מ PCRE-7.0</td> </tr> <tr> -<td><code>?'<i>name</i>'</code></td> +<td><literal>?'<value>name</value>'</literal></td> <td>תחביר תואם פרל 5.10, נתמך החל מ PCRE-7.0</td> </tr> <tr> -<td><code>?P<<i>name</i>></code></td> +<td><literal>?P<<value>name</value>></literal></td> <td>תחביר תואם פייתון, נתמך החל מ PCRE-4.0</td> </tr> @@ -162,7 +162,7 @@ pcre_compile() failed: unrecognized char </programlisting> פירוש הדבר שספריית ה PCRE היא ישנה, ועליכם לנסות את התחביר -<dirname>?P<<i>name</i>></dirname>. +<literal>?P<<value>name</value>></literal>. את הלכידה ניתן לבצע גם בצורה ספרתית: @@ -188,7 +188,7 @@ server { name="שמות כלליים"> <para> -אם אף <dirname>server_name</dirname> לא מוגדר בבלוג שרת, +אם אף <literal>server_name</literal> לא מוגדר בבלוג שרת, אזי nginx משתמש ב <i>hostname</i> בתור שם השרת. </para> @@ -244,12 +244,12 @@ nginx בגירסאות עד 0.6.25 תמך בשם המיוחד “*” אשר יש שפירשו אותו בטעות כשם catch-all. השם הזה מעולם לא תפקד כ catch-all ואף לא כשם wildcard. בפועל, הוא סיפק את הפונקציונליות שהיום מסופקת על ידי -המאפיין <dirname>server_name_in_redirect</dirname>. +המאפיין <literal>server_name_in_redirect</literal>. השם המיוחד “*” הוא כעת לא מומלץ לשימוש, ויש -להשתמש במאפיין <dirname>server_name_in_redirect</dirname> במקומו. +להשתמש במאפיין <literal>server_name_in_redirect</literal> במקומו. שימו לב שאין דרך לציין את שם ה catch-all או את שרת <i>ברירת המחדל</i> -על ידי שימוש במאפיין <dirname>server_name</dirname>. -זוהי תכונה של המאפיין <dirname>listen</dirname> ולא של המאפיין <dirname>server_name</dirname>. +על ידי שימוש במאפיין <literal>server_name</literal>. +זוהי תכונה של המאפיין <literal>listen</literal> ולא של המאפיין <literal>server_name</literal>. ראו גם “<a href="/en/docs/http/request_processing.xml" />”. באפשרותכם להגדיר שרתים המאזינים על פורטים <url>*:80</url> ו <url>*:8080</url>, @@ -294,7 +294,7 @@ server { אם הוא לא נמצא גם שם, מתחיל חיפוש בגיבוב השמות המסתיימים בכוכבית. חיפוש בגיבובי שמות wildcard הוא איטי יותר מחיפוש שם בגיבוב השמות המדוייקים כיוון ששמות עוברים חיפוש על פי חלקי שם המתחם. -שימו לב שצורת ה wildcard המיוחדת <dirname>.nginx.org</dirname> +שימו לב שצורת ה wildcard המיוחדת <literal>.nginx.org</literal> שמורה גם היא בגיבוב שמות ה wildcard ולא בגיבוב השמות המדוייקים. ביטויים רגולריים נבדקים באופן סדרתי, ועל כן הם השיטה האיטית ביותר ואינם סקאלאביליים. @@ -326,9 +326,9 @@ server { <para> אם הגדרתם מספר גדול של שמות שרת, או שהגדרתם שמות שרת ארוכים מהרגיל, -ייתכן ויהיה עליכם לכוונן את המאפיינים <dirname>server_names_hash_max_size</dirname> -ו <dirname>server_names_hash_bucket_size</dirname> ברמת ה <i>http</i>. -ערך ברירת המחדל של <dirname>server_names_hash_bucket_size</dirname> +ייתכן ויהיה עליכם לכוונן את המאפיינים <literal>server_names_hash_max_size</literal> +ו <literal>server_names_hash_bucket_size</literal> ברמת ה <i>http</i>. +ערך ברירת המחדל של <literal>server_names_hash_bucket_size</literal> יכול להיות שווה ל 32, ל 64, או לערך אחר, בהתאם לגודל קו המטמון של המעבד שלכם. אם ברירת המחדל היא 32 ותגדירו “too.long.server.name.nginx.org” בתור שם שרת, @@ -355,17 +355,17 @@ you should increase either server_names_ or server_names_hash_bucket_size: 32 </programlisting> -עליכם לנסות קודם להגדיל את <dirname>server_names_hash_max_size</dirname> +עליכם לנסות קודם להגדיל את <literal>server_names_hash_max_size</literal> למספר קרוב למספר השרתים. רק אם זה לא עזר, או שזמן העלייה של nginx הוא ארוך בצורה מוגזמת, -נסו להגדיל את <dirname>server_names_hash_bucket_size</dirname>. +נסו להגדיל את <literal>server_names_hash_bucket_size</literal>. </para> <para> אם שרת הוא השרת היחיד עבור פורט האזנה, אזי nginx לא יבדוק שמות שרת בכלל (ולא יבנה גיבובים עבור פורט ההאזנה). אך, יש יוצא דופן אחד. -אם <dirname>server_name</dirname> הוא ביטוי רגולרי עם לכידות, +אם <literal>server_name</literal> הוא ביטוי רגולרי עם לכידות, nginx חייב לבצע את הביטוי כדי לקבל את מה שנלכד בהן. </para>
--- a/xml/ja/docs/debugging_log.xml +++ b/xml/ja/docs/debugging_log.xml @@ -13,13 +13,13 @@ ./configure --with-debug ... </programlisting> -次に <dirname>error_log</dirname> の <dirname>debug</dirname> レベルをセットします: +次に <literal>error_log</literal> の <literal>debug</literal> レベルをセットします: <programlisting> error_log /path/to/log debug; </programlisting> -nginx の Windows バイナリバージョンでは常にデバッグログモードがサポートされてビルドされているので、<dirname>debug</dirname> レベルをセットするだけです。 +nginx の Windows バイナリバージョンでは常にデバッグログモードがサポートされてビルドされているので、<literal>debug</literal> レベルをセットするだけです。 </para> <para> @@ -32,7 +32,7 @@ http { error_log /path/to/log; ... </programlisting> -このサーバログをコメントアウトするか <dirname>debug</dirname> フラグを追加してください: +このサーバログをコメントアウトするか <literal>debug</literal> フラグを追加してください: <programlisting> error_log /path/to/log debug;
--- a/xml/ja/docs/http/configuring_https_servers.xml +++ b/xml/ja/docs/http/configuring_https_servers.xml @@ -35,7 +35,7 @@ server { </para> <para> -SSL プロトコルの強力なバージョンと暗号に接続を制限するには、ディレクティブ <dirname>ssl_protocols</dirname> と <dirname>ssl_ciphers</dirname> を使用します。バージョン 0.8.20 以降、nginx は <dirname>ssl_protocols SSLv3 TLSv1</dirname> と <dirname>ssl_ciphers HIGH:!ADH:!MD5</dirname> をデフォルトとして使用しているので、これより古い nginx のバージョンでのみ設定してください。 +SSL プロトコルの強力なバージョンと暗号に接続を制限するには、ディレクティブ <literal>ssl_protocols</literal> と <literal>ssl_ciphers</literal> を使用します。バージョン 0.8.20 以降、nginx は <literal>ssl_protocols SSLv3 TLSv1</literal> と <literal>ssl_ciphers HIGH:!ADH:!MD5</literal> をデフォルトとして使用しているので、これより古い nginx のバージョンでのみ設定してください。 </para> </section> @@ -44,7 +44,7 @@ SSL プロトコルの強力なバージョンと暗号に接続を制限するには、ディレクティブ <dirname>ssl_protocols</dirname> と <dirname>ssl_ciphers</dirname> を使用します。バージョン 0.8.20 以降、nginx は <dirname>ssl_protocols SSLv3 TLSv1</dirname> と <dirname>ssl_ciphers HIGH:!ADH:!MD5</dirname> をデフォルトとして使用しているので、これより古い nginx のバージョンでのみ設定してください。 <section id="optimization" name="HTTPS サーバの最適化"> <para> -SSL の工程は CPU リソースを余計に消費します。マルチプロセッサシステムでは（利用できる CPU コアの数よりも大きい数の）複数のワーカープロセスを走らせるといいでしょう。最も CPU に負荷がかかる工程は SSL ハンドシェイクです。クライアント毎のこの工程数を最小化するには２つの方法があります。最初の方法はキープアライブ接続を有効にして、ひとつの接続経由で複数のリクエストを送るようにする方法です。二つ目の方法は SSL セッションパラメータを再利用して、並行かつ順次接続のための SSL ハンドシェイクを避ける方法です。セッションはワーカー間で共有される SSL セッションキャッシュに保持され、<dirname>ssl_session_cache</dirname> ディレクティブで設定されています。１メガバイトのキャッシュには約４０００のセッションが含まれます。キャッシュのデフォルトタイムアウトは５分です。この値は <dirname>ssl_session_timeout</dirname> ディレクティブを使用して増やすことができます。次の例は１０Mの共有セッションキャッシュをもったクアッドコアシステムに最適化された設定例です: +SSL の工程は CPU リソースを余計に消費します。マルチプロセッサシステムでは（利用できる CPU コアの数よりも大きい数の）複数のワーカープロセスを走らせるといいでしょう。最も CPU に負荷がかかる工程は SSL ハンドシェイクです。クライアント毎のこの工程数を最小化するには２つの方法があります。最初の方法はキープアライブ接続を有効にして、ひとつの接続経由で複数のリクエストを送るようにする方法です。二つ目の方法は SSL セッションパラメータを再利用して、並行かつ順次接続のための SSL ハンドシェイクを避ける方法です。セッションはワーカー間で共有される SSL セッションキャッシュに保持され、<literal>ssl_session_cache</literal> ディレクティブで設定されています。１メガバイトのキャッシュには約４０００のセッションが含まれます。キャッシュのデフォルトタイムアウトは５分です。この値は <literal>ssl_session_timeout</literal> ディレクティブを使用して増やすことができます。次の例は１０Mの共有セッションキャッシュをもったクアッドコアシステムに最適化された設定例です: <programlisting> @@ -80,7 +80,7 @@ http { $ cat www.nginx.com.crt bundle.crt > www.nginx.com.chained.crt </programlisting> -この結合されたファイルを <dirname>ssl_certificate</dirname> ディレクティブで使われるようにします: +この結合されたファイルを <literal>ssl_certificate</literal> ディレクティブで使われるようにします: <programlisting> server { @@ -105,7 +105,7 @@ SSL_CTX_use_PrivateKey_file(" ... /www.n </para> <para> -ブラウザは通常、信頼されている認証局によって署名されている受信した中間証明書を保存します。したがって、よく使われているブラウザは要求された中間証明書をすでに保持しているかもしれませんし、連鎖バンドルなしで送られた証明書にエラーを出すかもしれません。サーバに完全な連鎖証明書を送信させるには <dirname>openssl</dirname> コマンドラインユーティリティを使うといいでしょう。例えば: +ブラウザは通常、信頼されている認証局によって署名されている受信した中間証明書を保存します。したがって、よく使われているブラウザは要求された中間証明書をすでに保持しているかもしれませんし、連鎖バンドルなしで送られた証明書にエラーを出すかもしれません。サーバに完全な連鎖証明書を送信させるには <literal>openssl</literal> コマンドラインユーティリティを使うといいでしょう。例えば: <programlisting> $ openssl s_client -connect www.godaddy.com:443 @@ -146,7 +146,7 @@ Certificate chain <section id="single_http_https_server" name="単一の HTTP/HTTPS サーバ"> <para> -最初の段階から HTTP と HTTPS プロトコル用にサーバを分けて設定するのは優れた実践です。現時点では両者の機能性としては等しいかもしれませんが、将来的に大きな変更があるかもしれず、統合されたサーバの使用が問題になるかもしれません。とはいえ、HTTP と HTTPS のサーバが等しく、将来のことを考えたくないのなら、ディレクティブ <dirname>ssl on</dirname> を削除して *:443 ポートに <dirname>ssl</dirname> パラメータを追加することによって HTTP と HTTPS リクエストの両者を扱う単一のサーバを設定することができます: +最初の段階から HTTP と HTTPS プロトコル用にサーバを分けて設定するのは優れた実践です。現時点では両者の機能性としては等しいかもしれませんが、将来的に大きな変更があるかもしれず、統合されたサーバの使用が問題になるかもしれません。とはいえ、HTTP と HTTPS のサーバが等しく、将来のことを考えたくないのなら、ディレクティブ <literal>ssl on</literal> を削除して *:443 ポートに <literal>ssl</literal> パラメータを追加することによって HTTP と HTTPS リクエストの両者を扱う単一のサーバを設定することができます: <programlisting> server { @@ -160,7 +160,7 @@ server { </programlisting> <note> -0.8.21 以前では、nginx は <dirname>default</dirname> パラメータで待ち受けているソケットに <dirname>ssl</dirname> パラメータをセットすることしかできませんでした: +0.8.21 以前では、nginx は <literal>default</literal> パラメータで待ち受けているソケットに <literal>ssl</literal> パラメータをセットすることしかできませんでした: <programlisting> listen 443 default ssl; </programlisting> @@ -320,7 +320,7 @@ therefore SNI is not available </item> <item> -<dirname>listen</dirname> ディレクティブの <dirname>ssl</dirname> パラメータは 0.7.14 以降からサポートされています。 +<literal>listen</literal> ディレクティブの <literal>ssl</literal> パラメータは 0.7.14 以降からサポートされています。 </item> <item> @@ -352,15 +352,15 @@ SNI は 0.5.32 以降からサポートされています。 <list> <item> -バージョン 0.7.65 と 0.8.20 以降のデフォルトの SSL 暗号は <dirname>HIGH:!ADH:!MD5</dirname> です。 +バージョン 0.7.65 と 0.8.20 以降のデフォルトの SSL 暗号は <literal>HIGH:!ADH:!MD5</literal> です。 </item> <item> -バージョン 0.8.19 のデフォルトの SSL 暗号は <dirname>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM</dirname> です。 +バージョン 0.8.19 のデフォルトの SSL 暗号は <literal>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM</literal> です。 </item> <item> -バージョン 0.7.64 と 0.8.18 以前のデフォルトの SSL 暗号は <dirname>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP</dirname> です。 +バージョン 0.7.64 と 0.8.18 以前のデフォルトの SSL 暗号は <literal>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP</literal> です。 </item> </list>
--- a/xml/ja/docs/http/request_processing.xml +++ b/xml/ja/docs/http/request_processing.xml @@ -33,7 +33,7 @@ server { </para> <para> -この設定では nginx は、（ブラウザからの）HTTP リクエストの “Host” ヘッダだけを考査して、そのリクエストをどのサーバに振り向けるべきかを決定します。もし “Host” ヘッダがどのサーバ名ともマッチしない場合、またはリクエストにこのフィールドがまったく含まれていない場合は、nginxはこのリクエストをデフォルトサーバに振り向けます。上記の設定ではデフォルトサーバは最初のもので、これは nginx の標準的なデフォルトの挙動です。設定内の最初のサーバをデフォルトサーバにしたくない場合は、<dirname>listen</dirname> ディレクティブに <dirname>default_server</dirname> パラメータを使って明示的に設定することができます: +この設定では nginx は、（ブラウザからの）HTTP リクエストの “Host” ヘッダだけを考査して、そのリクエストをどのサーバに振り向けるべきかを決定します。もし “Host” ヘッダがどのサーバ名ともマッチしない場合、またはリクエストにこのフィールドがまったく含まれていない場合は、nginxはこのリクエストをデフォルトサーバに振り向けます。上記の設定ではデフォルトサーバは最初のもので、これは nginx の標準的なデフォルトの挙動です。設定内の最初のサーバをデフォルトサーバにしたくない場合は、<literal>listen</literal> ディレクティブに <literal>default_server</literal> パラメータを使って明示的に設定することができます: <programlisting> server { @@ -44,10 +44,10 @@ server { </programlisting> <note> -この <dirname>default_server</dirname> パラメータはバージョン 0.8.21 以上で利用できます。それ以前のバージョンでは代わりに <dirname>default</dirname> パラメータを使用してください。 +この <literal>default_server</literal> パラメータはバージョン 0.8.21 以上で利用できます。それ以前のバージョンでは代わりに <literal>default</literal> パラメータを使用してください。 </note> -このデフォルトサーバは <dirname>listen</dirname> ディレクティブのプロパティで、<dirname>server_name</dirname> ディレクティブのプロパティではないことに注意してください。詳細は後述します。 +このデフォルトサーバは <literal>listen</literal> ディレクティブのプロパティで、<literal>server_name</literal> ディレクティブのプロパティではないことに注意してください。詳細は後述します。 </para> </section> @@ -99,13 +99,13 @@ server { } </programlisting> -この設定では、nginx はまず最初に <dirname>server</dirname> ブロックの <dirname>listen</dirname> ディレクティブに対してリクエストの IP アドレスとポートを考査します。次に、その IP アドレスとポートにマッチする <dirname>server</dirname> ブロックの <dirname>server_name</dirname> ディレクティブに対して、その HTTP リクエストの “Host” ヘッダを考査します。 +この設定では、nginx はまず最初に <literal>server</literal> ブロックの <literal>listen</literal> ディレクティブに対してリクエストの IP アドレスとポートを考査します。次に、その IP アドレスとポートにマッチする <literal>server</literal> ブロックの <literal>server_name</literal> ディレクティブに対して、その HTTP リクエストの “Host” ヘッダを考査します。 もしサーバ名が見つからなければ、そのリクエストはデフォルトサーバによって処理されます。例えば、192.168.1.1:80 ポートで受信された <url>www.nginx.com</url> へのリクエストは 192.168.1.1:80 ポートのデフォルトサーバ、つまり最初のサーバで処理されます。これはこのポートでは <url>www.nginx.com</url> は定義されていないからです。 </para> <para> -すでに述べたように、デフォルトサーバは <dirname>listen</dirname> ディレクティブのプロパティで、別の <dirname>listen</dirname> ディレクティブには別のデフォルトサーバが定義されています: +すでに述べたように、デフォルトサーバは <literal>listen</literal> ディレクティブのプロパティで、別の <literal>listen</literal> ディレクティブには別のデフォルトサーバが定義されています: <programlisting> server { @@ -187,25 +187,25 @@ nginx はまず最初に、リストの順序には関係なくリテラルな文字列によって指定されているもっとも限定されたロケーションを検索します。上記の設定では唯一のリテラルなロケーションは <path>/</path> であり、したがってどのリクエストでもマッチして最終的にこのロケーションが使われます。次に nginx は、設定ファイルにリストされている順番で正規表現によって指定されているロケーションをチェックします。最初にマッチした正規表現で検索はストップし、 nginx そのロケーションを使用します。もしどの正規表現もリクエストにマッチしない場合は、nginx はその前に見つかったもっとも限定されたリテラルなロケーションを使用します。 <item> <para> -リクエスト <path>/logo.gif</path> はリテラルなロケーション <dirname>/</dirname> に最初にマッチし、次に正規表現 <dirname>\.(gif|jpg|png)$</dirname> にマッチするので、後者のロケーションによって処理されます。 このリクエストは <dirname>root /data/www</dirname> ディレクティブを使用してファイル <path>/data/www/logo.gif</path> にマップされ、このファイルがクライアントに送られます。 +リクエスト <path>/logo.gif</path> はリテラルなロケーション <literal>/</literal> に最初にマッチし、次に正規表現 <literal>\.(gif|jpg|png)$</literal> にマッチするので、後者のロケーションによって処理されます。 このリクエストは <literal>root /data/www</literal> ディレクティブを使用してファイル <path>/data/www/logo.gif</path> にマップされ、このファイルがクライアントに送られます。 </para> </item> <item> <para> -リクエスト <path>/index.php</path> もまたリテラルなロケーション <dirname>/</dirname> に最初にマッチし、次に正規表現 <dirname>\.(php)$</dirname> にマッチします。したがって、このリクエストは後者のロケーションによって処理され、localhost:9000 で待ち受けている FastCGI サーバに渡されます。<dirname>fastcgi_param</dirname> ディレクティブは FastCGI のパラメータ SCRIPT_FILENAME を <path>/data/www/index.php</path> にセットし、この FastCGI サーバがこのファイルを実行します。変数 $document_root は <dirname>root</dirname> ディレクティブの値と同等で、変数 $fastcgi_script_name はリクエスト URI、例えば <path>/index.php</path> と同等です。 +リクエスト <path>/index.php</path> もまたリテラルなロケーション <literal>/</literal> に最初にマッチし、次に正規表現 <literal>\.(php)$</literal> にマッチします。したがって、このリクエストは後者のロケーションによって処理され、localhost:9000 で待ち受けている FastCGI サーバに渡されます。<literal>fastcgi_param</literal> ディレクティブは FastCGI のパラメータ SCRIPT_FILENAME を <path>/data/www/index.php</path> にセットし、この FastCGI サーバがこのファイルを実行します。変数 $document_root は <literal>root</literal> ディレクティブの値と同等で、変数 $fastcgi_script_name はリクエスト URI、例えば <path>/index.php</path> と同等です。 </para> </item> <item> <para> -リクエスト <path>/about.html</path> はリテラルなロケーション <dirname>/</dirname> のみにマッチします。したがってこのロケーションで処理されます。このリクエストは <dirname>root</dirname> ディレクティブのパラメータ <dirname>/data/www</dirname> を使い、ファイル <path>/data/www/about.html</path> にマップされ、クライアントに送られます。 +リクエスト <path>/about.html</path> はリテラルなロケーション <literal>/</literal> のみにマッチします。したがってこのロケーションで処理されます。このリクエストは <literal>root</literal> ディレクティブのパラメータ <literal>/data/www</literal> を使い、ファイル <path>/data/www/about.html</path> にマップされ、クライアントに送られます。 </para> </item> <item> <para> -リクエスト <path>/</path> の処理はより複雑です。これはリテラルなロケーション <dirname>/</dirname> のみにマッチし、このロケーションで処理されます。ついで <dirname>index</dirname> ディレクティブがパラメータと <dirname>root</dirname> ディレクティブのパラメータ <dirname>/data/www</dirname> にしたがって index ファイルが存在するかどうかを考査します。もし <path>/data/www/index.php</path> ファイル存在すればこのディレクティブは <path>/index.php</path> への内部リダイレクトを実行し、nginx はまるでこのリクエストがクライアントに送られたかのようにこのロケーションを再び検索します。先に見たように、リダイレクトされたリクエストは最終的に FastCGI サーバで処理されます。 +リクエスト <path>/</path> の処理はより複雑です。これはリテラルなロケーション <literal>/</literal> のみにマッチし、このロケーションで処理されます。ついで <literal>index</literal> ディレクティブがパラメータと <literal>root</literal> ディレクティブのパラメータ <literal>/data/www</literal> にしたがって index ファイルが存在するかどうかを考査します。もし <path>/data/www/index.php</path> ファイル存在すればこのディレクティブは <path>/index.php</path> への内部リダイレクトを実行し、nginx はまるでこのリクエストがクライアントに送られたかのようにこのロケーションを再び検索します。先に見たように、リダイレクトされたリクエストは最終的に FastCGI サーバで処理されます。 </para> </item>
--- a/xml/ja/docs/http/server_names.xml +++ b/xml/ja/docs/http/server_names.xml @@ -9,7 +9,7 @@ <section> <para> -サーバ名は <dirname>server_name</dirname> ディレクティブを使用して定義され、リクエストに対してどのサーバブロックが使われるかを決定します。「<a href="/ja/docs/http/request_processing.xml" />」もお読みください。これらは完全一致名、ワイルドカード名、正規表現で定義されます: +サーバ名は <literal>server_name</literal> ディレクティブを使用して定義され、リクエストに対してどのサーバブロックが使われるかを決定します。「<a href="/ja/docs/http/request_processing.xml" />」もお読みください。これらは完全一致名、ワイルドカード名、正規表現で定義されます: <programlisting> server { @@ -68,11 +68,11 @@ server { name="ワイルドカード名"> <para> -ワイルドカード名にはそのサーバ名の最初か最後のみ、そしてドットに隣接したところのみにアスタリスクが含まれます。サーバ名 <dirname>www.*.nginx.org</dirname> や <dirname>w*.nginx.org</dirname> は無効です。しかし、これらのサーバ名は正規表現を使用して、例えば <dirname>~^www\..+\.nginx\.org$</dirname> や <dirname>~^w.*\.nginx\.org$</dirname> として指定することができます。アスタリスクは複数部分にマッチさせることができます。<dirname>*.nginx.org</dirname> は <url>www.nginx.org</url> だけでなく <url>www.sub.nginx.org</url> にもマッチします。 +ワイルドカード名にはそのサーバ名の最初か最後のみ、そしてドットに隣接したところのみにアスタリスクが含まれます。サーバ名 <literal>www.*.nginx.org</literal> や <literal>w*.nginx.org</literal> は無効です。しかし、これらのサーバ名は正規表現を使用して、例えば <literal>~^www\..+\.nginx\.org$</literal> や <literal>~^w.*\.nginx\.org$</literal> として指定することができます。アスタリスクは複数部分にマッチさせることができます。<literal>*.nginx.org</literal> は <url>www.nginx.org</url> だけでなく <url>www.sub.nginx.org</url> にもマッチします。 </para> <para> -特別なワイルドカードの形式 <dirname>.nginx.org</dirname> は、完全一致名 <dirname>nginx.org</dirname> とワイルドカード名 <dirname>*.nginx.org</dirname> の両方にマッチさせるように利用できます。 +特別なワイルドカードの形式 <literal>.nginx.org</literal> は、完全一致名 <literal>nginx.org</literal> とワイルドカード名 <literal>*.nginx.org</literal> の両方にマッチさせるように利用できます。 </para> </section> @@ -139,7 +139,7 @@ nginx が起動に失敗すると次のエラーメッセージを表示します: pcre_compile() failed: unrecognized character after (?< in ... </programlisting> -これは PCRE ライブラリが古いので <dirname>?P<<i>name</i>></dirname> 構文を試すように、という意味です。このキャプチャは数字形式でも使用できます: +これは PCRE ライブラリが古いので <literal>?P<<value>name</value>></literal> 構文を試すように、という意味です。このキャプチャは数字形式でも使用できます: <programlisting> server { @@ -174,7 +174,7 @@ server { </para> <para> -<dirname>server_name</dirname> がサーバブロックで定義されていない場合は、nginx は<i>サーバ名</i>として空の名前を使用します。 +<literal>server_name</literal> がサーバブロックで定義されていない場合は、nginx は<i>サーバ名</i>として空の名前を使用します。 </para> @@ -213,7 +213,7 @@ server { </para> <para> -nginx バージョン 0.6.25 までは特別なサーバ名 “*” をサポートしていて、これは誤ってすべてのサーバ名と一致するもの（キャッチオール名）として解釈されていました。この特別なサーバ名 “*”はキャッチオールまたはワイルドカードとして機能したことはありませんでした。代わりに、今は <dirname>server_name_in_redirect</dirname> ディレクティブによって提供されている機能の役を果たしていました。特別なサーバ名 “*” は今後廃止予定ですので、<dirname>server_name_in_redirect</dirname> ディレクティブを使うようにしてください。キャッチオール名を指定したり <dirname>server_name</dirname> ディレクティブを使用した<i>デフォルト</i>サーバを指定したりする方法はないことに注意してください。これは <dirname>listen</dirname> ディレクティブのプロパティであり、<dirname>server_name</dirname> ディレクティブのプロパティではありません。“<a href="/ja/docs/http/request_processing.xml" />” も参照してください。 +nginx バージョン 0.6.25 までは特別なサーバ名 “*” をサポートしていて、これは誤ってすべてのサーバ名と一致するもの（キャッチオール名）として解釈されていました。この特別なサーバ名 “*”はキャッチオールまたはワイルドカードとして機能したことはありませんでした。代わりに、今は <literal>server_name_in_redirect</literal> ディレクティブによって提供されている機能の役を果たしていました。特別なサーバ名 “*” は今後廃止予定ですので、<literal>server_name_in_redirect</literal> ディレクティブを使うようにしてください。キャッチオール名を指定したり <literal>server_name</literal> ディレクティブを使用した<i>デフォルト</i>サーバを指定したりする方法はないことに注意してください。これは <literal>listen</literal> ディレクティブのプロパティであり、<literal>server_name</literal> ディレクティブのプロパティではありません。“<a href="/ja/docs/http/request_processing.xml" />” も参照してください。 ポート *:80 と *:8080 で待ち受けているサーバを定義し、ひとつをポート *:8080 のデフォルトサーバへ、もうひとつをポート *:80 のデフォルトサーバへ振り向けることができます。 <programlisting> @@ -241,7 +241,7 @@ server { name="最適化"> <para> -完全一致名とワイルドカード名はハッシュで保存されます。このハッシュは待ち受けポートに結び付けられ、各待ち受けポートは、完全一致名のハッシュ、アスタリスクで始まるワイルドカード名のハッシュ、アスタリスクで終わるワイルドカード名のハッシュの３つまでのハッシュを持つことができます。ハッシュのサイズは構成フェーズで最適化されるので、CPU キャッシュのミスは最低でもサーバ名を見つけることができます。最初に完全一致名のハッシュが検索されます。完全一致名のハッシュを使って見つからなければ、次にアスタリスクで始まるワイルドカード名のハッシュが検索されます。さらにまだ見つからなければ、アスタリスクで終わるワイルドカード名のハッシュが検索されます。ワイルドカード名のハッシュの検索は完全一致名のハッシュの検索よりも遅くなります。これはサーバ名の検索がドメイン部分によって検索されるからです。特別なワイルドカード形式の <dirname>.nginx.org</dirname> は完全一致名のハッシュではなくワイルドカード名のハッシュで保存されます。正規表現は順番に考査されるので、これがもっとも遅い方式ですし、非スケーラブルでもあります。 +完全一致名とワイルドカード名はハッシュで保存されます。このハッシュは待ち受けポートに結び付けられ、各待ち受けポートは、完全一致名のハッシュ、アスタリスクで始まるワイルドカード名のハッシュ、アスタリスクで終わるワイルドカード名のハッシュの３つまでのハッシュを持つことができます。ハッシュのサイズは構成フェーズで最適化されるので、CPU キャッシュのミスは最低でもサーバ名を見つけることができます。最初に完全一致名のハッシュが検索されます。完全一致名のハッシュを使って見つからなければ、次にアスタリスクで始まるワイルドカード名のハッシュが検索されます。さらにまだ見つからなければ、アスタリスクで終わるワイルドカード名のハッシュが検索されます。ワイルドカード名のハッシュの検索は完全一致名のハッシュの検索よりも遅くなります。これはサーバ名の検索がドメイン部分によって検索されるからです。特別なワイルドカード形式の <literal>.nginx.org</literal> は完全一致名のハッシュではなくワイルドカード名のハッシュで保存されます。正規表現は順番に考査されるので、これがもっとも遅い方式ですし、非スケーラブルでもあります。 </para> <para> @@ -267,7 +267,7 @@ server { </para> <para> -たくさんの数のサーバ名を定義したり非常に長いサーバ名を定義したりする場合は、http レベルの <dirname>server_names_hash_max_size</dirname> と <dirname>server_names_hash_bucket_size</dirname> ディレクティブを調整する必要があるかもしれません。<dirname>server_names_hash_bucket_size</dirname> のデフォルト値は 32、もしくは 64、あるいはお使いの CPU キャッシュラインのサイズによってはその他の値になっているかもしれません。もしデフォルト値が 32 でサーバ名として “too.long.server.name.nginx.org” のような非常に長いサーバ名を定義している場合、nginx は起動に失敗し、次のエラーメッセージを表示させます: +たくさんの数のサーバ名を定義したり非常に長いサーバ名を定義したりする場合は、http レベルの <literal>server_names_hash_max_size</literal> と <literal>server_names_hash_bucket_size</literal> ディレクティブを調整する必要があるかもしれません。<literal>server_names_hash_bucket_size</literal> のデフォルト値は 32、もしくは 64、あるいはお使いの CPU キャッシュラインのサイズによってはその他の値になっているかもしれません。もしデフォルト値が 32 でサーバ名として “too.long.server.name.nginx.org” のような非常に長いサーバ名を定義している場合、nginx は起動に失敗し、次のエラーメッセージを表示させます: <programlisting> could not build the server_names_hash, @@ -290,11 +290,11 @@ you should increase either server_names_ or server_names_hash_bucket_size: 32 </programlisting> -まず最初に <dirname>server_names_hash_max_size</dirname> の値を、定義するサーバ名の数に近い数に設定して試します。この設定がうまくいかない時だけ、もしくは nginx の起動時間が許容できないほど長い場合だけ <dirname>server_names_hash_bucket_size</dirname> の値を増やしてみます。 +まず最初に <literal>server_names_hash_max_size</literal> の値を、定義するサーバ名の数に近い数に設定して試します。この設定がうまくいかない時だけ、もしくは nginx の起動時間が許容できないほど長い場合だけ <literal>server_names_hash_bucket_size</literal> の値を増やしてみます。 </para> <para> -待ち受けているポートがひとつだけでサーバもひとつだけの場合、nginx はサーバ名を考査しません（また、待ち受けポート用のハッシュも生成しません）。しかし一つ例外があります。<dirname>server_name</dirname> がキャプチャを伴った正規表現の場合、nginx はキャプチャを取得するためにこの正規表現を実行します。 +待ち受けているポートがひとつだけでサーバもひとつだけの場合、nginx はサーバ名を考査しません（また、待ち受けポート用のハッシュも生成しません）。しかし一つ例外があります。<literal>server_name</literal> がキャプチャを伴った正規表現の場合、nginx はキャプチャを取得するためにこの正規表現を実行します。 </para> </section>
--- a/xml/ru/docs/control.xml +++ b/xml/ru/docs/control.xml @@ -8,9 +8,9 @@ <para> Управлять nginx можно с помощью сигналов. Номер главного процесса по умолчанию -записывается в файл <command>/usr/local/nginx/logs/nginx.pid</command>. +записывается в файл <path>/usr/local/nginx/logs/nginx.pid</path>. Изменить имя этого файла можно при конфигурации сборки или же в -<command>nginx.conf</command> директивой +<path>nginx.conf</path> директивой <link doc="ngx_core_module.xml" id="pid"/>. Главный процесс поддерживает следующие сигналы: <note> @@ -127,8 +127,8 @@ 33136 33126 nobody 0.0 1368 kqread ng Для обновления сервера нужно записать на место старого исполняемого файла новый. Затем нужно послать сигнал USR2 главному процессу—он переименует свой файл с номером процесса в файл -с суффиксом <command>.oldbin</command>, например, -<command>/usr/local/nginx/logs/nginx.pid.oldbin</command>, +с суффиксом <path>.oldbin</path>, например, +<path>/usr/local/nginx/logs/nginx.pid.oldbin</path>, после чего запустит новый исполняемый файл, а тот в свою очередь—свои рабочие процессы: <programlisting> @@ -148,8 +148,8 @@ 36267 36264 nobody 0.0 1364 kqread ng <para> Процесс с новым исполняемым файлом 36264 создаёт свой файл с номером процесса -с суффиксом <command>.newbin</command>, например, -<command>/usr/local/nginx/logs/nginx.pid.newbin</command>. +с суффиксом <path>.newbin</path>, например, +<path>/usr/local/nginx/logs/nginx.pid.newbin</path>. </para> --> @@ -226,7 +226,7 @@ 36267 36264 nobody 0.0 1364 kqread ng <para> Если новый главный процесс выходит, то старый процесс убирает -суффикс <command>.oldbin</command> из имени файла с номером процесса. +суффикс <path>.oldbin</path> из имени файла с номером процесса. </para> <para> @@ -245,8 +245,8 @@ 36267 36264 nobody 0.0 1364 kqread ng <para> После этого остаётся только переименовать -<command>/usr/local/nginx/logs/nginx.pid.newbin</command> в -<command>/usr/local/nginx/logs/nginx.pid</command> и обновление можно считать +<path>/usr/local/nginx/logs/nginx.pid.newbin</path> в +<path>/usr/local/nginx/logs/nginx.pid</path> и обновление можно считать завершённым. </para>
--- a/xml/ru/docs/debugging_log.xml +++ b/xml/ru/docs/debugging_log.xml @@ -15,7 +15,7 @@ ./configure --with-debug ... </programlisting> -Затем нужно задать уровень <value>debug</value> с помощью +Затем нужно задать уровень <literal>debug</literal> с помощью директивы <link doc="ngx_core_module.xml" id="error_log"/>: <programlisting> @@ -23,12 +23,12 @@ error_log /path/to/log debug; </programlisting> Бинарная версия nginx для Windows всегда собирается с поддержкой отладочного -лога, поэтому понадобится лишь задать уровень <value>debug</value>. +лога, поэтому понадобится лишь задать уровень <literal>debug</literal>. </para> <para> Обратите внимание, что переопределение лога без одновременного указания -уровня <value>debug</value> отключит отладочный лог. +уровня <literal>debug</literal> отключит отладочный лог. В примере ниже, переопределение лога на уровне <link doc="http/ngx_http_core_module.xml" id="server"/> отключает отладочный лог для этого сервера: @@ -41,7 +41,7 @@ http { ... </programlisting> Чтобы избежать этого, следует либо закомментировать строку, переопределяющую -лог, либо добавить определение уровня <value>debug</value>: +лог, либо добавить определение уровня <literal>debug</literal>: <programlisting> error_log /path/to/log debug;
--- a/xml/ru/docs/events.xml +++ b/xml/ru/docs/events.xml @@ -8,34 +8,34 @@ <para> nginx поддерживает следующие методы обработки соединений, которые -можно задать директивой <dirname>use</dirname>: +можно задать директивой <link doc="ngx_core_module.xml" id="use"/>: <list> <listitem> <para> -<command>select</command>—стандартный метод. +<literal>select</literal>—стандартный метод. Модуль для поддержки этого метода собирается автоматически, если на платформе не обнаружено более эффективного метода. Можно принудительно разрешить или запретить сборку этого модуля -с помощью параметров <command>--with-select_module</command> или -<command>--without-select_module</command>. +с помощью параметров <literal>--with-select_module</literal> или +<literal>--without-select_module</literal>. </para> </listitem> <listitem> <para> -<command>poll</command>—стандартный метод. +<literal>poll</literal>—стандартный метод. Модуль для поддержки этого метода собирается автоматически, если на платформе не обнаружено более эффективного метода. Можно принудительно разрешить или запретить сборку этого модуля -с помощью параметров <command>--with-poll_module</command> или -<command>--without-poll_module</command>. +с помощью параметров <literal>--with-poll_module</literal> или +<literal>--without-poll_module</literal>. </para> </listitem> <listitem> <para> -<command>kqueue</command>—эффективный метод, используемый +<literal>kqueue</literal>—эффективный метод, используемый во FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 и MacOS X. На двух-процессорных машинах под управлением MacOS X использование kqueue может привести к kernel panic. @@ -44,7 +44,7 @@ kqueue может привести к kernel panic. <listitem> <para> -<command>epoll</command>—эффективный метод, используемый +<literal>epoll</literal>—эффективный метод, используемый в Linux 2.6+. В некоторых дистрибутивах, например <nobr>SuSE 8.2,</nobr> есть патчи для поддержки epoll ядром 2.4. </para> @@ -52,12 +52,12 @@ kqueue может привести к kernel panic. <listitem> <para> -<command>rtsig</command>—real time signals, эффективный метод, +<literal>rtsig</literal>—real time signals, эффективный метод, используемый в Linux 2.2.19+. По умолчанию в очереди может находиться не более 1024 сигналов для всей системы. Этого недостаточно для нагруженных серверов, поэтому нужно увеличить размер очереди с помощью параметра ядра -<command>/proc/sys/kernel/rtsig-max</command>. +<path>/proc/sys/kernel/rtsig-max</path>. Однако, начиная с Linux 2.6.6-mm2, этого параметра уже нет и для каждого процесса существует отдельная очередь сигналов, размер которой задаётся с помощью RLIMIT_SIGPENDING. @@ -71,7 +71,7 @@ kqueue может привести к kernel panic. <listitem> <para> -<command>/dev/poll</command>—эффективный метод, используемый +<literal>/dev/poll</literal>—эффективный метод, используемый в Solaris 7 11/99+, HP/UX 11.22+ (eventport), IRIX 6.5.15+ и Tru64 UNIX 5.1A+. </para> @@ -79,7 +79,7 @@ kqueue может привести к kernel panic. <listitem> <para> -<command>eventport</command>—event ports, эффективный метод, +<literal>eventport</literal>—event ports, эффективный метод, используемый в Solaris 10. Во избежания kernel panic, нужно установить <link url="http://sunsolve.sun.com/search/document.do?assetkey=1-26-102485-1">патч</link>. </para>
--- a/xml/ru/docs/http/ngx_http_access_module.xml +++ b/xml/ru/docs/http/ngx_http_access_module.xml @@ -44,7 +44,7 @@ IP-адресов клиентов. <section name="Директивы" id="directives"> <directive name="allow"> -<syntax><value>[адрес|CIDR|all]</value></syntax> +<syntax><value>адрес</value> | <value>CIDR</value> | <literal>all</literal></syntax> <default/> <context>http, server, location, limit_except</context> @@ -56,7 +56,7 @@ IP-адресов клиентов. <directive name="deny"> -<syntax><value>[адрес|CIDR|all]</value></syntax> +<syntax><value>адрес</value> | <value>CIDR</value> | <literal>all</literal></syntax> <default/> <context>http, server, location, limit_except</context>
--- a/xml/ru/docs/http/ngx_http_addition_module.xml +++ b/xml/ru/docs/http/ngx_http_addition_module.xml @@ -12,7 +12,7 @@ Модуль ngx_http_addition_module — это фильтр, добавляющий текст до и после ответа. По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_addition_module</command>. +при конфигурировании параметром <literal>--with-http_addition_module</literal>. </para> </section> @@ -61,7 +61,7 @@ <directive name="addition_types"> -<syntax><value>mime-тип [mime-тип ...]</value></syntax> +<syntax><value>mime-тип</value> ...</syntax> <default>text/html</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_auth_basic_module.xml +++ b/xml/ru/docs/http/ngx_http_auth_basic_module.xml @@ -33,7 +33,7 @@ <section name="Директивы" id="directives"> <directive name="auth_basic"> -<syntax><value>[строка|off]</value></syntax> +<syntax><value>строка</value> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location, limit_except</context>
--- a/xml/ru/docs/http/ngx_http_autoindex_module.xml +++ b/xml/ru/docs/http/ngx_http_autoindex_module.xml @@ -33,7 +33,7 @@ <section name="Директивы" id="directives"> <directive name="autoindex"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -45,7 +45,7 @@ <directive name="autoindex_exact_size"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location</context> @@ -60,7 +60,7 @@ <directive name="autoindex_localtime"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_browser_module.xml +++ b/xml/ru/docs/http/ngx_http_browser_module.xml @@ -75,7 +75,7 @@ <section name="Директивы" id="directives"> <directive name="ancient_browser"> -<syntax><value>строка [строка ...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -102,7 +102,8 @@ <directive name="modern_browser"> -<syntax><value>браузер версия|unlisted</value></syntax> +<syntax><value>браузер</value> <value>версия</value></syntax> +<syntax><literal>unlisted</literal></syntax> <default/> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_charset_module.xml +++ b/xml/ru/docs/http/ngx_http_charset_module.xml @@ -50,7 +50,7 @@ <section name="Директивы" id="directives"> <directive name="charset"> -<syntax><value>кодировка|off</value></syntax> +<syntax><value>кодировка</value> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location, if в location</context> @@ -90,7 +90,7 @@ charset_map iso-8859-5 _ { } <directive name="charset_map"> -<syntax block="yes"><value>кодировка1 кодировка2</value></syntax> +<syntax block="yes"><value>кодировка1</value> <value>кодировка2</value></syntax> <default/> <context>http</context> @@ -142,10 +142,9 @@ charset_map koi8-r utf-8 { <directive name="charset_types"> -<syntax><value>mime-тип [mime-тип ...]</value></syntax> +<syntax><value>mime-тип</value> ...</syntax> <default>text/html text/xml text/plain text/vnd.wap.wml -application/x-javascript application/rss+xml -</default> +application/x-javascript application/rss+xml</default> <context>http, server, location</context> <para> @@ -165,7 +164,7 @@ application/x-javascript application/rss <directive name="override_charset"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location, if в location</context>
--- a/xml/ru/docs/http/ngx_http_core_module.xml +++ b/xml/ru/docs/http/ngx_http_core_module.xml @@ -10,9 +10,9 @@ <directive name="aio"> <syntax> - <value>on</value> | - <value>off</value> | - <value>sendfile</value></syntax> + <literal>on</literal> | + <literal>off</literal> | + <literal>sendfile</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -130,7 +130,7 @@ location /video/ { <directive name="alias"> -<syntax><argument>путь</argument></syntax> +<syntax><value>путь</value></syntax> <default/> <context>location</context> @@ -143,19 +143,19 @@ location /i/ { } </example> на запрос -“<code>/i/top.gif</code>” будет отдан файл +“<literal>/i/top.gif</literal>” будет отдан файл <path>/data/w3/images/top.gif</path>. </para> <para> -В значении аргумента <argument>путь</argument> можно использовать переменные, +В значении параметра <value>путь</value> можно использовать переменные, кроме <var>$document_root</var> и <var>$realpath_root</var>. </para> <para> -Если <code>alias</code> используется внутри location'а, заданного +Если <literal>alias</literal> используется внутри location'а, заданного регулярным выражением, то регулярное выражение должно содержать -выделения, а сам <code>alias</code> — ссылки на эти выделения +выделения, а сам <literal>alias</literal> — ссылки на эти выделения (0.7.40), например: <example> location ~ ^/users/(.+\.(?:gif|jpe?g|png))$ { @@ -184,7 +184,7 @@ location /images/ { <directive name="chunked_transfer_encoding"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -202,7 +202,7 @@ chunked encoding, несмотря на требования стандарта. <directive name="client_body_buffer_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>8k|16k</default> <context>http</context> <context>server</context> @@ -223,9 +223,9 @@ chunked encoding, несмотря на требования стандарта. <directive name="client_body_in_file_only"> <syntax> - <value>on</value> | - <value>clean</value> | - <value>off</value></syntax> + <literal>on</literal> | + <literal>clean</literal> | + <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -242,12 +242,12 @@ chunked encoding, несмотря на требования стандарта. </para> <para> -При установке значения <value>on</value> временные файлы +При установке значения <literal>on</literal> временные файлы по окончании обработки запроса не удаляются. </para> <para> -Значение <value>clean</value> разрешает удалять временные файлы, +Значение <literal>clean</literal> разрешает удалять временные файлы, оставшиеся по окончании обработки запроса. </para> @@ -255,7 +255,7 @@ chunked encoding, несмотря на требования стандарта. <directive name="client_body_in_single_buffer"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -273,10 +273,10 @@ chunked encoding, несмотря на требования стандарта. <directive name="client_body_temp_path"> <syntax> - <argument>путь</argument> - [<argument>уровень1</argument> - [<argument>уровень2</argument> - [<argument>уровень3</argument>]]]</syntax> + <value>путь</value> + [<value>уровень1</value> + [<value>уровень2</value> + [<value>уровень3</value>]]]</syntax> <default>client_body_temp</default> <context>http</context> <context>server</context> @@ -299,7 +299,7 @@ client_body_temp_path /spool/nginx/clien <directive name="client_body_timeout"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -318,7 +318,7 @@ client_body_temp_path /spool/nginx/clien <directive name="client_header_buffer_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>1k</default> <context>http</context> <context>server</context> @@ -338,7 +338,7 @@ client_body_temp_path /spool/nginx/clien <directive name="client_header_timeout"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -354,7 +354,7 @@ client_body_temp_path /spool/nginx/clien <directive name="client_max_body_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>1m</default> <context>http</context> <context>server</context> @@ -370,7 +370,7 @@ client_body_temp_path /spool/nginx/clien Следует иметь в виду, что <!--link doc="/web/upload.xml"-->браузеры не умеют корректно показывать эту ошибку<!--/link-->. -Установка аргумента <argument>размер</argument> в 0 отключает +Установка параметра <value>размер</value> в 0 отключает проверку размера тела запроса клиента. </para> @@ -378,7 +378,7 @@ client_body_temp_path /spool/nginx/clien <directive name="connection_pool_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>256</default> <context>http</context> <context>server</context> @@ -394,7 +394,7 @@ client_body_temp_path /spool/nginx/clien <directive name="default_type"> -<syntax><argument>mime-тип</argument></syntax> +<syntax><value>mime-тип</value></syntax> <default>text/plain</default> <context>http</context> <context>server</context> @@ -409,7 +409,7 @@ client_body_temp_path /spool/nginx/clien <directive name="directio"> -<syntax><argument>размер</argument> | <value>off</value></syntax> +<syntax><value>размер</value> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -436,7 +436,7 @@ directio 4m; <directive name="directio_alignment"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>512</default> <context>http</context> <context>server</context> @@ -455,9 +455,9 @@ directio 4m; <directive name="error_page"> <syntax> - <argument>код</argument> ... - [<value>=</value>[<argument>ответ</argument>]] - <argument>uri</argument></syntax> + <value>код</value> ... + [<literal>=</literal>[<value>ответ</value>]] + <value>uri</value></syntax> <default/> <context>http</context> <context>server</context> @@ -466,9 +466,9 @@ directio 4m; <para> Задаёт URI, который будет показываться для указанных ошибок. -Директивы <code>error_page</code> наследуются с предыдущего уровня при условии, -что на данном уровне не описаны свои директивы -<code>error_page</code>. +Директивы <literal>error_page</literal> наследуются с предыдущего уровня +при условии, что на данном уровне не описаны свои директивы +<literal>error_page</literal>. В значении URI можно использовать переменные. </para> @@ -516,9 +516,9 @@ location @fallback { <directive name="if_modified_since"> <syntax> - <value>off</value> | - <value>exact</value> | - <value>before</value></syntax> + <literal>off</literal> | + <literal>exact</literal> | + <literal>before</literal></syntax> <default>exact</default> <context>http</context> <context>server</context> @@ -533,18 +533,18 @@ location @fallback { <list type="tag"> -<tag-name><value>off</value></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> не проверять поле <header>If-Modified-Since</header> заголовка запроса (0.7.34); </tag-desc> -<tag-name><value>exact</value></tag-name> +<tag-name><literal>exact</literal></tag-name> <tag-desc> точное совпадение; </tag-desc> -<tag-name><value>before</value></tag-name> +<tag-name><literal>before</literal></tag-name> <tag-desc> время модификации ответа меньше или равно времени, заданному в поле <header>If-Modified-Since</header> заголовка запроса. @@ -557,7 +557,7 @@ location @fallback { <directive name="ignore_invalid_headers"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -591,7 +591,7 @@ location @fallback { <listitem> подзапросы, формируемые командой -<command>include virtual</command> +“<command>include virtual</command>” модуля <link doc="ngx_http_ssi_module.xml">ngx_http_ssi_module</link>; ngx_http_ssi_module; @@ -620,7 +620,7 @@ location /404.html { <directive name="keepalive_disable"> -<syntax><value>none</value> | <argument>браузер</argument> ...</syntax> +<syntax><literal>none</literal> | <value>браузер</value> ...</syntax> <default>msie6 safari</default> <context>http</context> <context>server</context> @@ -628,13 +628,13 @@ location /404.html { <para> Запрещает keep-alive соединения с некорректно ведущими себя браузерами. -Аргументы <argument>браузер</argument> указывают, на какие браузеры это +Параметры <value>браузер</value> указывают, на какие браузеры это распространяется. -Значение <value>msie6</value> запрещает keep-alive соединения +Значение <literal>msie6</literal> запрещает keep-alive соединения со старыми версиями MSIE после получения запроса POST. -Значение <value>safari</value> запрещает keep-alive соединения +Значение <literal>safari</literal> запрещает keep-alive соединения с браузерами Safari. -Значение <value>none</value> разрешает keep-alive соединения +Значение <literal>none</literal> разрешает keep-alive соединения со всеми браузерами. </para> @@ -642,7 +642,7 @@ location /404.html { <directive name="keepalive_requests"> -<syntax><argument>число</argument></syntax> +<syntax><value>число</value></syntax> <default>100</default> <context>http</context> <context>server</context> @@ -661,25 +661,25 @@ location /404.html { <directive name="keepalive_timeout"> <syntax> - <argument>таймаут</argument> - [<argument>заголовок_таймаута</argument>]</syntax> + <value>таймаут</value> + [<value>заголовок_таймаута</value>]</syntax> <default>75s</default> <context>http</context> <context>server</context> <context>location</context> <para> -Первый аргумент задаёт таймаут, в течение которого keep-alive +Первый параметр задаёт таймаут, в течение которого keep-alive соединение с клиентом не будет закрыто со стороны сервера. Второй необязательный параметр задаёт значение в поле -<header>Keep-Alive: timeout=<argument>время</argument></header> +<header>Keep-Alive: timeout=<value>время</value></header> заголовка ответа. -Два аргумента могут отличаться друг от друга. +Два параметра могут отличаться друг от друга. </para> <para> Поле -<header>Keep-Alive: timeout=<argument>время</argument></header> +<header>Keep-Alive: timeout=<value>время</value></header> заголовка понимают Mozilla и Konqueror. MSIE сам закрывает keep-alive соединение примерно через 60 секунд. </para> @@ -688,13 +688,13 @@ MSIE сам закрывает keep-alive соединение примерно через 60 секунд. <directive name="large_client_header_buffers"> -<syntax><argument>число</argument> <argument>размер</argument></syntax> +<syntax><value>число</value> <value>размер</value></syntax> <default>4 8k</default> <context>http</context> <context>server</context> <para> -Задаёт максимальное <argument>число</argument> и <argument>размер</argument> +Задаёт максимальное <value>число</value> и <value>размер</value> буферов для чтения большого заголовка запроса клиента. Строка запроса не должна превышать размера одного буфера, иначе клиенту возвращается ошибка @@ -712,30 +712,30 @@ keep-alive, эти буферы освобождаются. <directive name="limit_except"> -<syntax block="yes"><argument>метод</argument> ...</syntax> +<syntax block="yes"><value>метод</value> ...</syntax> <default/> <context>location</context> <para> Ограничивает HTTP-методы, доступные внутри location. -Аргумент <argument>метод</argument> может быть одним из -<value>GET</value>, -<value>HEAD</value>, -<value>POST</value>, -<value>PUT</value>, -<value>DELETE</value>, -<value>MKCOL</value>, -<value>COPY</value>, -<value>MOVE</value>, -<value>OPTIONS</value>, -<value>PROPFIND</value>, -<value>PROPPATCH</value>, -<value>LOCK</value>, -<value>UNLOCK</value> +Параметр <value>метод</value> может быть одним из +<literal>GET</literal>, +<literal>HEAD</literal>, +<literal>POST</literal>, +<literal>PUT</literal>, +<literal>DELETE</literal>, +<literal>MKCOL</literal>, +<literal>COPY</literal>, +<literal>MOVE</literal>, +<literal>OPTIONS</literal>, +<literal>PROPFIND</literal>, +<literal>PROPPATCH</literal>, +<literal>LOCK</literal>, +<literal>UNLOCK</literal> или -<value>PATCH</value>. -Если разрешён метод <value>GET</value>, то метод -<value>HEAD</value> также будет разрешён. +<literal>PATCH</literal>. +Если разрешён метод <literal>GET</literal>, то метод +<literal>HEAD</literal> также будет разрешён. Доступ к остальным методам может быть ограничен при помощи директив модулей <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> и @@ -754,7 +754,7 @@ limit_except GET { <directive name="limit_rate"> -<syntax><argument>скорость</argument></syntax> +<syntax><value>скорость</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -775,7 +775,7 @@ limit_except GET { <para> Если необходимо ограничить скорость для части клиентов на уровне -<link id="server">сервера</link>, то директива <code>limit_rate</code> +<link id="server">сервера</link>, то директива <literal>limit_rate</literal> для этого не подходит. Вместо этого следует задать желаемое ограничение скорости в переменной <var>$limit_rate</var>: @@ -795,7 +795,7 @@ server { <directive name="limit_rate_after"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -823,7 +823,10 @@ location /flv/ { <directive name="lingering_close"> -<syntax><value>off</value> | <value>on</value> | <value>always</value></syntax> +<syntax> + <literal>off</literal> | + <literal>on</literal> | + <literal>always</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -836,7 +839,7 @@ location /flv/ { </para> <para> -Со значение по умолчанию “<value>on</value>” nginx будет +Со значением по умолчанию “<literal>on</literal>” nginx будет <link id="lingering_timeout">ждать</link> и <link id="lingering_time">обрабатывать</link> дополнительные данные, поступающие от клиента, перед полным закрытием соединения, но только @@ -844,12 +847,12 @@ location /flv/ { </para> <para> -Со значением “<value>always</value>” nginx всегда будет +Со значением “<literal>always</literal>” nginx всегда будет ждать и обрабатывать дополнительные данные, поступающие от клиента. </para> <para> -Со значением “<value>off</value>” nginx не будет ждать поступления +Со значением “<literal>off</literal>” nginx не будет ждать поступления дополнительных данных и сразу же закроет соединение. Это нарушает протокол, поэтому не следует это использовать без нужды. </para> @@ -858,7 +861,7 @@ location /flv/ { <directive name="lingering_time"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>30s</default> <context>http</context> <context>server</context> @@ -877,7 +880,7 @@ location /flv/ { <directive name="lingering_timeout"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>5s</default> <context>http</context> <context>server</context> @@ -897,52 +900,52 @@ location /flv/ { <directive name="listen"> <syntax> - <argument>адрес</argument>[:<argument>порт</argument>] - [<parameter>default_server</parameter>] - [<parameter>setfib</parameter>=<argument>число</argument>] - [<parameter>backlog</parameter>=<argument>число</argument>] - [<parameter>rcvbuf</parameter>=<argument>размер</argument>] - [<parameter>sndbuf</parameter>=<argument>размер</argument>] - [<parameter>accept_filter</parameter>=<argument>фильтр</argument>] - [<parameter>deferred</parameter>] - [<parameter>bind</parameter>] - [<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>] - [<parameter>ssl</parameter>] - [<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax> + <value>адрес</value>[:<value>порт</value>] + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>число</value>] + [<literal>backlog</literal>=<value>число</value>] + [<literal>rcvbuf</literal>=<value>размер</value>] + [<literal>sndbuf</literal>=<value>размер</value>] + [<literal>accept_filter</literal>=<value>фильтр</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <argument>порт</argument> - [<parameter>default_server</parameter>] - [<parameter>setfib</parameter>=<argument>число</argument>] - [<parameter>backlog</parameter>=<argument>число</argument>] - [<parameter>rcvbuf</parameter>=<argument>размер</argument>] - [<parameter>sndbuf</parameter>=<argument>размер</argument>] - [<parameter>accept_filter</parameter>=<argument>фильтр</argument>] - [<parameter>deferred</parameter>] - [<parameter>bind</parameter>] - [<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value>] - [<parameter>ssl</parameter>] - [<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax> + <value>порт</value> + [<literal>default_server</literal>] + [<literal>setfib</literal>=<value>число</value>] + [<literal>backlog</literal>=<value>число</value>] + [<literal>rcvbuf</literal>=<value>размер</value>] + [<literal>sndbuf</literal>=<value>размер</value>] + [<literal>accept_filter</literal>=<value>фильтр</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <syntax> - <value>unix:</value><argument>путь</argument> - [<parameter>default_server</parameter>] - [<parameter>backlog</parameter>=<argument>число</argument>] - [<parameter>rcvbuf</parameter>=<argument>размер</argument>] - [<parameter>sndbuf</parameter>=<argument>размер</argument>] - [<parameter>accept_filter</parameter>=<argument>фильтр</argument>] - [<parameter>deferred</parameter>] - [<parameter>bind</parameter>] - [<parameter>ssl</parameter>] - [<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>]]</syntax> + <literal>unix:</literal><value>путь</value> + [<literal>default_server</literal>] + [<literal>backlog</literal>=<value>число</value>] + [<literal>rcvbuf</literal>=<value>размер</value>] + [<literal>sndbuf</literal>=<value>размер</value>] + [<literal>accept_filter</literal>=<value>фильтр</value>] + [<literal>deferred</literal>] + [<literal>bind</literal>] + [<literal>ssl</literal>] + [<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>]]</syntax> <default>*:80 | *:8000</default> <context>server</context> <para> -Задаёт <argument>адрес</argument> и <argument>порт</argument> для IP -или <argument>путь</argument> для UNIX-сокета, +Задаёт <value>адрес</value> и <value>порт</value> для IP +или <value>путь</value> для UNIX-сокета, на которых сервер будет принимать запросы. -Можно указать только <argument>адрес</argument> -или только <argument>порт</argument>. -Кроме того, <argument>адрес</argument> может быть именем хоста, например: +Можно указать только <value>адрес</value> +или только <value>порт</value>. +Кроме того, <value>адрес</value> может быть именем хоста, например: <example> listen 127.0.0.1:8000; listen 127.0.0.1; @@ -955,51 +958,51 @@ IPv6-адреса (0.7.36) задаются в квадратных скобках: listen [::]:8000; listen [fe80::1]; </example> -UNIX-сокеты (0.8.21) задаются при помощи префикса “<code>unix:</code>”: +UNIX-сокеты (0.8.21) задаются при помощи префикса “<literal>unix:</literal>”: <example> listen unix:/var/run/nginx.sock; </example> </para> <para> -Если указан только <argument>адрес</argument>, то используется порт 80. +Если указан только <value>адрес</value>, то используется порт 80. </para> <para> -Если директива не указана, то используется либо <code>*:80</code> +Если директива не указана, то используется либо <literal>*:80</literal> (если nginx работает с привилегиями суперпользователя), -либо <code>*:8000</code>. +либо <literal>*:8000</literal>. </para> <para> -Если у директивы есть параметр <parameter>default_server</parameter>, то сервер, +Если у директивы есть параметр <literal>default_server</literal>, то сервер, в котором описана эта директива, будет сервером по умолчанию для указанной пары -<argument>адрес</argument>:<argument>порт</argument>. -Если же директив с параметром <parameter>default_server</parameter> нет, то +<value>адрес</value>:<value>порт</value>. +Если же директив с параметром <literal>default_server</literal> нет, то сервером по умолчанию будет первый сервер, в котором описана пара -<argument>адрес</argument>:<argument>порт</argument>. +<value>адрес</value>:<value>порт</value>. адрес:порт. <note> До версии 0.8.21 этот параметр назывался просто -<parameter>default</parameter>. +<literal>default</literal>. </note> </para> <para> -В директиве <code>listen</code> можно также указать несколько +В директиве <literal>listen</literal> можно также указать несколько дополнительных параметров, специфичных для системных вызовов <c-func>listen</c-func> и <c-func>bind</c-func>. -Эти параметры можно задать в любой директиве <code>listen</code>, +Эти параметры можно задать в любой директиве <literal>listen</literal>, но только один раз для указанной пары -<argument>адрес</argument>:<argument>порт</argument>. +<value>адрес</value>:<value>порт</value>. <note> До версии 0.8.21 их можно было указывать лишь в директиве -<code>listen</code> с параметром <parameter>default</parameter>. +<literal>listen</literal> с параметром <literal>default</literal>. </note> <list type="tag"> <tag-name> -<parameter>setfib</parameter>=<argument>число</argument> +<literal>setfib</literal>=<value>число</value> </tag-name> <tag-desc> этот параметр (0.8.44) задаёт для слушающего сокета соответствующую @@ -1008,42 +1011,42 @@ listen unix:/var/run/nginx.sock; </tag-desc> <tag-name> -<parameter>backlog</parameter>=<argument>число</argument> +<literal>backlog</literal>=<value>число</value> </tag-name> <tag-desc> -задаёт параметр <parameter>backlog</parameter> в вызове +задаёт параметр <literal>backlog</literal> в вызове <c-func>listen</c-func>. -По умолчанию <parameter>backlog</parameter> равен -1 для FreeBSD +По умолчанию <literal>backlog</literal> равен -1 для FreeBSD и 511 для других платформ. </tag-desc> <tag-name> -<parameter>rcvbuf</parameter>=<argument>размер</argument> +<literal>rcvbuf</literal>=<value>размер</value> </tag-name> <tag-desc> задаёт параметр <c-def>SO_RCVBUF</c-def> для слушающего сокета </tag-desc> <tag-name> -<parameter>sndbuf</parameter>=<argument>размер</argument> +<literal>sndbuf</literal>=<value>размер</value> </tag-name> <tag-desc> задаёт параметр <c-def>SO_SNDBUF</c-def> для слушающего сокета </tag-desc> <tag-name> -<parameter>accept_filter</parameter>=<argument>фильтр</argument> +<literal>accept_filter</literal>=<value>фильтр</value> </tag-name> <tag-desc> задаёт название accept-фильтра. Работает только на FreeBSD, можно использовать два фильтра — -<value>dataready</value> и <value>httpready</value>. +<literal>dataready</literal> и <literal>httpready</literal>. По сигналу <c-def>SIGHUP</c-def> accept-фильтр можно менять только в последних версиях FreeBSD, начиная с 6.0, 5.4-STABLE и 4.11-STABLE. </tag-desc> <tag-name> -<parameter>deferred</parameter> +<literal>deferred</literal> </tag-name> <tag-desc> указывает использовать отложенный <c-func>accept</c-func> на Linux @@ -1051,29 +1054,29 @@ listen unix:/var/run/nginx.sock; </tag-desc> <tag-name> -<parameter>bind</parameter> +<literal>bind</literal> </tag-name> <tag-desc> указывает, что для данной пары -<argument>адрес</argument>:<argument>порт</argument> нужно делать +<value>адрес</value>:<value>порт</value> нужно делать <c-func>bind</c-func> отдельно. -Дело в том, что если описаны несколько директив <code>listen</code> +Дело в том, что если описаны несколько директив <literal>listen</literal> с одинаковым портом, но разными адресами и одна из директив -<code>listen</code> слушает на всех адресах для данного порта -(<code>*</code>:<argument>порт</argument>, то nginx сделает -<c-func>bind</c-func> только на <code>*</code>:<argument>порт</argument>. +<literal>listen</literal> слушает на всех адресах для данного порта +(<literal>*:</literal><value>порт</value>, то nginx сделает +<c-func>bind</c-func> только на <literal>*:</literal><value>порт</value>. Необходимо заметить, что в этом случае для определения адреса, на которой пришло соединение, делается системный вызов <c-func>getsockname</c-func>. -Если же используются параметры <parameter>backlog</parameter>, -<parameter>rcvbuf</parameter>, <parameter>sndbuf</parameter>, -<parameter>accept_filter</parameter>, <parameter>deferred</parameter> -или <parameter>so_keepalive</parameter>, то для данной пары -<argument>адрес</argument>:<argument>порт</argument> всегда делается +Если же используются параметры <literal>backlog</literal>, +<literal>rcvbuf</literal>, <literal>sndbuf</literal>, +<literal>accept_filter</literal>, <literal>deferred</literal> +или <literal>so_keepalive</literal>, то для данной пары +<value>адрес</value>:<value>порт</value> всегда делается отдельный вызов <c-func>bind</c-func>. </tag-desc> <tag-name> -<parameter>ipv6only</parameter>=<value>on</value>|<value>off</value> +<literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal> </tag-name> <tag-desc> параметр (0.7.42) задаёт значение параметра <c-def>IPV6_V6ONLY</c-def> @@ -1082,7 +1085,7 @@ listen unix:/var/run/nginx.sock; </tag-desc> <tag-name> -<parameter>ssl</parameter> +<literal>ssl</literal> </tag-name> <tag-desc> этот параметр (0.7.14) не имеет отношения к системным вызовам @@ -1098,25 +1101,25 @@ listen 443 default ssl; </tag-desc> <tag-name> -<parameter>so_keepalive</parameter>=<value>on</value>|<value>off</value>|[<argument>keepidle</argument>]:[<argument>keepintvl</argument>]:[<argument>keepcnt</argument>] +<literal>so_keepalive</literal>=<literal>on</literal>|<literal>off</literal>|[<value>keepidle</value>]:[<value>keepintvl</value>]:[<value>keepcnt</value>] </tag-name> <tag-desc> этот параметр (1.1.11) конфигурирует для слушающего сокета поведение “TCP keepalive”. Если этот параметр опущен, то для сокета будут действовать стандартные системные настройки. -Если он установлен в значение “<value>on</value>”, то для сокета +Если он установлен в значение “<literal>on</literal>”, то для сокета включается опция <c-def>SO_KEEPALIVE</c-def>. -Если он установлен в значение “<value>off</value>”, то для сокета +Если он установлен в значение “<literal>off</literal>”, то для сокета опция <c-def>SO_KEEPALIVE</c-def> выключается. Некоторые операционные системы поддерживают настройку параметров “TCP keepalive” на уровне сокета посредством опций <c-def>TCP_KEEPIDLE</c-def>, <c-def>TCP_KEEPINTVL</c-def> и <c-def>TCP_KEEPCNT</c-def>. На таких системах (в настоящий момент это Linux 2.4+ и NetBSD 5+) -их можно сконфигурировать с помощью аргументов <argument>keepidle</argument>, -<argument>keepintvl</argument> и <argument>keepcnt</argument>. -Один или два аргумента могут быть опущены, в таком случае для +их можно сконфигурировать с помощью параметров <value>keepidle</value>, +<value>keepintvl</value> и <value>keepcnt</value>. +Один или два параметра могут быть опущены, в таком случае для соответствующей опции сокета будут действовать стандартные системные настройки. Например, @@ -1142,12 +1145,12 @@ listen 127.0.0.1 default accept_filter=d <directive name="location"> <syntax block="yes">[ - <value>=</value> | - <value>~</value> | - <value>~*</value> | - <value>^~</value> - ] <argument>uri</argument></syntax> -<syntax block="yes"><value>@</value><argument>имя</argument></syntax> + <literal>=</literal> | + <literal>~</literal> | + <literal>~*</literal> | + <literal>^~</literal> + ] <value>uri</value></syntax> +<syntax block="yes"><literal>@</literal><value>имя</value></syntax> <default/> <context>server</context> <context>location</context> @@ -1155,9 +1158,9 @@ listen 127.0.0.1 default accept_filter=d <para> Устанавливает конфигурацию в зависимости от URI запроса. location можно задать префиксной строкой или регулярным выражением. -Регулярные выражения задаются либо с префиксом “<value>~*</value>” +Регулярные выражения задаются либо с префиксом “<literal>~*</literal>” (для поиска совпадения без учёта регистра символов), -либо с префиксом “<value>~</value>” (с учётом регистра). +либо с префиксом “<literal>~</literal>” (с учётом регистра). Чтобы найти location, соответствующий запросу, вначале проверяются location'ы, заданные префиксными строками (префиксные location'ы). Среди них ищется максимальное совпадение. @@ -1188,15 +1191,15 @@ location'ы могут быть вложенными, с некоторыми исключениями, <para> Если у максимального совпавшего префиксного location'а указан префикс -“<value>^~</value>”, то регулярные выражения не проверяются. +“<literal>^~</literal>”, то регулярные выражения не проверяются. </para> <para> -Кроме того, с помощью префикса “<value>=</value>” можно задать точное +Кроме того, с помощью префикса “<literal>=</literal>” можно задать точное совпадение URI и location. При точном совпадении поиск сразу же прекращается. -Например, если запрос “<code>/</code>” случается часто, то -указав “<code>location = /</code>”, можно ускорить обработку +Например, если запрос “<literal>/</literal>” случается часто, то +указав “<literal>location = /</literal>”, можно ускорить обработку этих запросов, так как поиск прекратится после первого же сравнения. Очевидно, что такой location не может иметь вложенные location'ы. </para> @@ -1204,7 +1207,7 @@ location'ы могут быть вложенными, с некоторыми исключениями, <para> <note> В версиях с 0.7.1 по 0.8.41, если запрос точно совпал с префиксным -location'ом без префиксов “<value>=</value>” и “<value>^~</value>”, +location'ом без префиксов “<literal>=</literal>” и “<literal>^~</literal>”, то поиск тоже сразу же прекращается и регулярные выражения также не проверяются. </note> @@ -1229,14 +1232,14 @@ location ~* \.(gif|jpg|jpeg)$ { [ конфигурация Г ] } </example> -Для запроса “<code>/</code>” будет выбрана конфигурация А, -для запроса “<code>/documents/document.html</code>” — конфигурация Б, -для запроса “<code>/images/1.gif</code>” — конфигурация В, -а для запроса “<code>/documents/1.jpg</code>” — конфигурация Г. +Для запроса “<literal>/</literal>” будет выбрана конфигурация А, +для запроса “<literal>/documents/document.html</literal>” — конфигурация Б, +для запроса “<literal>/images/1.gif</literal>” — конфигурация В, +а для запроса “<literal>/documents/1.jpg</literal>” — конфигурация Г. </para> <para> -Префикс “<value>@</value>” задаёт именованный location. +Префикс “<literal>@</literal>” задаёт именованный location. Такой location не используется при обычной обработке запросов, а предназначен только для перенаправления в него запросов. Такие location'ы не могут быть вложенными и не могут содержать @@ -1251,7 +1254,7 @@ location ~* \.(gif|jpg|jpeg)$ { <directive name="log_not_found"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1267,7 +1270,7 @@ location ~* \.(gif|jpg|jpeg)$ { <directive name="log_subrequest"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1283,7 +1286,7 @@ location ~* \.(gif|jpg|jpeg)$ { <directive name="max_ranges"> -<syntax><argument>число</argument></syntax> +<syntax><value>число</value></syntax> <default/> <context>http</context> <context>server</context> @@ -1302,32 +1305,33 @@ location ~* \.(gif|jpg|jpeg)$ { <directive name="merge_slashes"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> <para> Разрешает или запрещает преобразование URI путём замены двух и более подряд -идущих слэшей (“<code>/</code>”) в один. +идущих слэшей (“<literal>/</literal>”) в один. </para> <para> Необходимо иметь ввиду, что это преобразование необходимо для корректной проверки префиксных строк и регулярных выражений. -Если его не делать, то запрос “<code>//scripts/one.php</code>” не попадёт в +Если его не делать, то запрос “<literal>//scripts/one.php</literal>” не попадёт в <example> location /scripts/ { ... } </example> и может быть обслужен как статический файл. -Поэтому он преобразуется к виду “<code>/scripts/one.php</code>”. +Поэтому он преобразуется к виду “<literal>/scripts/one.php</literal>”. </para> <para> Запрет преобразования может понадобиться, если в URI используются имена, -закодированные методом base64, в котором задействован символ “<code>/</code>”. +закодированные методом base64, в котором задействован символ +“<literal>/</literal>”. Однако по соображениям безопасности лучше избегать отключения преобразования. </para> @@ -1342,7 +1346,7 @@ location /scripts/ { <directive name="msie_padding"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1357,7 +1361,7 @@ location /scripts/ { <directive name="msie_refresh"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1372,10 +1376,10 @@ location /scripts/ { <directive name="open_file_cache"> -<syntax><value>off</value></syntax> +<syntax><literal>off</literal></syntax> <syntax> -<parameter>max</parameter>=<argument>N</argument> -[<parameter>inactive</parameter>=<argument>время</argument>]</syntax> +<literal>max</literal>=<value>N</value> +[<literal>inactive</literal>=<value>время</value>]</syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1410,7 +1414,7 @@ location /scripts/ { <list type="tag"> <tag-name> -<parameter>max</parameter> +<literal>max</literal> </tag-name> <tag-desc> задаёт максимальное число элементов в кэше; @@ -1418,7 +1422,7 @@ location /scripts/ { </tag-desc> <tag-name> -<parameter>inactive</parameter> +<literal>inactive</literal> </tag-name> <tag-desc> задаёт время, после которого элемент кэша удаляется, если к нему @@ -1426,7 +1430,7 @@ location /scripts/ { </tag-desc> <tag-name> -<value>off</value> +<literal>off</literal> </tag-name> <tag-desc> запрещает кэш. @@ -1452,7 +1456,7 @@ open_file_cache_events on; <directive name="open_file_cache_errors"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1469,7 +1473,7 @@ open_file_cache_events on; <!-- <directive name="open_file_cache_events"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1492,15 +1496,15 @@ open_file_cache_events on; <directive name="open_file_cache_min_uses"> -<syntax><argument>число</argument></syntax> +<syntax><value>число</value></syntax> <default>1</default> <context>http</context> <context>server</context> <context>location</context> <para> -Задаёт минимальное <argument>число</argument> обращений к файлу -в течение времени, заданного параметром <parameter>inactive</parameter> +Задаёт минимальное <value>число</value> обращений к файлу +в течение времени, заданного параметром <literal>inactive</literal> директивы <link id="open_file_cache"/>, после которого дескриптор файла будет оставаться открытым в кэше. </para> @@ -1509,7 +1513,7 @@ open_file_cache_events on; <directive name="open_file_cache_valid"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -1531,7 +1535,7 @@ open_file_cache_events on; <directive name="optimize_server_names"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1558,7 +1562,7 @@ open_file_cache_events on; <directive name="port_in_redirect"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -1576,7 +1580,7 @@ open_file_cache_events on; <directive name="postpone_output"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>1460</default> <context>http</context> <context>server</context> @@ -1592,7 +1596,7 @@ open_file_cache_events on; <directive name="read_ahead"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -1604,13 +1608,14 @@ open_file_cache_events on; <para> На Linux используется системный вызов -<code>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</code>, -поэтому аргумент <argument>размер</argument> там игнорируется. +<literal>posix_fadvise(0, 0, 0, POSIX_FADV_SEQUENTIAL)</literal>, +поэтому параметр <value>размер</value> там игнорируется. </para> <para> На FreeBSD используется системный вызов -<code>fcntl(O_READAHEAD,</code><argument>размер</argument><code>)</code>, +<literal>fcntl(O_READAHEAD, +</literal><value>размер</value><literal>)</literal>, появившийся во FreeBSD 9.0-CURRENT. Для FreeBSD 7 необходимо установить <link url="http://sysoev.ru/freebsd/patch.readahead.txt">патч</link>. @@ -1620,7 +1625,7 @@ open_file_cache_events on; <directive name="recursive_error_pages"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1635,7 +1640,7 @@ open_file_cache_events on; <directive name="request_pool_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>4k</default> <context>http</context> <context>server</context> @@ -1652,7 +1657,7 @@ open_file_cache_events on; <directive name="reset_timedout_connection"> <syntax> - <value>on</value> | <value>off</value></syntax> + <literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1680,8 +1685,8 @@ open_file_cache_events on; <directive name="resolver"> <syntax> -<argument>адрес</argument> ... -[<parameter>valid</parameter>=<argument>время</argument>]</syntax> +<value>адрес</value> ... +[<literal>valid</literal>=<value>время</value>]</syntax> <default/> <context>http</context> <context>server</context> @@ -1693,7 +1698,7 @@ open_file_cache_events on; <example> resolver 127.0.0.1 192.0.2.1; </example> -Аргумент <argument>адрес</argument> может быть задан либо +Параметр <value>адрес</value> может быть задан либо IPv4-адресом, либо именем хоста; во втором случае используется первый полученный IPv4-адрес. Серверы DNS опрашиваются циклически. @@ -1701,7 +1706,7 @@ IPv4-адресом, либо именем хоста; До версии 1.1.7 можно было задать лишь один DNS-сервер. </note> По умолчанию nginx кэширует ответы, используя значение TTL из ответа. -Необязательный параметр <parameter>valid</parameter> позволяет это +Необязательный параметр <literal>valid</literal> позволяет это переопределить: <example> resolver 127.0.0.1 192.0.2.1 valid=30s; @@ -1716,7 +1721,7 @@ resolver 127.0.0.1 192.0.2.1 valid=30s; <directive name="resolver_timeout"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>30s</default> <context>http</context> <context>server</context> @@ -1733,7 +1738,7 @@ resolver_timeout 5s; <directive name="root"> -<syntax><argument>путь</argument></syntax> +<syntax><value>путь</value></syntax> <default>html</default> <context>http</context> <context>server</context> @@ -1748,18 +1753,18 @@ location /i/ { root /data/w3; } </example> -в ответ на запрос “<code>/i/top.gif</code>” будет отдан файл +в ответ на запрос “<literal>/i/top.gif</literal>” будет отдан файл <path>/data/w3/i/top.gif</path>. </para> <para> -В значении аргумента <argument>путь</argument> можно использовать переменные, +В значении параметра <value>путь</value> можно использовать переменные, кроме <var>$document_root</var> и <var>$realpath_root</var>. </para> <para> Путь к файлу формируется путём простого добавления URI к значению директивы -<code>root</code>. +<literal>root</literal>. Если же URI необходимо поменять, следует воспользоваться директивой <link id="alias"/>. </para> @@ -1768,15 +1773,15 @@ location /i/ { <directive name="satisfy"> -<syntax><value>all</value> | <value>any</value></syntax> +<syntax><literal>all</literal> | <literal>any</literal></syntax> <default>all</default> <context>http</context> <context>server</context> <context>location</context> <para> -Разрешает доступ, если оба (<value>all</value>) -или хотя бы один (<value>any</value>) из модулей +Разрешает доступ, если оба (<literal>all</literal>) +или хотя бы один (<literal>any</literal>) из модулей <link doc="ngx_http_access_module.xml">ngx_http_access_module</link> и <link doc="ngx_http_auth_basic_module.xml">ngx_http_auth_basic_module</link> разрешают доступ. @@ -1801,7 +1806,7 @@ location / { <directive name="satisfy_any"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1816,7 +1821,7 @@ location / { <directive name="send_lowat"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -1839,7 +1844,7 @@ location / { <directive name="send_timeout"> -<syntax><argument>время</argument></syntax> +<syntax><value>время</value></syntax> <default>60s</default> <context>http</context> <context>server</context> @@ -1858,7 +1863,7 @@ location / { <directive name="sendfile"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -1875,7 +1880,7 @@ location / { <directive name="sendfile_max_chunk"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -1912,7 +1917,7 @@ location / { <directive name="server_name"> -<syntax><argument>имя</argument> ...</syntax> +<syntax><value>имя</value> ...</syntax> <default>""</default> <context>server</context> @@ -1927,7 +1932,7 @@ server { <para> Первое имя становится основным именем сервера. -В именах серверов можно использовать звёздочку (“<code>*</code>”) +В именах серверов можно использовать звёздочку (“<literal>*</literal>”) для замены первой или последней части имени: <example> server { @@ -1946,13 +1951,13 @@ server { </para> <para> -Если аргумент равен “<var>$hostname</var>” (0.9.4), то +Если параметр равен “<var>$hostname</var>” (0.9.4), то подставляется имя хоста (hostname) машины. </para> <para> В качестве имени сервера можно также использовать регулярное выражение, -указав перед ним тильду (“<code>~</code>”): +указав перед ним тильду (“<literal>~</literal>”): <example> server { server_name www.example.com ~^www\d+\.example\.com$; @@ -2028,11 +2033,11 @@ server { </listitem> <listitem> -имена с маской в начале имени, например “<code>*.example.com</code>” +имена с маской в начале имени, например “<literal>*.example.com</literal>” </listitem> <listitem> -имена с маской в конце имени, например “<code>mail.*</code>” +имена с маской в конце имени, например “<literal>mail.*</literal>” </listitem> <listitem> @@ -2046,7 +2051,7 @@ server { <directive name="server_name_in_redirect"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2069,7 +2074,7 @@ server { <directive name="server_names_hash_bucket_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>32|64|128</default> <context>http</context> @@ -2084,12 +2089,12 @@ server { <directive name="server_names_hash_max_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>512</default> <context>http</context> <para> -Задаёт максимальный <argument>размер</argument> хэш-таблиц имён серверов. +Задаёт максимальный <value>размер</value> хэш-таблиц имён серверов. Подробнее смотрите в документе по <link doc="../hash.xml">настройке хэшей</link>. </para> @@ -2098,7 +2103,7 @@ server { <directive name="server_tokens"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -2113,7 +2118,7 @@ server { <directive name="tcp_nodelay"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context> @@ -2128,7 +2133,7 @@ server { <directive name="tcp_nopush"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2159,11 +2164,11 @@ server { <directive name="try_files"> <syntax> - <argument>файл</argument> ... - <argument>uri</argument></syntax> + <value>файл</value> ... + <value>uri</value></syntax> <syntax> - <argument>файл</argument> ... - =<argument>код</argument></syntax> + <value>файл</value> ... + =<value>код</value></syntax> <default/> <context>server</context> <context>location</context> @@ -2172,13 +2177,13 @@ server { Проверяет существование файлов в заданном порядке и использует для обработки запроса первый найденный файл, причём обработка делается в контексте этого же location'а. -Путь к файлу строится из аргумента <argument>файл</argument> +Путь к файлу строится из параметра <value>файл</value> в соответствии с директивами <link id="root"/> и <link id="alias"/>. С помощью слэша в конце имени можно проверить существование каталога, -например, “<code>$uri/</code>”. +например, “<literal>$uri/</literal>”. В случае, если ни один файл не найден, то делается внутреннее -перенаправление на <argument>uri</argument>, заданный последним аргументом. +перенаправление на <value>uri</value>, заданный последним параметром. Например: <example> location /images/ { @@ -2189,9 +2194,9 @@ location = /images/default.gif { expires 30s; } </example> -Последний аргумент может также указывать на именованный location, +Последний параметр может также указывать на именованный location, смотрите примеры ниже. -С версии 0.7.51 последний аргумент может также быть кодом: +С версии 0.7.51 последний параметр может также быть кодом: <example> location / { try_files $uri $uri/index.html $uri.html =404; @@ -2243,7 +2248,7 @@ location @drupal { ... прочие fastcgi_param } </example> -В следующем примере директива <code>try_files</code> +В следующем примере директива <literal>try_files</literal> <example> location / { try_files $uri $uri/ @drupal; @@ -2268,7 +2273,7 @@ location ~ \.php$ { ... } </example> -<code>try_files</code> проверяет существование PHP-файла, +<literal>try_files</literal> проверяет существование PHP-файла, прежде чем передать запрос FastCGI-серверу. </para> @@ -2331,7 +2336,7 @@ types { <para> Для того, чтобы для определённого location'а для всех ответов -выдавался MIME-тип “<code>application/octet-stream</code>”, +выдавался MIME-тип “<literal>application/octet-stream</literal>”, можно использовать следующее: <example> location /download/ { @@ -2345,7 +2350,7 @@ location /download/ { <directive name="types_hash_bucket_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>32|64|128</default> <context>http</context> <context>server</context> @@ -2362,14 +2367,14 @@ location /download/ { <directive name="types_hash_max_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>1024</default> <context>http</context> <context>server</context> <context>location</context> <para> -Задаёт максимальный <argument>размер</argument> хэш-таблиц типов. +Задаёт максимальный <value>размер</value> хэш-таблиц типов. Подробнее смотрите в документе по <link doc="../hash.xml">настройке хэшей</link>. </para> @@ -2378,7 +2383,7 @@ location /download/ { <directive name="underscores_in_headers"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -2395,7 +2400,7 @@ location /download/ { <directive name="variables_hash_bucket_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>64</default> <context>http</context> @@ -2409,12 +2414,12 @@ location /download/ { <directive name="variables_hash_max_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>512</default> <context>http</context> <para> -Задаёт максимальный <argument>размер</argument> хэш-таблицы переменных. +Задаёт максимальный <value>размер</value> хэш-таблицы переменных. Подробнее смотрите в документе по <link doc="../hash.xml">настройке хэшей</link>. </para> @@ -2426,7 +2431,7 @@ location /download/ { <section id="variables" name="Встроенные переменные"> <para> -Модуль <code>ngx_http_core_module</code> поддерживает встроенные переменные, +Модуль <literal>ngx_http_core_module</literal> поддерживает встроенные переменные, имена которых совпадают с именами переменных веб-сервера Apache. Прежде всего, это переменные, представляющие из себя поля заголовка запроса клиента, такие как <var>$http_user_agent</var>, <var>$http_cookie</var> @@ -2434,9 +2439,9 @@ location /download/ { Кроме того, есть и другие переменные: <list type="tag"> -<tag-name><var>$arg_</var><argument>имя</argument></tag-name> +<tag-name><var>$arg_</var><value>имя</value></tag-name> <tag-desc> -аргумент <argument>имя</argument> в строке запроса +аргумент <value>имя</value> в строке запроса </tag-desc> <tag-name><var>$args</var></tag-name> @@ -2464,9 +2469,9 @@ location /download/ { поле <header>Content-Type</header> заголовка запроса </tag-desc> -<tag-name><var>$cookie_</var><argument>имя</argument></tag-name> +<tag-name><var>$cookie_</var><value>имя</value></tag-name> <tag-desc> -cookie <argument>имя</argument> +cookie <value>имя</value> </tag-desc> <tag-name><var>$document_root</var></tag-name> @@ -2490,21 +2495,21 @@ cookie <argument>имя</argument> имя хоста </tag-desc> -<tag-name><var>$http_</var><argument>имя</argument></tag-name> +<tag-name><var>$http_</var><value>имя</value></tag-name> <tag-desc> -поле <argument>имя</argument> заголовка запроса +поле <value>имя</value> заголовка запроса </tag-desc> <tag-name><var>$https</var></tag-name> <tag-desc> -“<code>on</code>” +“<literal>on</literal>” если соединение работает в режиме SSL, либо пустая строка </tag-desc> <tag-name><var>$is_args</var></tag-name> <tag-desc> -“<code>?</code>”, если в строке запроса есть аргументы, +“<literal>?</literal>”, если в строке запроса есть аргументы, и пустая строка, если их нет </tag-desc> @@ -2588,7 +2593,7 @@ fastcgi_pass_request_body off</link> <tag-name><var>$request_completion</var></tag-name> <tag-desc> -“<code>OK</code>” если запрос завершился, +“<literal>OK</literal>” если запрос завершился, либо пустая строка </tag-desc> @@ -2601,7 +2606,7 @@ fastcgi_pass_request_body off</link> <tag-name><var>$request_method</var></tag-name> <tag-desc> метод запроса, обычно -“<code>GET</code>” или “<code>POST</code>” +“<literal>GET</literal>” или “<literal>POST</literal>” </tag-desc> <tag-name><var>$request_uri</var></tag-name> @@ -2611,12 +2616,12 @@ fastcgi_pass_request_body off</link> <tag-name><var>$scheme</var></tag-name> <tag-desc> -схема запроса, “<code>http</code>” или “<code>https</code>” +схема запроса, “<literal>http</literal>” или “<literal>https</literal>” </tag-desc> -<tag-name><var>$sent_http_</var><argument>имя</argument></tag-name> +<tag-name><var>$sent_http_</var><value>имя</value></tag-name> <tag-desc> -поле <argument>имя</argument> заголовка ответа +поле <value>имя</value> заголовка ответа </tag-desc> <tag-name><var>$server_addr</var></tag-name> @@ -2625,7 +2630,7 @@ fastcgi_pass_request_body off</link> <para> Получение значения этой переменной обычно требует одного системного вызова. Чтобы избежать системного вызова, в директивах <link id="listen"/> -следует указывать адреса и использовать параметр <parameter>bind</parameter>. +следует указывать адреса и использовать параметр <literal>bind</literal>. </para> </tag-desc> @@ -2642,9 +2647,9 @@ fastcgi_pass_request_body off</link> <tag-name><var>$server_protocol</var></tag-name> <tag-desc> протокол сервера, обычно -“<code>HTTP/1.0</code>” +“<literal>HTTP/1.0</literal>” или -“<code>HTTP/1.1</code>” +“<literal>HTTP/1.1</literal>” </tag-desc> <tag-name><var>$uri</var></tag-name>
--- a/xml/ru/docs/http/ngx_http_dav_module.xml +++ b/xml/ru/docs/http/ngx_http_dav_module.xml @@ -12,7 +12,7 @@ Модуль ngx_http_dav_module обрабатывает HTTP- и WebDAV-методы PUT, DELETE, MKCOL, COPY и MOVE. По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_dav_module</command>. +при конфигурировании параметром <literal>--with-http_dav_module</literal>. </para> </section> @@ -46,8 +46,7 @@ PUT, DELETE, MKCOL, COPY и MOVE. <section name="Директивы" id="directives"> <directive name="dav_access"> -<syntax><value>пользователи:права [пользователи:права] ...</value> -</syntax> +<syntax><value>пользователи</value><literal>:</literal><value>права</value> ...</syntax> <default>user:rw</default> <context>http, server, location</context> @@ -68,7 +67,10 @@ dav_access group:rw all:r; <directive name="dav_methods"> -<syntax><value>[off|put|delete|mkcol|copy|move] ...</value></syntax> +<syntax> + <literal>off</literal> | <literal>put</literal> | <literal>delete</literal> | + <literal>mkcol</literal> | <literal>copy</literal> | <literal>move</literal> + ...</syntax> <default>off</default> <context>http, server, location</context> @@ -100,7 +102,7 @@ dav_access group:rw all:r; <directive name="create_full_put_path"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml @@ -55,7 +55,7 @@ location / { <directive name="fastcgi_buffers"> -<syntax><value>число размер</value></syntax> +<syntax><value>число</value> <value>размер</value></syntax> <default>8 4k/8k</default> <context>http, server, location</context> @@ -70,7 +70,7 @@ location / { <directive name="fastcgi_cache"> -<syntax><value>[зона|off]</value></syntax> +<syntax><value>зона</value> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -85,7 +85,7 @@ location / { <directive name="fastcgi_cache_bypass"> -<syntax><value>строка [...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -119,8 +119,12 @@ fastcgi_cache_key localhost:9000$reques <directive name="fastcgi_cache_path"> -<syntax><value>путь [levels=уровни] -keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> +<syntax> + <value>путь</value> + [<literal>levels</literal>=<value>уровни</value>] + <literal>keys_zone</literal>=<value>название</value>:<value>размер</value> + [<literal>inactive</literal>=<value>время</value>] + [<literal>max_size</literal>=<value>размер</value>]</syntax> <default/> <context>http</context> @@ -180,7 +184,7 @@ inactive, то данные удаляются, независимо от их свежести. <directive name="fastcgi_cache_valid"> -<syntax><value>ответ [ответ ...] время</value> +<syntax><value>ответ</value> ... <value>время</value> </syntax> <default/> <context>http, server, location</context> @@ -217,9 +221,16 @@ fastcgi_cache_valid any 1m; <directive name="fastcgi_cache_use_stale"> -<syntax><value>[error | timeout | invalid_header - | updating | http_500 | http_503 | http_404 | off] -[...]</value></syntax> +<syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_503</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http, server, location</context> @@ -287,7 +298,7 @@ nginx не передаёт клиенту строки заголовка "Status" и "X-Accel-..." <directive name="fastcgi_ignore_client_abort"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -301,7 +312,7 @@ nginx не передаёт клиенту строки заголовка "Status" и "X-Accel-..." <directive name="fastcgi_ignore_headers"> -<syntax><value>имя [имя ...]</value></syntax> +<syntax><value>имя</value> ...</syntax> <default/> <context>http, server, location</context> @@ -317,7 +328,7 @@ nginx не передаёт клиенту строки заголовка "Status" и "X-Accel-..." <directive name="fastcgi_intercept_errors"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -331,7 +342,7 @@ nginx не передаёт клиенту строки заголовка "Status" и "X-Accel-..." <directive name="fastcgi_no_cache"> -<syntax><value>строка [...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -352,8 +363,14 @@ fastcgi_no_cache $http_pragma $htt <directive name="fastcgi_next_upstream"> <syntax> -<value>[error|timeout|invalid_header|http_500|http_503|http_404|off]</value> -</syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_503</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http, server, location</context> @@ -407,9 +424,8 @@ off — запрещает передачу запроса следующему серверу; <directive name="fastcgi_param"> <syntax> - <argument>параметр значение</argument> - [<parameter>if_not_empty</parameter>] -</syntax> + <value>параметр</value> <value>значение</value> + [<literal>if_not_empty</literal>]</syntax> <default/> <context>http, server, location</context> @@ -417,7 +433,7 @@ off — запрещает передачу запроса следующему серверу; Директива задаёт параметр, который будут передаваться FastCGI-серверу. В качестве значения можно использовать текст, переменные и их комбинации. Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы <code>fastcgi_param</code>. +уровне не описаны свои директивы <literal>fastcgi_param</literal>. </para> <para> @@ -444,7 +460,7 @@ fastcgi_param CONTENT_LENGTH $content <para> Если PHP был собран с параметром конфигурации -<command>--enable-force-cgi-redirect</command>, то нужно передавать +<literal>--enable-force-cgi-redirect</literal>, то нужно передавать параметр REDIRECT_STATUS со значением "200": <example> fastcgi_param REDIRECT_STATUS 200; @@ -452,7 +468,7 @@ fastcgi_param REDIRECT_STATUS 200; </para> <para> -Если директива указана с флагом <parameter>if_not_empty</parameter> (1.1.11), +Если директива указана с флагом <literal>if_not_empty</literal> (1.1.11), то такой параметр с пустым значением передаваться на сервер не будет: <example> fastcgi_param HTTPS $https if_not_empty; @@ -559,7 +575,10 @@ location ~ ^(.+\.php)(.*)$ { <directive name="fastcgi_store"> -<syntax><value>on | off | строка </value></syntax> +<syntax> + <literal>on</literal> | + <literal>off</literal> | + <value>строка</value></syntax> <default>off</default> <context>http, server, location</context> @@ -617,8 +636,7 @@ location /fetch/ { <directive name="fastcgi_store_access"> -<syntax><value>пользователи:права [пользователи:права] -...</value></syntax> +<syntax><value>пользователи</value>:<value>права</value> ...</syntax> <default>user:rw</default> <context>http, server, location</context> @@ -641,8 +659,7 @@ fastcgi_store_access group:rw all:r; <directive name="fastcgi_temp_path"> -<syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] -</value></syntax> +<syntax><value>путь</value> [<value>уровень1</value> [<value>уровень2</value> [<value>уровень3</value>]]]</syntax> <default>fastcgi_temp</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_flv_module.xml +++ b/xml/ru/docs/http/ngx_http_flv_module.xml @@ -16,7 +16,7 @@ <para> По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_flv_module</command>. +при конфигурировании параметром <literal>--with-http_flv_module</literal>. </para> </section>
--- a/xml/ru/docs/http/ngx_http_geo_module.xml +++ b/xml/ru/docs/http/ngx_http_geo_module.xml @@ -35,8 +35,7 @@ <section name="Директивы" id="directives"> <directive name="geo"> -<syntax block="yes"><value>[$адрес] $переменная</value> -</syntax> +<syntax block="yes">[<value>$адрес</value>] <value>$переменная</value></syntax> <default/> <context>http</context>
--- a/xml/ru/docs/http/ngx_http_geoip_module.xml +++ b/xml/ru/docs/http/ngx_http_geoip_module.xml @@ -13,7 +13,7 @@ зависят от IP-адреса клиента, используя готовые базы <link url="http://www.maxmind.com">MaxMind</link> (0.8.6+). По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_geoip_module</command>. +при конфигурировании параметром <literal>--with-http_geoip_module</literal>. Для сборки и работы этого модуля нужна библиотека <link url="http://www.maxmind.com/app/c">MaxMind GeoIP</link>.
--- a/xml/ru/docs/http/ngx_http_gzip_module.xml +++ b/xml/ru/docs/http/ngx_http_gzip_module.xml @@ -37,7 +37,7 @@ <section name="Директивы" id="directives"> <directive name="gzip"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location, if в location</context> @@ -49,7 +49,7 @@ <directive name="gzip_buffers"> -<syntax><value>число размер</value></syntax> +<syntax><value>число</value> <value>размер</value></syntax> <default>32 4k/16 8k</default> <context>http, server, location</context> @@ -65,19 +65,20 @@ <directive name="gzip_comp_level"> -<syntax><value>1..9</value></syntax> +<syntax><value>степень</value></syntax> <default>1</default> <context>http, server, location</context> <para> -Устанавливает уровень сжатия ответа методом gzip. +Устанавливает <value>степень</value> сжатия ответа методом gzip. +Допустимые значения находятся в диапазоне 1..9. </para> </directive> <directive name="gzip_disable"> -<syntax><value>regex [regex ...]</value></syntax> +<syntax><value>regex</value> ...</syntax> <default/> <context>http, server, location</context> @@ -110,7 +111,7 @@ <directive name="gzip_http_version"> -<syntax><value>1.0|1.1</value></syntax> +<syntax><literal>1.0</literal> | <literal>1.1</literal></syntax> <default>1.1</default> <context>http, server, location</context> @@ -122,7 +123,17 @@ <directive name="gzip_proxied"> -<syntax><value>[off|expired|no-cache|no-store|private|no_last_modified|no_etag|auth|any] ...</value></syntax> +<syntax> + <literal>off</literal> | + <literal>expired</literal> | + <literal>no-cache</literal> | + <literal>no-store</literal> | + <literal>private</literal> | + <literal>no_last_modified</literal> | + <literal>no_etag</literal> | + <literal>auth</literal> | + <literal>any</literal> + ...</syntax> <default>off</default> <context>http, server, location</context> @@ -183,7 +194,7 @@ any — разрешить сжатие для всех проксированных запросов; <directive name="gzip_types"> -<syntax><value>mime-тип [mime-тип ...]</value></syntax> +<syntax><value>mime-тип</value> ...</syntax> <default>text/html</default> <context>http, server, location</context> @@ -196,7 +207,7 @@ any — разрешить сжатие для всех проксированных запросов; <directive name="gzip_vary"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_gzip_static_module.xml +++ b/xml/ru/docs/http/ngx_http_gzip_static_module.xml @@ -16,7 +16,7 @@ <para> По умолчанию модуль не собирается, нужно разрешить его сборку при -конфигурировании параметром <command>--with-http_gzip_static_module</command>. +конфигурировании параметром <literal>--with-http_gzip_static_module</literal>. </para> </section> @@ -37,7 +37,7 @@ <section name="Директивы" id="directives"> <directive name="gzip_static"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_headers_module.xml +++ b/xml/ru/docs/http/ngx_http_headers_module.xml @@ -35,7 +35,7 @@ <section name="Директивы" id="directives"> <directive name="add_header"> -<syntax><value>название значение</value></syntax> +<syntax><value>название</value> <value>значение</value></syntax> <default/> <context>http, server, location</context> @@ -49,7 +49,11 @@ <directive name="expires"> -<syntax><value>[modified]</value> <value>[время|epoch|max|off]</value></syntax> +<syntax>[<literal>modified</literal>] <value>время</value></syntax> +<syntax> + <literal>epoch</literal> | + <literal>max</literal> | + <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_image_filter_module.xml +++ b/xml/ru/docs/http/ngx_http_image_filter_module.xml @@ -9,14 +9,14 @@ <section id="summary"> <para> -Модуль <code>ngx_http_image_filter_module</code> — это фильтр для преобразования -изображений в форматах JPEG, GIF и PNG (0.7.54+). +Модуль <literal>ngx_http_image_filter_module</literal> — это фильтр +для преобразования изображений в форматах JPEG, GIF и PNG (0.7.54+). </para> <para> По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра -<code>--with-http_image_filter_module</code>. +<literal>--with-http_image_filter_module</literal>. <note> Для сборки и работы этого модуля необходима библиотека <link url="http://libgd.org">libgd</link>. @@ -51,19 +51,19 @@ location = /empty { <section name="Директивы" id="directives"> <directive name="image_filter"> - <syntax><parameter>off</parameter></syntax> - <syntax><parameter>test</parameter></syntax> - <syntax><parameter>size</parameter></syntax> - <syntax><parameter>rotate</parameter> - <value>90</value> | <value>180</value> | <value>270</value></syntax> + <syntax><literal>off</literal></syntax> + <syntax><literal>test</literal></syntax> + <syntax><literal>size</literal></syntax> + <syntax><literal>rotate</literal> + <literal>90</literal> | <literal>180</literal> | <literal>270</literal></syntax> <syntax> - <parameter>resize</parameter> - <argument>ширина</argument> - <argument>высота</argument></syntax> + <literal>resize</literal> + <value>ширина</value> + <value>высота</value></syntax> <syntax> - <parameter>crop</parameter> - <argument>ширина</argument> - <argument>высота</argument></syntax> + <literal>crop</literal> + <value>ширина</value> + <value>высота</value></syntax> <default/> <context>location</context> @@ -71,12 +71,12 @@ location = /empty { Задаёт тип преобразования изображения: <list type="tag"> -<tag-name><parameter>off</parameter></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> отключает обработку данным модулем во вложенном location. </tag-desc> -<tag-name><parameter>test</parameter></tag-name> +<tag-name><literal>test</literal></tag-name> <tag-desc> проверяет, что ответ действительно является изображением в формате JPEG, GIF или PNG. @@ -84,7 +84,7 @@ location = /empty { <http-status code="415" text="Unsupported Media Type"/>. </tag-desc> -<tag-name><parameter>size</parameter></tag-name> +<tag-name><literal>size</literal></tag-name> <tag-desc> выдаёт информацию об изображении в формате JSON, например: <example> @@ -96,45 +96,45 @@ location = /empty { </example> </tag-desc> -<tag-name><parameter>rotate</parameter> -<value>90</value>|<value>180</value>|<value>270</value> +<tag-name><literal>rotate</literal> +<literal>90</literal>|<literal>180</literal>|<literal>270</literal> </tag-name> <tag-desc> поворачивает изображение против часовой стрелки на указанное число градусов. -В значении аргумента допустимо использование переменных. +В значении параметра допустимо использование переменных. Можно использовать как отдельно, так и совместно с преобразованиями -<parameter>resize</parameter> и <parameter>crop</parameter>. +<literal>resize</literal> и <literal>crop</literal>. </tag-desc> -<tag-name><parameter>resize</parameter> -<argument>ширина</argument> -<argument>высота</argument> +<tag-name><literal>resize</literal> +<value>ширина</value> +<value>высота</value> </tag-name> <tag-desc> пропорционально уменьшает изображение до указанных размеров. Если требуется уменьшить только по одному измерению, то в качестве второго -можно указать “<code>-</code>”. +можно указать “<literal>-</literal>”. В случае ошибки сервер возвращает код <http-status code="415" text="Unsupported Media Type"/>. -В значениях аргументов допустимо использование переменных. -При использовании совместно с <parameter>rotate</parameter>, +В значениях параметров допустимо использование переменных. +При использовании совместно с <literal>rotate</literal>, поворот изображения происходит <emphasis>после</emphasis> уменьшения размеров изображения. </tag-desc> -<tag-name><parameter>crop</parameter> -<argument>ширина</argument> -<argument>высота</argument> +<tag-name><literal>crop</literal> +<value>ширина</value> +<value>высота</value> </tag-name> <tag-desc> пропорционально уменьшает изображение до размера большей стороны и обрезает лишние края по другой стороне. Если требуется уменьшить только по одному измерению, то в качестве второго -можно указать “<code>-</code>”. +можно указать “<literal>-</literal>”. В случае ошибки сервер возвращает код <http-status code="415" text="Unsupported Media Type"/>. -В значениях аргументов допустимо использование переменных. -При использовании совместно с <parameter>rotate</parameter>, +В значениях параметров допустимо использование переменных. +При использовании совместно с <literal>rotate</literal>, поворот изображения происходит <emphasis>до</emphasis> уменьшения размеров изображения. </tag-desc> @@ -162,25 +162,26 @@ location = /empty { <directive name="image_filter_jpeg_quality"> -<syntax><value>1..100</value></syntax> +<syntax><value>качество</value></syntax> <default>75</default> <context>http</context> <context>server</context> <context>location</context> <para> -Задаёт желаемое качество преобразованного изображения в формате JPEG. +Задаёт желаемое <value>качество</value> преобразованного изображения в формате JPEG. +Допустимые значения находятся в диапазоне 1..100. Меньшим значениям обычно соответствует худшее качество изображения и меньший объём передаваемых данных. Максимальное рекомендуемое значение — 95. -В значении аргумента допустимо использование переменных. +В значении параметра допустимо использование переменных. </para> </directive> <directive name="image_filter_sharpen"> -<syntax><argument>процент</argument></syntax> +<syntax><value>процент</value></syntax> <default>0</default> <context>http</context> <context>server</context> @@ -190,14 +191,14 @@ location = /empty { Повышает резкость итогового изображения. Процент резкости может быть больше 100. Значение 0 отключает повышение резкости. -В значении аргумента допустимо использование переменных. +В значении параметра допустимо использование переменных. </para> </directive> <directive name="image_filter_transparency"> -<syntax><value>on</value>|<value>off</value></syntax> +<syntax><literal>on</literal>|<literal>off</literal></syntax> <default>on</default> <context>http</context> <context>server</context>
--- a/xml/ru/docs/http/ngx_http_index_module.xml +++ b/xml/ru/docs/http/ngx_http_index_module.xml @@ -31,8 +31,7 @@ <section name="Директивы" id="directives"> <directive name="index"> -<syntax><value>файл [файл ...]</value> -</syntax> +<syntax><value>файл</value> ...</syntax> <default>index.html</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_limit_conn_module.xml +++ b/xml/ru/docs/http/ngx_http_limit_conn_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -Модуль <code>ngx_http_limit_conn_module</code> позволяет ограничить +Модуль <literal>ngx_http_limit_conn_module</literal> позволяет ограничить число соединений по заданному ключу или, как частный случай, число соединений с одного IP-адреса. </para> @@ -47,7 +47,7 @@ http { <section name="Директивы" id="directives"> <directive name="limit_conn"> -<syntax><argument>зона</argument> <argument>число</argument></syntax> +<syntax><value>зона</value> <value>число</value></syntax> <default/> <context>http</context> <context>server</context> @@ -72,7 +72,8 @@ IP-адреса. </para> <para> -Допустимо одновременное указание нескольких директив <code>limit_conn</code>, +Допустимо одновременное указание нескольких директив +<literal>limit_conn</literal>, при этом будет срабатывать любое из ограничений. Например, следующая конфигурация ограничивает число соединений с сервером с одного клиентского IP-адреса и в то же время ограничивает общее число @@ -92,7 +93,7 @@ IP-адреса. <para> Директивы наследуются с предыдущего уровня при условии, что на данном уровне -не описаны свои директивы <code>limit_conn</code>. +не описаны свои директивы <literal>limit_conn</literal>. </para> </directive> @@ -100,10 +101,10 @@ IP-адреса. <directive name="limit_conn_log_level"> <syntax> -<value>info</value> | -<value>notice</value> | -<value>warn</value> | -<value>error</value></syntax> +<literal>info</literal> | +<literal>notice</literal> | +<literal>warn</literal> | +<literal>error</literal></syntax> <default>error</default> <context>http</context> <context>server</context> @@ -120,8 +121,8 @@ IP-адреса. <directive name="limit_conn_zone"> <syntax> - <argument>$переменная</argument> - <parameter>zone</parameter>=<argument>название</argument>:<argument>размер</argument></syntax> + <value>$переменная</value> + <literal>zone</literal>=<value>название</value>:<value>размер</value></syntax> <default/> <context>http</context> @@ -155,9 +156,9 @@ limit_conn_zone $binary_remote_addr zone <directive name="limit_zone"> <syntax> - <argument>название</argument> - <argument>$переменная</argument> - <argument>размер</argument></syntax> + <value>название</value> + <value>$переменная</value> + <value>размер</value></syntax> <default/> <context>http</context> @@ -166,9 +167,9 @@ limit_conn_zone $binary_remote_addr zone использовать аналогичную директиву <link id="limit_conn_zone"/> с изменённым синтаксисом: <note> -<code>limit_conn_zone</code> -<argument>$переменная</argument> -<parameter>zone</parameter>=<argument>название</argument>:<argument>размер</argument>; +<literal>limit_conn_zone</literal> +<value>$переменная</value> +<literal>zone</literal>=<value>название</value>:<value>размер</value>; </note> </para>
--- a/xml/ru/docs/http/ngx_http_limit_req_module.xml +++ b/xml/ru/docs/http/ngx_http_limit_req_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -Модуль <code>ngx_http_limit_req_module</code> (0.7.21) позволяет +Модуль <literal>ngx_http_limit_req_module</literal> (0.7.21) позволяет ограничить число запросов по заданному ключу или, как частный случай, число запросов с одного IP-адреса. Ограничение делается с помощью метода “leaky bucket”. @@ -43,9 +43,9 @@ http { <directive name="limit_req"> <syntax> - <parameter>zone</parameter>=<argument>название</argument> - [<parameter>burst</parameter>=<argument>число</argument>] - [<parameter>nodelay</parameter>]</syntax> + <literal>zone</literal>=<value>название</value> + [<literal>burst</literal>=<value>число</value>] + [<literal>nodelay</literal>]</syntax> <default/> <context>http</context> <context>server</context> @@ -77,7 +77,7 @@ limit_req_zone $binary_remote_addr zone= <para> Если же избыточные запросы в пределах лимита всплесков задерживать -не требуется, то следует использовать параметр <parameter>nodelay</parameter>: +не требуется, то следует использовать параметр <literal>nodelay</literal>: <example> limit_req zone=one burst=5 nodelay; </example> @@ -88,10 +88,10 @@ limit_req_zone $binary_remote_addr zone= <directive name="limit_req_log_level"> <syntax> -<value>info</value> | -<value>notice</value> | -<value>warn</value> | -<value>error</value></syntax> +<literal>info</literal> | +<literal>notice</literal> | +<literal>warn</literal> | +<literal>error</literal></syntax> <default>error</default> <context>http</context> <context>server</context> @@ -102,8 +102,8 @@ limit_req_zone $binary_remote_addr zone= Директива задаёт желаемый уровень записи в лог случаев ограничения числа запросов и задержек при обработке запроса. Задержки записываются в лог с уровнем на единицу меньшим, чем ограничения, -например, если указано <command>limit_req_log_level notice</command>, -то задержки будут записываться в лог на уровне <value>info</value>. +например, если указано “<literal>limit_req_log_level notice</literal>”, +то задержки будут записываться в лог на уровне <literal>info</literal>. </para> </directive> @@ -111,9 +111,9 @@ limit_req_zone $binary_remote_addr zone= <directive name="limit_req_zone"> <syntax> - <argument>$переменная</argument> - <parameter>zone</parameter>=<argument>название</argument>:<argument>размер</argument> - <parameter>rate</parameter>=<argument>скорость</argument></syntax> + <value>$переменная</value> + <literal>zone</literal>=<value>название</value>:<value>размер</value> + <literal>rate</literal>=<value>скорость</value></syntax> <default/> <context>http</context>
--- a/xml/ru/docs/http/ngx_http_limit_zone_module.xml +++ b/xml/ru/docs/http/ngx_http_limit_zone_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -В версии 1.1.8 модуль <code>ngx_http_limit_zone_module</code> +В версии 1.1.8 модуль <literal>ngx_http_limit_zone_module</literal> был переименован в модуль <link doc="ngx_http_limit_conn_module.xml">ngx_http_limit_conn_module</link>. </para>
--- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/http/ngx_http_log_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -Модуль <code>ngx_http_log_module</code> записывает логи запросов +Модуль <literal>ngx_http_log_module</literal> записывает логи запросов в указанном формате. </para> @@ -35,10 +35,10 @@ <directive name="access_log"> <syntax> - <argument>путь</argument> - [<argument>формат</argument> - [<parameter>buffer</parameter>=<argument>размер</argument>]]</syntax> -<syntax><value>off</value></syntax> + <value>путь</value> + [<value>формат</value> + [<literal>buffer</literal>=<value>размер</value>]]</syntax> +<syntax><literal>off</literal></syntax> <default>log/access.log combined</default> <context>http</context> <context>server</context> @@ -49,10 +49,10 @@ <para> Задаёт путь, формат и размер буфера для буферизованной записи в лог. На одном уровне может использоваться несколько логов. -Специальное значение <value>off</value> отменяет все директивы -<code>access_log</code> для текущего уровня. +Специальное значение <literal>off</literal> отменяет все директивы +<literal>access_log</literal> для текущего уровня. Если формат не указан, то используется предопределённый формат -“<code>combined</code>”. +“<literal>combined</literal>”. </para> <para> @@ -80,7 +80,7 @@ Следует однако иметь в виду, что поскольку дескрипторы часто используемых файлов могут храниться в <link id="open_log_file_cache">кэше</link>, то при вращении логов в течение времени, заданного параметром -<parameter>valid</parameter> директивы <link id="open_log_file_cache"/>, +<literal>valid</literal> директивы <link id="open_log_file_cache"/>, запись может продолжаться в старый файл. </listitem> @@ -89,7 +89,7 @@ <link doc="ngx_http_core_module.xml" id="root">корневого каталога</link> для запроса — если этот каталог не существует, то лог не создаётся. Поэтому <link doc="ngx_http_core_module.xml" id="root"/> -и <code>access_log</code> нужно описывать на одном уровне: +и <literal>access_log</literal> нужно описывать на одном уровне: <example> server { root /spool/vhost/data/$host; @@ -106,8 +106,8 @@ server { <directive name="log_format"> <syntax> - <argument>название</argument> - <argument>строка</argument> ...</syntax> + <value>название</value> + <value>строка</value> ...</syntax> <default>combined "..."</default> <context>http</context> @@ -123,8 +123,8 @@ server { <tag-name><var>$body_bytes_sent</var></tag-name> <tag-desc> число байт, переданных клиенту, за вычетом заголовка ответа; -переменная совместима с параметром “<code>%B</code>” модуля Apache -<code>mod_log_config</code> +переменная совместима с параметром “<literal>%B</literal>” модуля Apache +<literal>mod_log_config</literal> </tag-desc> <tag-name><var>$bytes_sent</var></tag-name> @@ -144,7 +144,7 @@ server { <tag-name><var>$pipe</var></tag-name> <tag-desc> -“<code>p</code>” если запрос был pipelined, иначе “<code>.</code>” +“<literal>p</literal>” если запрос был pipelined, иначе “<literal>.</literal>” </tag-desc> <tag-name><var>$request_length</var></tag-name> @@ -179,13 +179,13 @@ server { <para> Строки заголовка, переданные клиенту, начинаются с префикса -“<code>sent_http_</code>”, например, +“<literal>sent_http_</literal>”, например, <var>$sent_http_content_range</var>. </para> <para> В конфигурации всегда существует предопределённый формат -“<code>combined</code>”: +“<literal>combined</literal>”: <example> log_format combined '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' @@ -198,11 +198,11 @@ server { <directive name="open_log_file_cache"> <syntax> -<parameter>max</parameter>=<argument>N</argument> -[<parameter>inactive</parameter>=<argument>время</argument>] -[<parameter>min_uses</parameter>=<argument>N</argument>] -[<parameter>valid</parameter>=<argument>время</argument>]</syntax> -<syntax><value>off</value></syntax> +<literal>max</literal>=<value>N</value> +[<literal>inactive</literal>=<value>время</value>] +[<literal>min_uses</literal>=<value>N</value>] +[<literal>valid</literal>=<value>время</value>]</syntax> +<syntax><literal>off</literal></syntax> <default>off</default> <context>http</context> <context>server</context> @@ -214,36 +214,36 @@ server { Параметры директивы: <list type="tag"> -<tag-name><parameter>max</parameter></tag-name> +<tag-name><literal>max</literal></tag-name> <tag-desc> задаёт максимальное число дескрипторов в кэше; при переполнении кэша наиболее давно не используемые (LRU) дескрипторы закрываются </tag-desc> -<tag-name><parameter>inactive</parameter></tag-name> +<tag-name><literal>inactive</literal></tag-name> <tag-desc> задаёт время, после которого закэшированный дескриптор закрывается, если к нему не было обращений в течение этого времени; по умолчанию 10 секунд </tag-desc> -<tag-name><parameter>min_uses</parameter></tag-name> +<tag-name><literal>min_uses</literal></tag-name> <tag-desc> задаёт минимальное число использований файла в течение -времени, заданного параметром <parameter>inactive</parameter>, +времени, заданного параметром <literal>inactive</literal>, после которого дескриптор файла будет оставаться открытым в кэше; по умолчанию 1 </tag-desc> -<tag-name><parameter>valid</parameter></tag-name> +<tag-name><literal>valid</literal></tag-name> <tag-desc> задаёт, через какое время нужно проверять, что файл ещё существует под тем же именем; по умолчанию 60 секунд </tag-desc> -<tag-name><value>off</value></tag-name> +<tag-name><literal>off</literal></tag-name> <tag-desc> запрещает кэш </tag-desc>
--- a/xml/ru/docs/http/ngx_http_map_module.xml +++ b/xml/ru/docs/http/ngx_http_map_module.xml @@ -41,7 +41,7 @@ <section name="Директивы" id="directives"> <directive name="map"> -<syntax block="yes"><value>$переменная1 $переменная2</value></syntax> +<syntax block="yes"><value>$переменная1</value> <value>$переменная2</value></syntax> <default/> <context>http</context>
--- a/xml/ru/docs/http/ngx_http_memcached_module.xml +++ b/xml/ru/docs/http/ngx_http_memcached_module.xml @@ -69,7 +69,13 @@ server { <directive name="memcached_next_upstream"> -<syntax><value>[error|timeout|invalid_response|not_found|off]</value></syntax> +<syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_response</literal> | + <literal>not_found</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_mp4_module.xml +++ b/xml/ru/docs/http/ngx_http_mp4_module.xml @@ -9,7 +9,7 @@ <section id="summary"> <para> -Модуль <code>ngx_http_mp4_module</code> обеспечивает серверную поддержку +Модуль <literal>ngx_http_mp4_module</literal> обеспечивает серверную поддержку псевдо-стриминга для файлов в формате H.264/AAC. Такие файлы обычно имеют расширения <path>.mp4</path>, <path>.m4v</path> и <path>.m4a</path>. @@ -19,7 +19,7 @@ Псевдо-стриминг работает в паре с совместимым Flash-плеером. Плеер посылает серверу HTTP-запрос с указанием точки времени старта в аргументе -<parameter>start</parameter> +<literal>start</literal> строки запроса (время задаётся в секундах), а сервер в ответ посылает поток, у которого начальная позиция соответствует запрошенному времени, например: @@ -40,7 +40,7 @@ http://example.com/elephants_dream.mp4?s <para> До начала воспроизведения плееру необходимо прочитать метаданные. Для этого он отсылает специальный запрос с аргументом -<parameter>start=0</parameter>. +<literal>start=0</literal>. Многие кодирующие программы добавляют метаданные в конец файла. Для псевдо-стриминга это плохо: метаданные должны быть расположены в начале файла, иначе потребуется загрузить файл целиком, прежде @@ -58,7 +58,7 @@ url="http://flowplayer.org/plugins/strea <para> Для запроса с ненулевым аргументом -<parameter>start</parameter> +<literal>start</literal> nginx считывает из файла метаданные, готовит поток с запрошенного смещения, и отправляет его клиенту. Это тоже требует дополнительных ресурсов, как указано выше. @@ -66,7 +66,7 @@ nginx считывает из файла метаданные, готовит поток с запрошенного <para> Если запрос, обрабатываемый этим модулем, не содержит аргумента -<parameter>start</parameter>, +<literal>start</literal>, дополнительные ресурсы не тратятся, а файл отсылается просто как статический ресурс. Некоторые плееры также поддерживают запросы с указанием диапазона @@ -77,7 +77,7 @@ nginx считывает из файла метаданные, готовит поток с запрошенного <para> По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра -<code>--with-http_mp4_module</code>. +<literal>--with-http_mp4_module</literal>. <note> Если вы ранее использовали сторонний модуль mp4, не забудьте его отключить. </note> @@ -121,7 +121,7 @@ location /video/ { <directive name="mp4_buffer_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>512K</default> <context>http</context> <context>server</context> @@ -135,7 +135,7 @@ location /video/ { <directive name="mp4_max_buffer_size"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default>10M</default> <context>http</context> <context>server</context>
--- a/xml/ru/docs/http/ngx_http_perl_module.xml +++ b/xml/ru/docs/http/ngx_http_perl_module.xml @@ -12,7 +12,7 @@ Модуль ngx_http_perl_module позволяет работать со встроенным в nginx perl'ом: делать обработчики location и переменной и вставлять вызовы perl'а в SSI. По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_perl_module</command>. +при конфигурировании параметром <literal>--with-http_perl_module</literal>. Для сборки необходим perl версии 5.6.1 и выше, и компилятор C, совместимый с тем, которым был собран perl. </para>
--- a/xml/ru/docs/http/ngx_http_proxy_module.xml +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml @@ -49,7 +49,7 @@ location / { <directive name="proxy_buffering"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location</context> @@ -72,7 +72,7 @@ location / { <directive name="proxy_buffers"> -<syntax><value>число размер</value></syntax> +<syntax><value>число</value> <value>размер</value></syntax> <default>8 4k/8k</default> <context>http, server, location</context> @@ -87,7 +87,7 @@ location / { <directive name="proxy_cache"> -<syntax><value>[зона|off]</value></syntax> +<syntax><value>зона</value> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -102,7 +102,7 @@ location / { <directive name="proxy_cache_bypass"> -<syntax><value>строка [...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -140,8 +140,12 @@ proxy_cache_key $scheme$proxy_host$uri$ <directive name="proxy_cache_path"> -<syntax><value>путь [levels=уровни] -keys_zone=название:размер [inactive=время] [max_size=размер]</value></syntax> +<syntax> + <value>путь</value> + [<literal>levels</literal>=<value>уровни</value>] + <literal>keys_zone</literal>=<value>название</value>:<value>размер</value> + [<literal>inactive</literal>=<value>время</value>] + [<literal>max_size</literal>=<value>размер</value>]</syntax> <default/> <context>http</context> @@ -201,8 +205,7 @@ inactive, то данные удаляются, независимо от их свежести. <directive name="proxy_cache_valid"> -<syntax><value>ответ [ответ ...] время</value> -</syntax> +<syntax><value>ответ</value> ... <value>время</value></syntax> <default/> <context>http, server, location</context> @@ -238,9 +241,18 @@ proxy_cache_valid any 1m; <directive name="proxy_cache_use_stale"> -<syntax><value>[error | timeout | invalid_header - | updating | http_500 | http_502 | http_503 | http_504 | http_404 | off] -[...]</value></syntax> +<syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>updating</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>off</default> <context>http, server, location</context> @@ -286,7 +298,7 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_ignore_client_abort"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -299,7 +311,7 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_ignore_headers"> -<syntax><value>имя [имя ...]</value></syntax> +<syntax><value>имя</value> ...</syntax> <default/> <context>http, server, location</context> @@ -315,7 +327,7 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_intercept_errors"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -329,9 +341,17 @@ nginx не передаёт клиенту строки заголовка "Date", "Server", "X-Pad" и <directive name="proxy_next_upstream"> -<syntax><value>[error | timeout | invalid_header - | http_500 | http_502 | http_503 | http_504 | http_404 | off] -[...]</value></syntax> +<syntax> + <literal>error</literal> | + <literal>timeout</literal> | + <literal>invalid_header</literal> | + <literal>http_500</literal> | + <literal>http_502</literal> | + <literal>http_503</literal> | + <literal>http_504</literal> | + <literal>http_404</literal> | + <literal>off</literal> + ...</syntax> <default>error timeout</default> <context>http, server, location</context> @@ -391,7 +411,7 @@ off — запрещает передачу запроса следующему серверу; <directive name="proxy_no_cache"> -<syntax><value>строка [...]</value></syntax> +<syntax><value>строка</value> ...</syntax> <default/> <context>http, server, location</context> @@ -529,10 +549,9 @@ location /some/path/ { <directive name="proxy_redirect"> <syntax> - <value>default</value> | - <value>off</value> | - <argument>перенаправление замена</argument> -</syntax> + <literal>default</literal> | + <literal>off</literal> | + <value>перенаправление</value> <value>замена</value></syntax> <default>default</default> <context>http</context> <context>server</context> @@ -561,7 +580,7 @@ location /some/path/ { </para> <para> -Изменение по умолчанию, задаваемое значением <value>default</value>, использует +Изменение по умолчанию, задаваемое значением <literal>default</literal>, использует параметры директив <link doc="ngx_http_core_module.xml" id="location"/> и <link id="proxy_pass"/>. Поэтому две нижеприведённые конфигурации одинаковы: @@ -576,7 +595,7 @@ location /one/ { proxy_pass http://upstream:port/two/; proxy_redirect http://upstream:port/two/ /one/; </example> -Значение <value>default</value> недопустимо, если в <link id="proxy_pass"/> +Значение <literal>default</literal> недопустимо, если в <link id="proxy_pass"/> используются переменные. </para> @@ -596,11 +615,12 @@ location /one/ { <para> Директиву также можно задать (1.1.11) при помощи регулярных выражений. -При этом <argument>перенаправление</argument> должен начинаться либо с символа -“<code>~</code>”, если при сравнении следует учитывать регистр символов, -либо с символов “<code>~*</code>”, если регистр символов учитывать не нужно. +При этом <value>перенаправление</value> должно начинаться либо с символа +“<literal>~</literal>”, если при сравнении следует учитывать регистр символов, +либо с символов “<literal>~*</literal>”, если регистр символов учитывать +не нужно. Регулярное выражение может содержать именованные и позиционные выделения, -а <argument>замена</argument> на них ссылаться: +а <value>замена</value> ссылаться на них: <example> proxy_redirect ~^(http://[^:]+):\d+(/.+)$ $1$2; proxy_redirect ~*/user/([^/]+)/(.+)$ http://$1.example.com/$2; @@ -617,7 +637,8 @@ location /one/ { </para> <para> -Значение <value>off</value> запрещает все директивы <code>proxy_redirect</code> +Значение <literal>off</literal> запрещает все директивы +<literal>proxy_redirect</literal> на данном уровне: <example> proxy_redirect off; @@ -671,7 +692,7 @@ location /one/ { <directive name="proxy_set_header"> -<syntax><value>заголовок значение</value></syntax> +<syntax><value>заголовок</value> <value>значение</value></syntax> <default>Host $proxy_host</default> <default>Connection close</default> <context>http, server, location</context> @@ -725,7 +746,7 @@ proxy_set_header Accept-Encoding ""; <directive name="proxy_ssl_session_reuse"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location</context> @@ -740,7 +761,7 @@ proxy_set_header Accept-Encoding ""; <directive name="proxy_store"> -<syntax><value>on | off | строка </value></syntax> +<syntax><literal>on</literal> | <literal>off</literal> | <value>строка</value></syntax> <default>off</default> <context>http, server, location</context> @@ -817,8 +838,7 @@ location @fetch { <directive name="proxy_store_access"> -<syntax><value>пользователи:права [пользователи:права] -...</value></syntax> +<syntax><value>пользователи</value>:<value>права</value> ...</syntax> <default>user:rw</default> <context>http, server, location</context> @@ -841,8 +861,7 @@ proxy_store_access group:rw all:r; <directive name="proxy_temp_path"> -<syntax><value>путь [ уровень1 [ уровень2 [ уровень3 ] ] ] -</value></syntax> +<syntax><value>путь</value> [<value>уровень1</value> [<value>уровень2</value> [<value>уровень3</value>]]]</syntax> <default>proxy_temp</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_random_index_module.xml +++ b/xml/ru/docs/http/ngx_http_random_index_module.xml @@ -13,7 +13,7 @@ индексного файла каталога. Модуль работает до модуля <link doc="ngx_http_index_module.xml">ngx_http_index_module</link>. По умолчанию модуль не собирается, нужно разрешить его сборку при -конфигурировании параметром <command>--with-http_random_index_module</command>. +конфигурировании параметром <literal>--with-http_random_index_module</literal>. </para> </section> @@ -35,7 +35,7 @@ <section name="Директивы" id="directives"> <directive name="random_index"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>location</context>
--- a/xml/ru/docs/http/ngx_http_realip_module.xml +++ b/xml/ru/docs/http/ngx_http_realip_module.xml @@ -12,7 +12,7 @@ Модуль ngx_http_realip_module позволяет менять адрес клиента на переданный в указанной строке заголовка. По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_realip_module</command>. +при конфигурировании параметром <literal>--with-http_realip_module</literal>. </para> </section> @@ -34,7 +34,7 @@ <section name="Директивы" id="directives"> <directive name="set_real_ip_from"> -<syntax><value>[адрес|CIDR]</value></syntax> +<syntax><value>адрес</value> | <value>CIDR</value></syntax> <default/> <context>http, server, location</context> @@ -47,12 +47,15 @@ <directive name="real_ip_header"> -<syntax><value>имя строки[X-Real-IP|X-Forwarded-For]</value></syntax> +<syntax> + <value>поле</value> | + <literal>X-Real-IP</literal> | + <literal>X-Forwarded-For</literal></syntax> <default>X-Real-IP</default> <context>http, server, location</context> <para> -Директива указывает название строки в заголовке запроса, +Директива задаёт поле заголовка запроса, в котором передаётся адрес для замены. В случае строки "X-Forwarded-For" используется последний адрес в значении строки. Для остальных строк используется всё значение.
--- a/xml/ru/docs/http/ngx_http_referer_module.xml +++ b/xml/ru/docs/http/ngx_http_referer_module.xml @@ -42,7 +42,12 @@ <section name="Директивы" id="directives"> <directive name="valid_referers"> -<syntax>[none|blocked|server_names|<value>строка</value>] ...</syntax> +<syntax> + <literal>none</literal> | + <literal>blocked</literal> | + <literal>server_names</literal> | + <value>строка</value> + ...</syntax> <default/> <context>server, location</context>
--- a/xml/ru/docs/http/ngx_http_rewrite_module.xml +++ b/xml/ru/docs/http/ngx_http_rewrite_module.xml @@ -152,9 +152,7 @@ 402 — 406, 408, 410, 411, 413, 416 и 500 — 504. <directive name="rewrite"> -<syntax><value>regex</value> <value>замена</value> - <value>флаг</value> -</syntax> +<syntax><value>regex</value> <value>замена</value> <value>флаг</value></syntax> <default/> <context>server, location, if</context> @@ -235,8 +233,7 @@ permanent — возвращает постоянное перенаправление с кодом 301. <directive name="set"> -<syntax><value>переменная</value> <value>значение</value> -</syntax> +<syntax><value>переменная</value> <value>значение</value></syntax> <default/> <context>server, location, if</context> @@ -249,7 +246,7 @@ permanent — возвращает постоянное перенаправление с кодом 301. <directive name="uninitialized_variable_warn"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location, if</context>
--- a/xml/ru/docs/http/ngx_http_secure_link_module.xml +++ b/xml/ru/docs/http/ngx_http_secure_link_module.xml @@ -13,7 +13,7 @@ правильность запрашиваемой ссылки (0.7.18+). По умолчанию модуль не собирается, нужно разрешить его сборку при конфигурировании параметром -<command>--with-http_secure_link_module</command>. +<literal>--with-http_secure_link_module</literal>. </para> </section>
--- a/xml/ru/docs/http/ngx_http_split_clients_module.xml +++ b/xml/ru/docs/http/ngx_http_split_clients_module.xml @@ -38,7 +38,7 @@ http { <section name="Директивы" id="directives"> <directive name="split_clients"> -<syntax block="yes"><value>$переменная1 $переменная2</value></syntax> +<syntax block="yes"><value>$переменная1</value> <value>$переменная2</value></syntax> <default/> <context>http</context>
--- a/xml/ru/docs/http/ngx_http_ssi_module.xml +++ b/xml/ru/docs/http/ngx_http_ssi_module.xml @@ -34,7 +34,7 @@ Side Includes) в проходящих через него ответах. <section name="Директивы" id="directives"> <directive name="ssi"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location, if в location</context> @@ -46,7 +46,7 @@ Side Includes) в проходящих через него ответах. <directive name="ssi_silent_errors"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -60,7 +60,7 @@ Side Includes) в проходящих через него ответах. <directive name="ssi_types"> -<syntax><value>mime-тип [mime-тип ...]</value></syntax> +<syntax><value>mime-тип</value> ...</syntax> <default>text/html</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_ssl_module.xml +++ b/xml/ru/docs/http/ngx_http_ssl_module.xml @@ -19,7 +19,7 @@ nginx также будет использовать и сертификаты этих промежуточных CA. <para> По умолчанию модуль не собирается, нужно разрешить его сборку при конфигурировании параметром -<command>--with-http_ssl_module</command>. +<literal>--with-http_ssl_module</literal>. Для сборки и работы этого модуля нужна библиотека <link url="http://www.openssl.org">OpenSSL</link>. </para> @@ -85,7 +85,7 @@ http { <section name="Директивы" id="directives"> <directive name="ssl"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server</context> @@ -178,7 +178,7 @@ OpenSSL, например: <para> Полный список можно посмотреть с помощью команды -<command>openssl ciphers</command>. +“<command>openssl ciphers</command>”. </para> </directive> @@ -210,7 +210,7 @@ OpenSSL, например: <directive name="ssl_prefer_server_ciphers"> -<syntax><value>[on|off]</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>off</default> <context>http, server</context> @@ -223,7 +223,7 @@ OpenSSL, например: <directive name="ssl_protocols"> -<syntax><value>[SSLv2] [SSLv3] [TLSv1]</value></syntax> +<syntax>[<literal>SSLv2</literal>] [<literal>SSLv3</literal>] [<literal>TLSv1</literal>]</syntax> <default>SSLv3 TLSv1</default> <context>http, server</context> @@ -235,7 +235,7 @@ OpenSSL, например: <directive name="ssl_verify_client"> -<syntax><value>on|off|optional</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal> | <literal>optional</literal></syntax> <default>off</default> <context>http, server</context> @@ -262,8 +262,11 @@ OpenSSL, например: <directive name="ssl_session_cache"> -<syntax><value>off|none|[builtin[:размер]] [shared:название:размер] -</value></syntax> +<syntax> + <literal>off</literal> | + <literal>none</literal> | + [<literal>builtin</literal>[:<value>размер</value>]] + [<literal>shared</literal>:<value>название</value>:<value>размер</value>]</syntax> <default>none</default> <context>http, server</context>
--- a/xml/ru/docs/http/ngx_http_sub_module.xml +++ b/xml/ru/docs/http/ngx_http_sub_module.xml @@ -12,7 +12,7 @@ Модуль ngx_http_sub_module — это фильтр, изменяющий в ответе одну заданную строку на другую. По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_sub_module</command>. +при конфигурировании параметром <literal>--with-http_sub_module</literal>. </para> </section> @@ -36,7 +36,7 @@ location / { <section name="Директивы" id="directives"> <directive name="sub_filter"> -<syntax><value>строка замена</value></syntax> +<syntax><value>строка</value> <value>замена</value></syntax> <default/> <context>http, server, location</context> @@ -50,7 +50,7 @@ location / { <directive name="sub_filter_once"> -<syntax><value>on|off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>http, server, location</context> @@ -63,7 +63,7 @@ location / { <directive name="sub_filter_types"> -<syntax><value>mime-тип [mime-тип ...]</value></syntax> +<syntax><value>mime-тип</value> ...</syntax> <default>text/html</default> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_upstream_module.xml +++ b/xml/ru/docs/http/ngx_http_upstream_module.xml @@ -84,7 +84,7 @@ upstream backend { <directive name="server"> -<syntax><value>название [параметры]</value></syntax> +<syntax><value>название</value> [<value>параметры</value>]</syntax> <default/> <context>upstream</context>
--- a/xml/ru/docs/http/ngx_http_userid_module.xml +++ b/xml/ru/docs/http/ngx_http_userid_module.xml @@ -38,7 +38,11 @@ <section name="Директивы" id="directives"> <directive name="userid"> -<syntax><value>[on|v1|log||off]</value></syntax> +<syntax> + <literal>on</literal> | + <literal>v1</literal> | + <literal>log</literal> | + <literal>off</literal></syntax> <default>off</default> <context>http, server, location</context> @@ -72,7 +76,7 @@ off — запрещает выдавать cookie и записывать приходящие cookie в лог; <directive name="userid_domain"> -<syntax><value>[имя|none]</value></syntax> +<syntax><value>имя</value> | <literal>none</literal></syntax> <default>none</default> <context>http, server, location</context> @@ -85,7 +89,7 @@ off — запрещает выдавать cookie и записывать приходящие cookie в лог; <directive name="userid_expires"> -<syntax><value>[время|max]</value></syntax> +<syntax><value>время</value> | <literal>max</literal></syntax> <default/> <context>http, server, location</context>
--- a/xml/ru/docs/http/ngx_http_xslt_module.xml +++ b/xml/ru/docs/http/ngx_http_xslt_module.xml @@ -12,7 +12,7 @@ Модуль ngx_http_xslt_module — это фильтр, преобразующий XML-ответ с помощью одного или нескольких XSLT-шаблонов (0.7.8+). По умолчанию модуль не собирается, нужно разрешить его сборку -при конфигурировании параметром <command>--with-http_xslt_module</command>. +при конфигурировании параметром <literal>--with-http_xslt_module</literal>. Для сборки и работы этого модуля нужны библиотеки <link url="http://www.xmlsoft.org">libxml2 и libxslt</link>. </para> @@ -59,7 +59,7 @@ location / { <directive name="xslt_stylesheet"> -<syntax><value>шаблон [параметр ...]</value></syntax> +<syntax><value>шаблон</value> [<value>параметр</value> ...]</syntax> <default/> <context>location</context> @@ -106,7 +106,7 @@ location / { </directive> <directive name="xslt_types"> -<syntax><value>mime-тип [mime-тип ...]</value></syntax> +<syntax><value>mime-тип</value> ...</syntax> <default>text/xml</default> <context>http, server, location</context>
--- a/xml/ru/docs/install.xml +++ b/xml/ru/docs/install.xml @@ -10,86 +10,86 @@ Конфигурация сборки осуществляется командой <command>configure</command>. Она определяет особенности системы и, в частности, методы, которые nginx может использовать для обработки соединений. -В конце концов она создаёт <command>Makefile</command>. +В конце концов она создаёт <path>Makefile</path>. Команда <command>configure</command> поддерживает следующие параметры: <list> <listitem> <para> -<command>--prefix=<<value>путь</value>></command>—задаёт каталог, +<literal>--prefix=<value>путь</value></literal>—задаёт каталог, в котором будут находиться файлы сервера. Этот же каталог будет использоваться для всех относительных путей, -задаваемых <command>./configure</command> (кроме путей к исходным текстам -библиотек) и в конфигурационном файле <command>nginx.conf</command>. -По умолчанию—каталог <command>/usr/local/nginx</command>. +задаваемых <command>configure</command> (кроме путей к исходным текстам +библиотек) и в конфигурационном файле <path>nginx.conf</path>. +По умолчанию—каталог <path>/usr/local/nginx</path>. </para> </listitem> <listitem> <para> -<command>--sbin-path=<<value>путь</value>></command>—задаёт +<literal>--sbin-path=<value>путь</value></literal>—задаёт имя исполняемого файла nginx. Это имя используется только на стадии установки. По умолчанию файл называется -<command><<value>prefix</value>>/sbin/nginx</command>. +<path><value>префикс</value>/sbin/nginx</path>. </para> </listitem> <listitem> <para> -<command>--conf-path=<<value>путь</value>></command>—задаёт -имя конфигурационного файла <command>nginx.conf</command>. +<literal>--conf-path=<value>путь</value></literal>—задаёт +имя конфигурационного файла <path>nginx.conf</path>. При желании nginx можно всегда запустить с другим конфигурационным файлом, указав его в параметре командной строки -<nobr><command>-c <<value>файл</value>></command></nobr>. +<nobr><literal>-c <value>файл</value></literal></nobr>. По умолчанию файл называется -<command><<value>prefix</value>>/conf/nginx.conf</command>. +<path><value>префикс</value>/conf/nginx.conf</path>. </para> </listitem> <listitem> <para> -<command>--pid-path=<<value>путь</value>></command>—задаёт +<literal>--pid-path=<value>путь</value></literal>—задаёт имя файла nginx.pid, в котором будет храниться номер главного процесса. После установки имя файла можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="pid"/>. По умолчанию имя -файла—<command><<value>prefix</value>>/logs/nginx.pid</command>. +файла—<path><value>префикс</value>/logs/nginx.pid</path>. </para> </listitem> <listitem> <para> -<command>--error-log-path=<<value>путь</value>></command>—задаёт +<literal>--error-log-path=<value>путь</value></literal>—задаёт имя основного файла ошибок, предупреждений и диагностики. После установки имя файла можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="error_log"/>. По умолчанию имя -файла—<command><<value>prefix</value>>/logs/error.log</command>. +файла—<path><value>префикс</value>/logs/error.log</path>. </para> </listitem> <listitem> <para> -<command>--http-log-path=<<value>путь</value>></command>—задаёт +<literal>--http-log-path=<value>путь</value></literal>—задаёт имя основного файла регистрации запросов HTTP-сервера. После установки имя файла можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="http/ngx_http_log_module.xml" id="access_log"/>. По умолчанию имя -файла—<command><<value>prefix</value>>/logs/access.log</command>. +файла—<path><value>префикс</value>/logs/access.log</path>. </para> </listitem> <listitem> <para> -<command>--user=<<value>имя</value>></command>—задаёт +<literal>--user=<value>имя</value></literal>—задаёт имя непривилегированного пользователя, с правами которого будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="user"/>. По умолчанию имя пользователя nobody. </para> @@ -97,10 +97,10 @@ <listitem> <para> -<command>--group=<<value>имя</value>></command>—задаёт +<literal>--group=<value>имя</value></literal>—задаёт имя группы, с правами которой будут выполняться рабочие процессы. После установки это имя можно всегда поменять в конфигурационном -файле <command>nginx.conf</command> с помощью директивы +файле <path>nginx.conf</path> с помощью директивы <link doc="ngx_core_module.xml" id="user"/>. По умолчанию группа совпадает с именем непривилегированного пользователя. </para> @@ -108,8 +108,8 @@ <listitem> <para> -<command>--with-select_module</command><br/> -<command>--without-select_module</command>—разрешает или запрещает +<literal>--with-select_module</literal><br/> +<literal>--without-select_module</literal>—разрешает или запрещает сборку модуля для работы сервера с помощью метода <c-func>select</c-func>. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll, rtsig или /dev/poll. @@ -118,8 +118,8 @@ <listitem> <para> -<command>--with-poll_module</command><br/> -<command>--without-poll_module</command>—разрешает или запрещает +<literal>--with-poll_module</literal><br/> +<literal>--without-poll_module</literal>—разрешает или запрещает сборку модуля для работы сервера с помощью метода <c-func>poll</c-func>. Этот модуль собирается автоматически, если на платформе не обнаружено более подходящего метода—kqueue, epoll, rtsig или /dev/poll. @@ -128,7 +128,7 @@ <listitem> <para> -<command>--without-http_gzip_module</command>—запрещает сборку модуля +<literal>--without-http_gzip_module</literal>—запрещает сборку модуля <link doc="http/ngx_http_gzip_module.xml">сжатия ответов</link> HTTP-сервера. Для сборки и работы этого модуля нужна библиотека zlib. </para> @@ -136,7 +136,7 @@ <listitem> <para> -<command>--without-http_rewrite_module</command>—запрещает сборку модуля +<literal>--without-http_rewrite_module</literal>—запрещает сборку модуля HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать перенаправления и менять URI запросов</link>. Для сборки и работы этого модуля нужна библиотека PCRE. @@ -146,7 +146,7 @@ HTTP-сервера, позволяющего <link doc="http/ngx_http_rewrite_module.xml">делать <listitem> <para> -<command>--without-http_proxy_module</command>—запрещает сборку +<literal>--without-http_proxy_module</literal>—запрещает сборку <link doc="http/ngx_http_proxy_module.xml">проксирующего модуля</link> HTTP-сервера. <!-- @@ -157,7 +157,7 @@ HTTP-сервера. <listitem> <para> -<command>--with-http_ssl_module</command>—разрешает сборку модуля +<literal>--with-http_ssl_module</literal>—разрешает сборку модуля для работы HTTP-сервера по <link doc="http/ngx_http_ssl_module.xml">протоколу HTTPS</link>. По умолчанию модуль не собирается. @@ -167,7 +167,7 @@ HTTPS</link>. <listitem> <para> -<command>--with-pcre=<<value>путь</value>></command>—задаёт +<literal>--with-pcre=<value>путь</value></literal>—задаёт путь к исходным текстам библиотеки PCRE. Дистрибутив библиотеки (версию 4.4—6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> @@ -182,7 +182,7 @@ 4.4—6.1) нужно взять на сайте <link url="http://www.pcre.org">PCRE</link> <listitem> <para> -<command>--with-zlib=<<value>путь</value>></command>—задаёт +<literal>--with-zlib=<value>путь</value></literal>—задаёт путь к исходным текстам библиотеки zlib. Дистрибутив библиотеки (версию 1.1.3—1.2.2) нужно взять на сайте <link url="http://www.gzip.org/zlib/">zlib</link> и распаковать. @@ -194,22 +194,22 @@ 1.1.3—1.2.2) нужно взять на сайте <listitem> <para> -<command>--with-cc-opt=<<value>параметры</value>></command>—задаёт +<literal>--with-cc-opt=<value>параметры</value></literal>—задаёт дополнительные параметры, которые будут добавлены к переменной CFLAGS. При использовании системной библиотеки PCRE во FreeBSD, нужно указать -<command>--with-cc-opt="-I /usr/local/include"</command>. +<literal>--with-cc-opt="-I /usr/local/include"</literal>. Если нужно увеличить число файлов, с которыми может работать <c-func>select</c-func>, то это тоже можно задать здесь же: -<command>--with-cc-opt="-D FD_SETSIZE=2048"</command>. +<literal>--with-cc-opt="-D FD_SETSIZE=2048"</literal>. </para> </listitem> <listitem> <para> -<command>--with-ld-opt=<<value>параметры</value>></command>—задаёт +<literal>--with-ld-opt=<value>параметры</value></literal>—задаёт дополнительные параметры, которые будут использованы при линковке. При использовании системной библиотеки PCRE во FreeBSD, нужно указать -<command>--with-ld-opt="-L /usr/local/lib"</command>. +<literal>--with-ld-opt="-L /usr/local/lib"</literal>. </para> </listitem>
--- a/xml/ru/docs/ngx_core_module.xml +++ b/xml/ru/docs/ngx_core_module.xml @@ -30,7 +30,7 @@ events { <section id="directives" name="Директивы"> <directive name="daemon"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>main</context> @@ -44,15 +44,15 @@ events { <directive name="error_log"> <syntax> -<argument>файл</argument> -[<value>debug</value> | -<value>info</value> | -<value>notice</value> | -<value>warn</value> | -<value>error</value> | -<value>crit</value> | -<value>alert</value> | -<value>emerg</value>]</syntax> +<value>файл</value> +[<literal>debug</literal> | +<literal>info</literal> | +<literal>notice</literal> | +<literal>warn</literal> | +<literal>error</literal> | +<literal>crit</literal> | +<literal>alert</literal> | +<literal>emerg</literal>]</syntax> <default>logs/error.log error</default> <context>main</context> <context>http</context> @@ -64,24 +64,24 @@ events { </para> <para> -Первый аргумент задаёт файл, который будет хранить лог. +Первый параметр задаёт файл, который будет хранить лог. <!-- Если имя файла не абсолютное, к нему добавляется в начало путь префикса. --> </para> <para> -Второй аргумент определяет уровень лога. +Второй параметр определяет уровень лога. Уровни лога, указанные выше, перечислены в порядке возрастания их серьёзности. При установке определённого уровня в лог попадают все сообщения указанного и более серьёзных уровней. -Например, при стандартном уровне <value>error</value> в лог попадают -сообщения уровней <value>error</value>, <value>crit</value>, -<value>alert</value> и <value>emerg</value>. +Например, при стандартном уровне <literal>error</literal> в лог попадают +сообщения уровней <literal>error</literal>, <literal>crit</literal>, +<literal>alert</literal> и <literal>emerg</literal>. <note> -Для работы уровня лога <value>debug</value> необходимо сконфигурировать -nginx с <code>--with-debug</code>. +Для работы уровня лога <literal>debug</literal> необходимо сконфигурировать +nginx с <literal>--with-debug</literal>. </note> </para> @@ -89,7 +89,7 @@ nginx с <code>--with-debug</code>. <directive name="env"> -<syntax><argument>переменная</argument>[=<argument>значение</argument>]</syntax> +<syntax><value>переменная</value>[=<value>значение</value>]</syntax> <default>TZ</default> <context>main</context> @@ -140,12 +140,12 @@ env OPENSSL_ALLOW_PROXY_CERTS=1; <directive name="include"> -<syntax><argument>файл</argument> | <argument>маска</argument></syntax> +<syntax><value>файл</value> | <value>маска</value></syntax> <default/> <context/> <para> -Включает в конфигурацию другой <argument>файл</argument> или файлы, +Включает в конфигурацию другой <value>файл</value> или файлы, подходящие под заданную маску. Включаемые файлы должны содержать синтаксически верные директивы и блоки. </para> @@ -162,7 +162,7 @@ include vhosts/*.conf; <directive name="master_process"> -<syntax><value>on</value> | <value>off</value></syntax> +<syntax><literal>on</literal> | <literal>off</literal></syntax> <default>on</default> <context>main</context> @@ -175,19 +175,19 @@ include vhosts/*.conf; <directive name="pid"> -<syntax><argument>файл</argument></syntax> +<syntax><value>файл</value></syntax> <default>nginx.pid</default> <context>main</context> <para> -Задаёт <argument>файл</argument>, в котором хранится номер (PID) основного процесса. +Задаёт <value>файл</value>, в котором будет храниться номер (PID) основного процесса. </para> </directive> <directive name="ssl_engine"> -<syntax><argument>устройство</argument></syntax> +<syntax><value>устройство</value></syntax> <default/> <context>main</context> @@ -199,7 +199,7 @@ include vhosts/*.conf; <directive name="timer_resolution"> -<syntax><argument>интервал</argument></syntax> +<syntax><value>интервал</value></syntax> <default/> <context>main</context> @@ -209,7 +209,7 @@ include vhosts/*.conf; По умолчанию <c-func>gettimeofday</c-func> вызывается после каждой операции получения событий из ядра. C уменьшенным разрешением <c-func>gettimeofday</c-func> вызывается только -один раз за указанный <argument>интервал</argument>. +один раз за указанный <value>интервал</value>. </para> <para> @@ -224,11 +224,11 @@ timer_resolution 100ms; <list type="bullet"> <listitem> -фильтр <c-def>EVFILT_TIMER</c-def> при использовании <value>kqueue</value>; +фильтр <c-def>EVFILT_TIMER</c-def> при использовании <literal>kqueue</literal>; </listitem> <listitem> -<c-func>timer_create</c-func> при использовании <value>eventport</value>; +<c-func>timer_create</c-func> при использовании <literal>eventport</literal>; </listitem> <listitem> @@ -242,14 +242,14 @@ timer_resolution 100ms; <directive name="user"> -<syntax><argument>пользователь</argument> [<argument>группа</argument>]</syntax> +<syntax><value>пользователь</value> [<value>группа</value>]</syntax> <default>nobody nobody</default> <context>main</context> <para> Задаёт пользователя и группу, с правами которого будут работать рабочие процессы. -Если <argument>группа</argument> не задана, то используется группа, имя +Если <value>группа</value> не задана, то используется группа, имя которой совпадает с именем пользователя. </para> @@ -257,14 +257,14 @@ timer_resolution 100ms; <directive name="worker_priority"> -<syntax><argument>число</argument></syntax> +<syntax><value>число</value></syntax> <default>0</default> <context>main</context> <para> Задаёт приоритет планирования рабочих процессов подобно тому, как это делается командой <command>nice</command>: отрицательное -<argument>число</argument> +<value>число</value> означает более высокий приоритет. Диапазон возможных значений, как правило, варьируется от -20 до 20. </para> @@ -280,7 +280,7 @@ worker_priority -10; <directive name="worker_processes"> -<syntax><argument>число</argument></syntax> +<syntax><value>число</value></syntax> <default>1</default> <context>main</context> @@ -300,7 +300,7 @@ worker_priority -10; <directive name="worker_rlimit_core"> -<syntax><argument>размер</argument></syntax> +<syntax><value>размер</value></syntax> <default/> <context>main</context> @@ -314,7 +314,7 @@ worker_priority -10; <directive name="worker_rlimit_nofile"> -<syntax><argument>число</argument></syntax> +<syntax><value>число</value></syntax> <default/> <context>main</context> @@ -328,7 +328,7 @@ worker_priority -10; <directive name="working_directory"> -<syntax><argument>каталог</argument></syntax> +<syntax><value>каталог</value></syntax> <default/> <context>main</context>
--- a/xml/ru/docs/switches.xml +++ b/xml/ru/docs/switches.xml @@ -11,13 +11,13 @@ nginx поддерживает следующие параметры: <list> <listitem> -<command>-c <<value>файл</value>></command>—указывает -использовать конфигурационный файл <<value>файл</value>> вместо файла +<literal>-c <value>файл</value></literal>—указывает +использовать конфигурационный файл <value>файл</value> вместо файла по умолчанию. </listitem> <listitem> -<command>-g</command>—задаёт глобальные директивы конфигурации, +<literal>-g</literal>—задаёт глобальные директивы конфигурации, например, <programlisting> nginx -g "pid /var/run/nginx.pid; worker_processes `sysctl -n hw.ncpu`;" @@ -25,17 +25,17 @@ nginx -g "pid /var/run/nginx.pid; worker </listitem> <listitem> -<command>-t</command>—тестировать конфигурацию. nginx проверяет +<literal>-t</literal>—тестировать конфигурацию. nginx проверяет синтаксическую правильность конфигурации, а затем пытается открыть файлы, описанные в конфигурации. </listitem> <listitem> -<command>-v</command>—показать версию nginx. +<literal>-v</literal>—показать версию nginx. </listitem> <listitem> -<command>-V</command>—показать версию nginx, версию компилятора +<literal>-V</literal>—показать версию nginx, версию компилятора и параметры конфигурации сборки. </listitem>
--- a/xml/ru/download.xml +++ b/xml/ru/download.xml @@ -150,7 +150,7 @@ <item> Репозиторий Subversion, доступный только для чтения: -<code>svn://svn.nginx.org/nginx</code> +<literal>svn://svn.nginx.org/nginx</literal> </item> <item> @@ -173,7 +173,7 @@ <para> Для настройки репозитория yum для RHEL/CentOS выберите из списка -соответствующий пакет <code>nginx-release</code>: +соответствующий пакет <literal>nginx-release</literal>: <list> @@ -203,7 +203,7 @@ yum install nginx </programlisting> Кроме того, конфигурацию репозитория можно добавить вручную -без установки пакета <code>nginx-release</code>. +без установки пакета <literal>nginx-release</literal>. Создайте файл с именем <path>/etc/yum.repos.d/nginx.repo</path> и таким содержимым: @@ -215,9 +215,10 @@ gpgcheck=0 enabled=1 </programlisting> -Замените “<code>OS</code>” на “<code>rhel</code>” или <code>centos</code>, -в зависимости от используемого дистрибутива, а “<code>OSRELEASE</code>” -на “<code>5</code>” или “<code>6</code>”, +Замените “<literal>OS</literal>” на “<literal>rhel</literal>” или +“<literal>centos</literal>”, +в зависимости от используемого дистрибутива, а “<literal>OSRELEASE</literal>” +на “<literal>5</literal>” или “<literal>6</literal>”, для, соответственно, 5.x или 6.x версий. </para>
--- a/xml/tr/docs/debugging_log.xml +++ b/xml/tr/docs/debugging_log.xml @@ -13,13 +13,13 @@ Hata ayıklama kayıt işlemini olanaklı kılmak için, nginxi debug komutu ile yapılandırmalısınız: ./configure --with-debug ... </programlisting> -ve daha sonra <dirname>error_log</dirname> ile <dirname>debug</dirname> dizin yolunu belirtin: +ve daha sonra <literal>error_log</literal> ile <literal>debug</literal> dizin yolunu belirtin: <programlisting> error_log /path/to/log debug; </programlisting> -nginx/Windows binary versiyonu, varsayılan olarak hata ayıklama kayıt desteği ile gelir. Bu yüzden yalnızca <dirname>debug</dirname> dizin yolunu belirtmek yeterlidir. +nginx/Windows binary versiyonu, varsayılan olarak hata ayıklama kayıt desteği ile gelir. Bu yüzden yalnızca <literal>debug</literal> dizin yolunu belirtmek yeterlidir. </para> <para> @@ -32,7 +32,7 @@ http { error_log /path/to/log; ... </programlisting> -Ya bu sunucudaki kaydı yorum ifadesi ile kapatmalı ya da <dirname>debug</dirname> etiketini (flag) buraya da eklemelisiniz: +Ya bu sunucudaki kaydı yorum ifadesi ile kapatmalı ya da <literal>debug</literal> etiketini (flag) buraya da eklemelisiniz: <programlisting> error_log /path/to/log debug;
--- a/xml/tr/docs/http/configuring_https_servers.xml +++ b/xml/tr/docs/http/configuring_https_servers.xml @@ -35,7 +35,7 @@ Bu durumda dosya erişimi kısıtlanmalıdır. Aynı dosyada yer alsalar da istemciye sadece sertifika gönderilir. </para> <para> -<dirname>ssl_protocols</dirname> ve <dirname>ssl_ciphers</dirname> yönergeleri, güçlü SSL protokol ve şifrelere (cipher) yapılan bağlantılara limit koymak için kullanılır. Versiyon 0.8.20 ile birlikte nginx, <dirname>ssl_protocols SSLv3 TLSv1</dirname> ve <dirname>ssl_ciphers HIGH:!ADH:!MD5</dirname> yönergelerini varsayılan olarak kullanır, bu nedenle sadece daha önceki versiyonlarda yapılandırmaya eklenmelidir. +<literal>ssl_protocols</literal> ve <literal>ssl_ciphers</literal> yönergeleri, güçlü SSL protokol ve şifrelere (cipher) yapılan bağlantılara limit koymak için kullanılır. Versiyon 0.8.20 ile birlikte nginx, <literal>ssl_protocols SSLv3 TLSv1</literal> ve <literal>ssl_ciphers HIGH:!ADH:!MD5</literal> yönergelerini varsayılan olarak kullanır, bu nedenle sadece daha önceki versiyonlarda yapılandırmaya eklenmelidir. </para> </section> @@ -46,7 +46,7 @@ Bu durumda dosya erişimi kısıtlanmalıdır. Aynı dosyada yer alsalar da istemciye sadece sertifika gönderilir. <para> SSL işlemleri ekstra işlemci (CPU) kaynakları tüketir. Çok-işlemcili sistemlerde birçok işçi işlemler yürütmelisiniz: Mevcut işlemci çekirdek sayısından az olmamalı. En yoğun işlemci-yoğun işlem SSL el sıkışmalarıdır (ÇN: SSL Handshake, kısaca sunucuda bulunan sertifikanın istemci bilgisayar tarafından onaylanması ve tekrar sunucuya bildirilmesi sürecidir). Her bir istemci için mevcut bu işlemlerin sayısını azaltmanın iki yolu vardır: İlki, keep-alive bağlantıları olanaklı kılarak bir çok talebi sadece bir bağlantı ile göndermek ve ikincisi ise SSL oturum parametrelerini tekrar kullanarak paralel ve izleyen (subsequent) bağlantılar için SSL el sıkışmalarından kaçınmaktır. -Oturumlar, bir <dirname>ssl_session_cache</dirname> yönergesi tarafından yapılandırılan ve işçiler arasında paylaştırılmış bir SSL oturum önbelleğinde yer alır. Bir megabyte önbellek yaklaşık 4000 oturum içerir. Varsayılan önbellek zaman aşımı 5 dakikadır. <dirname>ssl_session_timeout</dirname> yönergesi ile bu süre arttırılabilir. 10M paylaşımlı oturum önbelleğine sahip bir quad core sistem için örnek yapılandırma: +Oturumlar, bir <literal>ssl_session_cache</literal> yönergesi tarafından yapılandırılan ve işçiler arasında paylaştırılmış bir SSL oturum önbelleğinde yer alır. Bir megabyte önbellek yaklaşık 4000 oturum içerir. Varsayılan önbellek zaman aşımı 5 dakikadır. <literal>ssl_session_timeout</literal> yönergesi ile bu süre arttırılabilir. 10M paylaşımlı oturum önbelleğine sahip bir quad core sistem için örnek yapılandırma: <programlisting> <b>worker_processes 4</b>; @@ -81,7 +81,7 @@ Bazı tarayıcılar popüler bir sertifika otoritesi tarafından imzalanmış sertifikaları sorunsuz kabul ederken, diğerleri sorun çıkarabilir. Bunun nedeni sertifika otoritesinin, sunucu sertifikasını, güvenilir sertifika veri tabanında yer almayan aracı bir sertifikayı kullanarak imzalamış olmasıdır. Bu durumda otorite, imzalanmış sertifikaya art arda bağlanması gereken bir dizi sertifika zinciri sunar. Bir araya geldikleri dosyada ilk önce sunucu sertifikası daha sonra zincirlenmiş sertifikalar yer almalıdır: $ cat www.nginx.com.crt bundle.crt > www.nginx.com.chained.crt </programlisting> -Oluşan dosya <dirname>ssl_certificate</dirname> yönergesi içinde kullanılmalıdır: +Oluşan dosya <literal>ssl_certificate</literal> yönergesi içinde kullanılmalıdır: <programlisting> server { @@ -147,7 +147,7 @@ Eğer sertifika dizisi eklemediyseniz, yalnızca bir sunucu sertifikası görürsünüz (server certificate #0). <section id="single_http_https_server" name="Tekil HTTP/HTTPS sunucusu"> <para> -En baştan HTTP ve HTTPS protokollerini ayrı yapılandırmak en iyisidir. Mevcut durumda fonksiyonellikleri aynı gözükmekle birlikte, bu gelecekte önemli bir şekilde değişebilir ve birleştirilmiş bir sunucu problemli olabilir. Ancak, eğer HTTP ve HTTPS sunucuları eşit ise ve geleceği düşünmek istemiyorsanız, <dirname>ssl on</dirname> yönergesini silerek ve *:443 portu için <dirname>ssl</dirname> parametresi ekleyerek, HTTP ve HTTPS taleplerini tutan yalnızca bir sunucu yapılandırabilirsiniz: +En baştan HTTP ve HTTPS protokollerini ayrı yapılandırmak en iyisidir. Mevcut durumda fonksiyonellikleri aynı gözükmekle birlikte, bu gelecekte önemli bir şekilde değişebilir ve birleştirilmiş bir sunucu problemli olabilir. Ancak, eğer HTTP ve HTTPS sunucuları eşit ise ve geleceği düşünmek istemiyorsanız, <literal>ssl on</literal> yönergesini silerek ve *:443 portu için <literal>ssl</literal> parametresi ekleyerek, HTTP ve HTTPS taleplerini tutan yalnızca bir sunucu yapılandırabilirsiniz: <programlisting> server { @@ -161,7 +161,7 @@ server { </programlisting> <note> -Versiyon 0.8.21 öncesi, nginx yalnızca <dirname>default</dirname> parametresine sahip listen soketlerinde <dirname>ssl</dirname> parametresinin eklenmesine izin veriyordu: +Versiyon 0.8.21 öncesi, nginx yalnızca <literal>default</literal> parametresine sahip listen soketlerinde <literal>ssl</literal> parametresinin eklenmesine izin veriyordu: <programlisting> listen 443 default ssl; </programlisting> @@ -321,7 +321,7 @@ Versiyon 0.8.21 ve 0.7.62 ile birlikte SNI destek statüsü “-V” anahtarı ile birlikte görüntülenmeye başlandı. </item> <item> -Versiyon 0.7.14 ile birlikte <dirname>listen</dirname> yönergesinin <dirname>ssl</dirname> parametresi desteklenmeye başlandı. +Versiyon 0.7.14 ile birlikte <literal>listen</literal> yönergesinin <literal>ssl</literal> parametresi desteklenmeye başlandı. </item> <item> @@ -354,17 +354,17 @@ Versiyon 0.7.64, 0.8.18 ve öncesi varsayılan SSL protokolleri: SSLv2, SSLv3 ve TLSv1. <item> Versiyon 0.7.65, 0.8.20 ve sonrası varsayılan SSL şifreleri (cipher): -<dirname>HIGH:!ADH:!MD5</dirname>. +<literal>HIGH:!ADH:!MD5</literal>. </item> <item> Versiyon 0.8.19: varsayılan SSL şifreleri: -<dirname>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM</dirname>. +<literal>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM</literal>. </item> <item> Versiyon 0.7.64, 0.8.18 ve öncesi varsayılan SSL şifreleri:<br/> -<dirname>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP</dirname>. +<literal>ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP</literal>. </item> </list>
--- a/xml/tr/docs/http/request_processing.xml +++ b/xml/tr/docs/http/request_processing.xml @@ -37,7 +37,7 @@ server { Bu yapılandırmada, nginx yalnızca talebin header bilgisinde bulunan “Host” datasını kullanarak hangi sunucunun cevap vereceğini belirliyor. Eğer “Host” datası boş ise veya herhangi bir sunucu adı ile eşleşmez ise nginx talebi varsayılan sunucuya yönlendirir. Yukarıdaki örnekte varsayılan sunucu ilk server ifadesi kabul edilir. -Eğer ilk server ifadesinin varsayılan olmasını istemiyorsanız, <dirname>listen</dirname> yönergesinde <dirname>default_server</dirname> parametresini kullanabilirsiniz: +Eğer ilk server ifadesinin varsayılan olmasını istemiyorsanız, <literal>listen</literal> yönergesinde <literal>default_server</literal> parametresini kullanabilirsiniz: <programlisting> server { @@ -48,8 +48,8 @@ server { </programlisting> <note> -<dirname>default_server</dirname> parametresi, versiyon 0.8.21 ile birlikte kullanılmaya başlanmıştır. -Önceki versiyonlarda <dirname>default</dirname> parametresi kullanılmalıdır. +<literal>default_server</literal> parametresi, versiyon 0.8.21 ile birlikte kullanılmaya başlanmıştır. +Önceki versiyonlarda <literal>default</literal> parametresi kullanılmalıdır. </note> Not: Varsayılan sunucu, sunucu adının değil listen portunun bir özelliğidir. Daha sonra bu konuya değinilecek. @@ -104,7 +104,7 @@ server { } </programlisting> -Bu yapılandırmada, nginx <dirname>server</dirname> bloklarında yer alan <dirname>listen</dirname> yönergelerini ilk olarak IP adresi ve port üzerinde test eder. Daha sonra, gelen taleplerin header bilgisinde yer alan “Host” datasını, IP ve port ile eşleşen <dirname>server</dirname> bloklarında yer alan <dirname>server_name</dirname> girdileri ile kontrol eder. +Bu yapılandırmada, nginx <literal>server</literal> bloklarında yer alan <literal>listen</literal> yönergelerini ilk olarak IP adresi ve port üzerinde test eder. Daha sonra, gelen taleplerin header bilgisinde yer alan “Host” datasını, IP ve port ile eşleşen <literal>server</literal> bloklarında yer alan <literal>server_name</literal> girdileri ile kontrol eder. Eğer sunucu bulunamazsa varsayılan sunucu tarafından işlenir. Örneğin, <url>www.nginx.com</url> için 192.168.1.1:80 adres ve portuna gelen bir talep, eğer bu adres ve port için <url>www.nginx.com</url> tanımlanmamışsa, 192.168.1.1:80’e ait varsayılan sunucu tarafından işlenir. </para> @@ -192,25 +192,25 @@ Yukarıdaki yapılandırmada taleplerin nasıl işlendiğini inceleyelim: <item> <para> -Bir <path>/logo.gif</path> talebi, ilk olarak <dirname>/</dirname> literal lokasyonu, daha sonra, <dirname>\.(gif|jpg|png)$</dirname> düzenli ifadesi tarafından eşleştirilir. Bu sonraki (latter) lokasyon tarafından tutulur. <dirname>root /data/www</dirname> yönergesi kullanılarak, talep <path>/data/www/logo.gif</path> dosyasına eşlemlenir (mapped to) ve dosya istemciye gönderilir. +Bir <path>/logo.gif</path> talebi, ilk olarak <literal>/</literal> literal lokasyonu, daha sonra, <literal>\.(gif|jpg|png)$</literal> düzenli ifadesi tarafından eşleştirilir. Bu sonraki (latter) lokasyon tarafından tutulur. <literal>root /data/www</literal> yönergesi kullanılarak, talep <path>/data/www/logo.gif</path> dosyasına eşlemlenir (mapped to) ve dosya istemciye gönderilir. </para> </item> <item> <para> -Bir <path>/index.php</path> talebi de ilk olarak <dirname>/</dirname> literal lokasyonu, sonra, <dirname>\.(php)$</dirname> düzenli ifadesi tarafından eşleştirilir. Bu nedenle sonraki lokasyon tarafından tutulur ve localhost:9000’in dinlendiği bir FastCGI sunucusuna iletilir. <dirname>fastcgi_param</dirname> yönergesi, SCRIPT_FILENAME FastCGI parametresini <path>/data/www/index.php</path> adresine yerleştirir ve FastCGI sunucusu dosyayı yürütür. $document_root değişkeni <dirname>root</dirname> yönergesinin değerine, $fastcgi_script_name değişkeni ise talebin URI değerine eşittir. Örneğin <path>/index.php</path>. +Bir <path>/index.php</path> talebi de ilk olarak <literal>/</literal> literal lokasyonu, sonra, <literal>\.(php)$</literal> düzenli ifadesi tarafından eşleştirilir. Bu nedenle sonraki lokasyon tarafından tutulur ve localhost:9000’in dinlendiği bir FastCGI sunucusuna iletilir. <literal>fastcgi_param</literal> yönergesi, SCRIPT_FILENAME FastCGI parametresini <path>/data/www/index.php</path> adresine yerleştirir ve FastCGI sunucusu dosyayı yürütür. $document_root değişkeni <literal>root</literal> yönergesinin değerine, $fastcgi_script_name değişkeni ise talebin URI değerine eşittir. Örneğin <path>/index.php</path>. </para> </item> <item> <para> -Bir <path>/about.html</path> talebi yalnızca <dirname>/</dirname> literal lokasyonu tarafından eşleştirilir ve bu yüzden, bu lokasyon tarafından tutulur. <dirname>root /data/www</dirname> yönergesi kullanılarak talep, <path>/data/www/about.html</path> dosyasına eşlemlenir ve istemciye gönderilir. +Bir <path>/about.html</path> talebi yalnızca <literal>/</literal> literal lokasyonu tarafından eşleştirilir ve bu yüzden, bu lokasyon tarafından tutulur. <literal>root /data/www</literal> yönergesi kullanılarak talep, <path>/data/www/about.html</path> dosyasına eşlemlenir ve istemciye gönderilir. </para> </item> <item> <para> -Bir <path>/</path> talebini tutmak daha karmaşıktır. Sadece <dirname>/</dirname> literal lokasyonu tarafından eşleştirilir ve bu yüzden bu lokasyon tarafından tutulur. Sonra <dirname>index</dirname> yönergesi parametrelerine ve <dirname>root /data/www</dirname> yönergesine göre bir index dosyası olup olmadığını kontrol eder. Eğer bir <path>/data/www/index.php</path> dosyası mevcut ise yönerge, <path>/index.php</path> adresine dahili bir yönlendirme yapar ve eğer talep bir istemci tarafından gönderilmiş ise nginx, lokasyonları tekrar arar. Daha önce gördüğümüz gibi, yönlendirilmiş talep en son olarak FastCGI sunucusu tarafından tutulur. +Bir <path>/</path> talebini tutmak daha karmaşıktır. Sadece <literal>/</literal> literal lokasyonu tarafından eşleştirilir ve bu yüzden bu lokasyon tarafından tutulur. Sonra <literal>index</literal> yönergesi parametrelerine ve <literal>root /data/www</literal> yönergesine göre bir index dosyası olup olmadığını kontrol eder. Eğer bir <path>/data/www/index.php</path> dosyası mevcut ise yönerge, <path>/index.php</path> adresine dahili bir yönlendirme yapar ve eğer talep bir istemci tarafından gönderilmiş ise nginx, lokasyonları tekrar arar. Daha önce gördüğümüz gibi, yönlendirilmiş talep en son olarak FastCGI sunucusu tarafından tutulur. </para> </item>
--- a/xml/tr/docs/http/server_names.xml +++ b/xml/tr/docs/http/server_names.xml @@ -9,7 +9,7 @@ <section> <para> -Sunucu adları <dirname>server_name</dirname> yönergesi kullanılarak tanımlanırlar ve gelen bir talep için hangi server bloğunun kullanılacağını belirlerler. Ayrıca bakınız “<a href="/tr/docs/http/request_processing.xml" />”. Gerçek, wildcard veya düzenli ifadeler şeklinde tanımlanabilirler. +Sunucu adları <literal>server_name</literal> yönergesi kullanılarak tanımlanırlar ve gelen bir talep için hangi server bloğunun kullanılacağını belirlerler. Ayrıca bakınız “<a href="/tr/docs/http/request_processing.xml" />”. Gerçek, wildcard veya düzenli ifadeler şeklinde tanımlanabilirler. <programlisting> server { @@ -68,11 +68,11 @@ ve düzenli ifadeler (regular expressions). name="Wildcard adlar"> <para> -Bir wildcard ad ancak başlangıçta veya bitişte * ifadesini içerir ve nokta ile sınırlandırılır. <dirname>www.*.nginx.org</dirname> ve <dirname>w*.nginx.org</dirname> adları geçersizdir. Ancak bu adlar düzenli ifadeler ile geçerli hale getirilebilir, örneğin, <dirname>~^www\..+\.nginx\.org$</dirname> ve <dirname>~^w.*\.nginx\.org$</dirname>. Buradaki * bir çok eşleşmeyi tanımlayabilir. <dirname>*.nginx.org</dirname> ifadesi <url>www.nginx.org</url> ve <url>www.sub.nginx.org</url> adlarına karşılık gelebilir. +Bir wildcard ad ancak başlangıçta veya bitişte * ifadesini içerir ve nokta ile sınırlandırılır. <literal>www.*.nginx.org</literal> ve <literal>w*.nginx.org</literal> adları geçersizdir. Ancak bu adlar düzenli ifadeler ile geçerli hale getirilebilir, örneğin, <literal>~^www\..+\.nginx\.org$</literal> ve <literal>~^w.*\.nginx\.org$</literal>. Buradaki * bir çok eşleşmeyi tanımlayabilir. <literal>*.nginx.org</literal> ifadesi <url>www.nginx.org</url> ve <url>www.sub.nginx.org</url> adlarına karşılık gelebilir. </para> <para> -<dirname>.nginx.org</dirname> şeklindeki bir wildcard <dirname>nginx.org</dirname> gerçek adı ile <dirname>*.nginx.org</dirname> wildcard adına karşılık gelir. +<literal>.nginx.org</literal> şeklindeki bir wildcard <literal>nginx.org</literal> gerçek adı ile <literal>*.nginx.org</literal> wildcard adına karşılık gelir. </para> </section> @@ -122,17 +122,17 @@ PCRE kütüphanesi ile ad yakalama işlemi de şu şekildedir: <table note="yes"> <tr> -<td><code>?<<i>name</i>></code></td> +<td><literal>?<<value>name</value>></literal></td> <td>Perl 5.10 uyumlu sentaks, PCRE-7.0 ile gelmiştir.</td> </tr> <tr> -<td><code>?'<i>name</i>'</code></td> +<td><literal>?'<value>name</value>'</literal></td> <td>Perl 5.10 uyumlu sentaks, PCRE-7.0 ile gelmiştir.</td> </tr> <tr> -<td><code>?P<<i>name</i>></code></td> +<td><literal>?P<<value>name</value>></literal></td> <td>Python uyumlu sentaks, PCRE-4.0 ile gelmiştir.</td> </tr> @@ -144,7 +144,7 @@ Eğer nginx aşağıdaki hatayı verirse: pcre_compile() failed: unrecognized character after (?< in ... </programlisting> -bu PCRE kütüphanesini eski olduğu ve <dirname>?P<<i>name</i>></dirname> şeklinde kullanmanız gerektiği anlamına gelir. +bu PCRE kütüphanesini eski olduğu ve <literal>?P<<value>name</value>></literal> şeklinde kullanmanız gerektiği anlamına gelir. Yakalama ayrıca dijital formda da olabilir: <programlisting> @@ -168,7 +168,7 @@ Ancak, dijital referanslar kolaylıkla üstüne yazılabilir olduğundan, bu şekilde kullanım basit durumlar için sınırlandırılmalıdır (yukarıdaki gibi). name="Diğer muhtelif adlar"> <para> -Eğer server bloğu içerisinde bir <dirname>server_name</dirname> tanımlanmamışsa nginx, sunucu adı olarak <i>hostname</i> ifadesini kullanır. +Eğer server bloğu içerisinde bir <literal>server_name</literal> tanımlanmamışsa nginx, sunucu adı olarak <i>hostname</i> ifadesini kullanır. </para> <para> @@ -216,10 +216,10 @@ Ayrıca “--”, “!@#” ve benzeri ifadeler de kullanabilirsiniz. <para> nginx, 0.6.25 versiyonuna kadar, bir catch-all adı olmak için hatalı bir şekilde yorumlanan “*” özel adını destekliyordu. -Fakat bu bir catch-all veya wildcard sunucu adı olarak fonksiyonel değil. Bunun yerine, <dirname>server_name_in_redirect</dirname> yönergesini kullanarak fonksiyonelliği sağlamaya başladık. -“*” özel karakteri artık desteklenmiyor, bu yüzden <dirname>server_name_in_redirect</dirname> yönergesi kullanılmalıdır. -Not: <dirname>server_name</dirname> yönergesini kullanan varsayılan sunucuyu veya catch-all adını belirtmenin bir yolu bulunmuyor. -Bu, <dirname>server_name</dirname> yönergesinin değil, <dirname>listen</dirname> yönergesinin bir özelliğidir. +Fakat bu bir catch-all veya wildcard sunucu adı olarak fonksiyonel değil. Bunun yerine, <literal>server_name_in_redirect</literal> yönergesini kullanarak fonksiyonelliği sağlamaya başladık. +“*” özel karakteri artık desteklenmiyor, bu yüzden <literal>server_name_in_redirect</literal> yönergesi kullanılmalıdır. +Not: <literal>server_name</literal> yönergesini kullanan varsayılan sunucuyu veya catch-all adını belirtmenin bir yolu bulunmuyor. +Bu, <literal>server_name</literal> yönergesinin değil, <literal>listen</literal> yönergesinin bir özelliğidir. Ayrıca bakınız “<a href="/tr/docs/http/request_processing.xml" />”. *:80 ve *:8080 portlarını dinleyen sunucular tanımlayabilir ve birini *:8080 portu için varsayılan olarak belirlerken, diğerini de *:80 için varsayılan olarak belirleyebilirsiniz: @@ -248,7 +248,7 @@ server { name="Optimizasyon"> <para> -Gerçek ve wildcard adlar çırpılarda (hash) depolanır. Çırpılar listen portlarına bağlıdırlar ve her bir listen port 3 farklı çırpıya sahip olabilir: gerçek ad çırpısı, * ile başlayan bir wildcard adı çırpısı ve * ile biten bir wildcard adı çırpısı. Çırpıların boyutu yapılandırma aşamasında optimize edilir ve böylece bir ad en az önbellek kayıpları ile bulundurulur. İlk olarak gerçek ad çırpısı aranır. Gerçek ad çırpısı kullanan bir ad bulunmaz ise, * ile başlayan wildcard ad çırpısı aranır. Bu da bulunmaz ise, * ile biten wildcard ad çırpısı aranır. Adların alanadı parçaları ile aranması nedeniyle wildcard ad çırpıları araması, gerçek ad çırpı aramasına oranla daha yavaştır. Not: Özel <dirname>.nginx.org</dirname> wildcard formu, gerçek ad çırpısında değil, wildcard ad çırpısında saklanır. Düzenli İfadeler sırayla test edildiğinden bu en yavaş ve ölçeklenebilir olmayan yöntemdir. +Gerçek ve wildcard adlar çırpılarda (hash) depolanır. Çırpılar listen portlarına bağlıdırlar ve her bir listen port 3 farklı çırpıya sahip olabilir: gerçek ad çırpısı, * ile başlayan bir wildcard adı çırpısı ve * ile biten bir wildcard adı çırpısı. Çırpıların boyutu yapılandırma aşamasında optimize edilir ve böylece bir ad en az önbellek kayıpları ile bulundurulur. İlk olarak gerçek ad çırpısı aranır. Gerçek ad çırpısı kullanan bir ad bulunmaz ise, * ile başlayan wildcard ad çırpısı aranır. Bu da bulunmaz ise, * ile biten wildcard ad çırpısı aranır. Adların alanadı parçaları ile aranması nedeniyle wildcard ad çırpıları araması, gerçek ad çırpı aramasına oranla daha yavaştır. Not: Özel <literal>.nginx.org</literal> wildcard formu, gerçek ad çırpısında değil, wildcard ad çırpısında saklanır. Düzenli İfadeler sırayla test edildiğinden bu en yavaş ve ölçeklenebilir olmayan yöntemdir. </para> <para> @@ -274,8 +274,8 @@ server { </para> <para> -Eğer çok miktarda veya olağandışı şekilde uzun sunucu adları tanımladıysanız, <i>http</i> düzeyinde <dirname>server_names_hash_max_size</dirname> -ve <dirname>server_names_hash_bucket_size</dirname> yönergelerini tekrar ayarlamalısınız. <dirname>server_names_hash_bucket_size</dirname> yönergesinin varsayılan değeri CPU önbellek satır boyutuna göre 32, 64 veya başka bir rakam olabilir. Eğer bu değer 32 ise ve “cok.uzun.sunucu.adi.nginx.org” ifadesini sunucu adı olarak belirlerseniz nginx, başlamayacak ve aşağıdaki hatayı verecektir: +Eğer çok miktarda veya olağandışı şekilde uzun sunucu adları tanımladıysanız, <i>http</i> düzeyinde <literal>server_names_hash_max_size</literal> +ve <literal>server_names_hash_bucket_size</literal> yönergelerini tekrar ayarlamalısınız. <literal>server_names_hash_bucket_size</literal> yönergesinin varsayılan değeri CPU önbellek satır boyutuna göre 32, 64 veya başka bir rakam olabilir. Eğer bu değer 32 ise ve “cok.uzun.sunucu.adi.nginx.org” ifadesini sunucu adı olarak belirlerseniz nginx, başlamayacak ve aşağıdaki hatayı verecektir: <programlisting> could not build the server_names_hash, @@ -298,11 +298,11 @@ you should increase either server_names_ or server_names_hash_bucket_size: 32 </programlisting> -Bu durumda ilk olarak <dirname>server_names_hash_max_size</dirname> değerini sunucu ad sayısına yakın bir değeri yükseltin. Eğer bu da yardımcı sorunu çözmez ise veya nginx başlama süresi çok uzar ise <dirname>server_names_hash_bucket_size</dirname> değerini arttırın. +Bu durumda ilk olarak <literal>server_names_hash_max_size</literal> değerini sunucu ad sayısına yakın bir değeri yükseltin. Eğer bu da yardımcı sorunu çözmez ise veya nginx başlama süresi çok uzar ise <literal>server_names_hash_bucket_size</literal> değerini arttırın. </para> <para> -Eğer bir sunucu sadece bir listen port için ise, nginx sunucu adlarını test etmeyecek ve listen port için çırpılar yaratmayacaktır. Fakat bu durumun bir istisnası var; eğer <dirname>server_name</dirname> tutuklar (capture) içeren bir düzenli ifade ise nginx, bu tutukları almak için ifadeyi yürütmek zorundadır. +Eğer bir sunucu sadece bir listen port için ise, nginx sunucu adlarını test etmeyecek ve listen port için çırpılar yaratmayacaktır. Fakat bu durumun bir istisnası var; eğer <literal>server_name</literal> tutuklar (capture) içeren bir düzenli ifade ise nginx, bu tutukları almak için ifadeyi yürütmek zorundadır. </para> </section>
--- a/xsls/content.xsls +++ b/xsls/content.xsls @@ -116,8 +116,7 @@ X:stylesheet { X:text disable-output-escaping="yes" {<p> } } - X:template = "argument" { <code><i> !!; </i></code> } - X:template = "parameter" { <code> !!; </code> } + X:template = "literal" { <code> !!; </code> } X:template = "header" { X:text {“} !!; X:text {”} @@ -127,30 +126,19 @@ X:stylesheet { !{@code} X:text { (} !{@text} X:text{)} } - X:template = "dirname[/*[@lang='he']]" { - <nobr><span class="ltr"> - X:text {“} !!; X:text {”} - </span></nobr> - } - - X:template = "dirname" { - <nobr> X:text {“} !!; X:text {”} </nobr> - } - X:template = "url[/*[@lang='he']]" { <i><span class="ltr"> !!; </span></i> } X:template = "url" { <i> !!;</i> } - X:template = "value" { <code> !!; </code> } + X:template = "value" { <code><i> !!; </i></code> } X:template = "registered" { !!; <sup> X:text {®} </sup> } X:template = "var" { <code> !!; </code> } X:template = "path" { <code> !!; </code> } - X:template = "code" { <code> !!; </code> } X:template = "i" { <i> !!; </i> } X:template = "b" { <b> !!; </b> } X:template = "nobr" { <nobr> !!; </nobr> }