Mercurial > hg > nginx-site

comparison xml/en/docs/http/ngx_http_map_module.xml @ 966:95c3c3bbf1ce

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Text review.
author Egor Nikitin <yegor.nikitin@gmail.com>
date Wed, 14 Aug 2013 12:03:41 +0400
parents 81ec181c084e
children 68b647a96448
comparison
equal deleted inserted replaced
965:fadccc156188 966:95c3c3bbf1ce
68 </note> 68 </note>
69 </para> 69 </para>
70 70
71 <para> 71 <para>
72 <note> 72 <note>
73 Since variables are evaluated only when used, the mere existence 73 Since variables are evaluated only when they are used, the mere declaration
74 of even a large number of declared “<literal>map</literal>” variables 74 even of a large number of “<literal>map</literal>” variables
75 does not incur any extra costs for request processing. 75 does not add any extra costs to request processing.
76 </note> 76 </note>
77 </para> 77 </para>
78 78
79 <para> 79 <para>
80 Parameters inside the <literal>map</literal> block specify a mapping 80 Parameters inside the <literal>map</literal> block specify a mapping
115 resulting value will be an empty string. 115 resulting value will be an empty string.
116 </tag-desc> 116 </tag-desc>
117 117
118 <tag-name><literal>hostnames</literal></tag-name> 118 <tag-name><literal>hostnames</literal></tag-name>
119 <tag-desc> 119 <tag-desc>
120 allows to specify hostnames with a prefix or suffix mask, as source 120 indicates that source values can be hostnames with a prefix or suffix mask:
121 values, for example,
122 <example> 121 <example>
123 *.example.com 1; 122 *.example.com 1;
124 example.* 1; 123 example.* 1;
125 </example> 124 </example>
126 The following two records 125 The following two records
144 </list> 143 </list>
145 </para> 144 </para>
146 145
147 <para> 146 <para>
148 If the source value matches more than one of the specified variants, 147 If the source value matches more than one of the specified variants,
149 e.g. both mask and regular expression match, the first matching 148 e.g. both a mask and a regular expression match, the first matching
150 variant will be chosen, in the following order of precedence: 149 variant will be chosen, in the following order of priority:
151 <list type="enum"> 150 <list type="enum">
152 151
153 <listitem> 152 <listitem>
154 string value without a mask 153 string value without a mask
155 </listitem> 154 </listitem>
184 <default>32|64|128</default> 183 <default>32|64|128</default>
185 <context>http</context> 184 <context>http</context>
186 185
187 <para> 186 <para>
188 Sets the bucket size for the <link id="map"/> variables hash tables. 187 Sets the bucket size for the <link id="map"/> variables hash tables.
189 Default value depends on the size of the processor’s cache line. 188 Default value depends on the processor’s cache line size.
190 Details of setting up hash tables are provided in a separate 189 The details of setting up hash tables are provided in a separate
191 <link doc="../hash.xml">document</link>. 190 <link doc="../hash.xml">document</link>.
192 </para> 191 </para>
193 192
194 </directive> 193 </directive>
195 194
200 <context>http</context> 199 <context>http</context>
201 200
202 <para> 201 <para>
203 Sets the maximum <value>size</value> of the <link id="map"/> variables 202 Sets the maximum <value>size</value> of the <link id="map"/> variables
204 hash tables. 203 hash tables.
205 Details of setting up hash tables are provided in a separate 204 The details of setting up hash tables are provided in a separate
206 <link doc="../hash.xml">document</link>. 205 <link doc="../hash.xml">document</link>.
207 </para> 206 </para>
208 207
209 </directive> 208 </directive>
210 209