annotate xml/en/docs/http/ngx_http_dav_module.xml @ 2769:16f6fa718be2

Updated TLSv1.3 support notes. Previous notes described some early development snapshot of OpenSSL 1.1.1 with disabled TLSv1.3 by default. It was then enabled in the first alpha. Further, the updated text covers later major releases such as OpenSSL 3.0.
author Sergey Kandaurov <pluknet@nginx.com>
date Thu, 30 Sep 2021 16:29:20 +0300
parents ca7568f67dee
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
1 <?xml version="1.0"?>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
2
580
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
3 <!--
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
4 Copyright (C) Igor Sysoev
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
5 Copyright (C) Nginx, Inc.
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
6 -->
be54c443235a Added copyright markers to documentation sources.
Ruslan Ermilov <ru@nginx.com>
parents: 371
diff changeset
7
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
8 <!DOCTYPE module SYSTEM "../../../../dtd/module.dtd">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
9
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
10 <module name="Module ngx_http_dav_module"
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
11 link="/en/docs/http/ngx_http_dav_module.html"
589
764fbac1b8b4 Added document revision.
Ruslan Ermilov <ru@nginx.com>
parents: 580
diff changeset
12 lang="en"
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
13 rev="2">
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
14
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
15 <section id="summary">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
16
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
17 <para>
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
18 The <literal>ngx_http_dav_module</literal> module is intended for file
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
19 management automation via the WebDAV protocol.
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
20 The module processes HTTP and WebDAV
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
21 methods PUT, DELETE, MKCOL, COPY, and MOVE.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
22 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
23
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
24 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
25 This module is not built by default, it should be enabled with the
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
26 <literal>--with-http_dav_module</literal>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
27 configuration parameter.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
28 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
29
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
30 <para>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
31 <note>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
32 WebDAV clients that require additional WebDAV methods to operate
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
33 will not work with this module.
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
34 </note>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
35 </para>
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
36
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
37 </section>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
38
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
39
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
40 <section id="example" name="Example Configuration">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
41
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
42 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
43 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
44 location / {
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
45 root /data/www;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
46
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
47 client_body_temp_path /data/client_temp;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
48
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
49 dav_methods PUT DELETE MKCOL COPY MOVE;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
50
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
51 create_full_put_path on;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
52 dav_access group:rw all:r;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
53
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
54 limit_except GET {
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
55 allow 192.168.1.0/32;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
56 deny all;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
57 }
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
58 }
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
59 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
60 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
61
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
62 </section>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
63
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
64
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
65 <section id="directives" name="Directives">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
66
2142
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
67 <directive name="create_full_put_path">
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
68 <syntax><literal>on</literal> | <literal>off</literal></syntax>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
69 <default>off</default>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
70 <context>http</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
71 <context>server</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
72 <context>location</context>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
73
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
74 <para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
75 The WebDAV specification only allows creating files in already
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
76 existing directories.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
77 This directive allows creating all needed intermediate directories.
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
78 </para>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
79
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
80 </directive>
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
81
ca7568f67dee Sorted directives alphabetically.
Ruslan Ermilov <ru@nginx.com>
parents: 966
diff changeset
82
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
83 <directive name="dav_access">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
84 <syntax><value>users</value>:<value>permissions</value> ...</syntax>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
85 <default>user:rw</default>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
86 <context>http</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
87 <context>server</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
88 <context>location</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
89
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
90 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
91 Sets access permissions for newly created files and directories, e.g.:
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
92 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
93 dav_access user:rw group:rw all:r;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
94 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
95 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
96
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
97 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
98 If any <literal>group</literal> or <literal>all</literal> access permissions
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
99 are specified then <literal>user</literal> permissions may be omitted:
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
100 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
101 dav_access group:rw all:r;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
102 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
103 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
104
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
105 </directive>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
106
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
107
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
108 <directive name="dav_methods">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
109 <syntax>
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
110 <literal>off</literal> | <value>method</value> ...</syntax>
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
111 <default>off</default>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
112 <context>http</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
113 <context>server</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
114 <context>location</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
115
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
116 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
117 Allows the specified HTTP and WebDAV methods.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
118 The parameter <literal>off</literal> denies all methods processed
774
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
119 by this module.
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
120 The following methods are supported:
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
121 <literal>PUT</literal>, <literal>DELETE</literal>, <literal>MKCOL</literal>,
8ff309263cb9 Corrected syntax of "dav_methods" directive and updated module description.
Vladimir Homutov <vl@nginx.com>
parents: 589
diff changeset
122 <literal>COPY</literal>, and <literal>MOVE</literal>.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
123 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
124
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
125 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
126 A file uploaded with the PUT method is first written to a temporary file,
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
127 and then the file is renamed.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
128 Starting from version 0.8.9, temporary files and the persistent store
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
129 can be put on different file systems.
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
130 However, be aware that in this case a file is copied
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
131 across two file systems instead of the cheap renaming operation.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
132 It is thus recommended that for any given location both saved files and a
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
133 directory holding temporary files, set by the
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
134 <link doc="ngx_http_core_module.xml" id="client_body_temp_path"/>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
135 directive, are put on the same file system.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
136 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
137
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
138 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
139 When creating a file with the PUT method, it is possible to specify
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
140 the modification date by passing it in the <header>Date</header>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
141 header field.
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
142 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
143
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
144 </directive>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
145
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
146
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
147 <directive name="min_delete_depth">
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
148 <syntax><value>number</value></syntax>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
149 <default>0</default>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
150 <context>http</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
151 <context>server</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
152 <context>location</context>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
153
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
154 <para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
155 Allows the DELETE method to remove files provided that
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
156 the number of elements in a request path is not less than the specified
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
157 number.
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
158 For example, the directive
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
159 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
160 min_delete_depth 4;
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
161 </example>
966
95c3c3bbf1ce Text review.
Egor Nikitin <yegor.nikitin@gmail.com>
parents: 774
diff changeset
162 allows removing files on requests
371
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
163 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
164 /users/00/00/name
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
165 /users/00/00/name/pic.jpg
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
166 /users/00/00/page.html
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
167 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
168 and denies the removal of
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
169 <example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
170 /users/00/00
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
171 </example>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
172 </para>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
173
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
174 </directive>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
175
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
176 </section>
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
177
e5e7d6365612 English translation of ngx_http_dav_module.
Ruslan Ermilov <ru@nginx.com>
parents:
diff changeset
178 </module>