Mercurial > hg > nginx-site

comparison xml/en/docs/syntax.xml @ 735:e1593207d1cb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documented in more detail how time intervals are specified in nginx configuration file, and paraphrased the text about sizes.
author Ruslan Ermilov <ru@nginx.com>
date Thu, 18 Oct 2012 13:35:13 +0000
parents 67826df692cc
children 2c14a16c61eb
comparison
equal deleted inserted replaced
734:99ea52dbb4d4 735:e1593207d1cb
6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd"> 6 <!DOCTYPE article SYSTEM "../../../dtd/article.dtd">
7 7
8 <article name="Configuration file measurement units" 8 <article name="Configuration file measurement units"
9 link="/en/docs/syntax.html" 9 link="/en/docs/syntax.html"
10 lang="en" 10 lang="en"
11 rev="2"> 11 rev="3">
12 12
13 <section> 13 <section>
14 14
15 <para> 15 <para>
16 Sizes can be specified in kilobytes (<literal>k</literal>, 16 Sizes can be specified in bytes, kilobytes
17 <literal>K</literal>) and megabytes (<literal>m</literal>, 17 (suffixes <literal>k</literal> and <literal>K</literal>) or megabytes
18 <literal>M</literal>), for example “<literal>8k</literal>”, 18 (suffixes <literal>m</literal> and <literal>M</literal>), for example,
19 “<literal>1m</literal>”. 19 “<literal>1024</literal>”, “<literal>8k</literal>”, “<literal>1m</literal>”.
20 If the suffix is not specified, the value is bytes.
21 </para> 20 </para>
22 21
23 <para> 22 <para>
24 Time can be specified in minutes, hours, days and so on: 23 Time intervals can be specified in milliseconds, seconds,
24 minutes, hours, days and so on, using the following suffixes:
25 <table width="30%"> 25 <table width="30%">
26 <tr><td width="20%">ms</td><td>milliseconds</td></tr>
26 <tr><td width="20%">s</td><td>seconds</td></tr> 27 <tr><td width="20%">s</td><td>seconds</td></tr>
27 <tr><td width="20%">m</td><td>minutes</td></tr> 28 <tr><td width="20%">m</td><td>minutes</td></tr>
28 <tr><td width="20%">h</td><td>hours</td></tr> 29 <tr><td width="20%">h</td><td>hours</td></tr>
29 <tr><td width="20%">d</td><td>days</td></tr> 30 <tr><td width="20%">d</td><td>days</td></tr>
30 <tr><td width="20%">w</td><td>weeks</td></tr> 31 <tr><td width="20%">w</td><td>weeks</td></tr>
32 <tr><td width="20%">y</td><td>years, 365 days</td></tr> 33 <tr><td width="20%">y</td><td>years, 365 days</td></tr>
33 </table> 34 </table>
34 </para> 35 </para>
35 36
36 <para> 37 <para>
37 for example “<literal>1h 30m</literal>”, “<literal>1y 6M</literal>”. 38 Multiple units can be combined in a single value
38 Additionally, it is possible to specify time with millisecond 39 by specifying them in the order from the most to the least significant,
39 precision (<literal>ms</literal>) in some directives. 40 and optionally separated by whitespace.
40 If the suffix is not specified, the value is seconds. 41 For example, “<literal>1h 30m</literal>” specifies the same time
42 as “<literal>90m</literal>” or “<literal>5400s</literal>”.
43 A value without a suffix means seconds.
44 It is recommended to always specify a suffix.
45 </para>
46
47 <para>
48 Some of the time intervals can be specified only with a seconds resolution.
41 </para> 49 </para>
42 50
43 </section> 51 </section>
44 52
45 </article> 53 </article>