1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
|
<pre>Network Working Group B. Korver
Request for Comments: 4331 Network Resonance
Category: Standards Track L. Dusseault
OSAF
February 2006
<span class="h1">Quota and Size Properties</span>
<span class="h1">for Distributed Authoring and Versioning (DAV) Collections</span>
Status of This Memo
This document specifies an Internet standards track protocol for the
Internet community, and requests discussion and suggestions for
improvements. Please refer to the current edition of the "Internet
Official Protocol Standards" (STD 1) for the standardization state
and status of this protocol. Distribution of this memo is unlimited.
Copyright Notice
Copyright (C) The Internet Society (2006).
Abstract
Web Distributed Authoring and Versioning (WebDAV) servers are
frequently deployed with quota (size) limitations. This document
discusses the properties and minor behaviors needed for clients to
interoperate with quota (size) implementations on WebDAV
repositories.
Table of Contents
<a href="#section-1">1</a>. Introduction ....................................................<a href="#page-2">2</a>
<a href="#section-1.1">1.1</a>. Notational Conventions .....................................<a href="#page-2">2</a>
<a href="#section-1.2">1.2</a>. Requirement for Quotas .....................................<a href="#page-2">2</a>
<a href="#section-2">2</a>. Solution Overview ...............................................<a href="#page-3">3</a>
<a href="#section-3">3</a>. DAV:quota-available-bytes .......................................<a href="#page-3">3</a>
<a href="#section-4">4</a>. DAV:quota-used-bytes ............................................<a href="#page-4">4</a>
<a href="#section-5">5</a>. Example PROPFIND Request and Response ...........................<a href="#page-5">5</a>
<a href="#section-6">6</a>. Error Reporting .................................................<a href="#page-6">6</a>
<a href="#section-7">7</a>. Notes ...........................................................<a href="#page-6">6</a>
<a href="#section-8">8</a>. Security Considerations .........................................<a href="#page-8">8</a>
<a href="#section-9">9</a>. Internationalization Considerations .............................<a href="#page-8">8</a>
<a href="#section-10">10</a>. Acknowledgements ...............................................<a href="#page-8">8</a>
<a href="#section-11">11</a>. References .....................................................<a href="#page-8">8</a>
<a href="#section-11.1">11.1</a>. Normative References ......................................<a href="#page-8">8</a>
<a href="#section-11.2">11.2</a>. Informative References ....................................<a href="#page-8">8</a>
<span class="grey">Korver & Dusseault Standards Track [Page 1]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-2" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
<span class="h2"><a class="selflink" id="section-1" href="#section-1">1</a>. Introduction</span>
<span class="h3"><a class="selflink" id="section-1.1" href="#section-1.1">1.1</a>. Notational Conventions</span>
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
"SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
document are to be interpreted as described in [<a href="./rfc2119" title=""Key words for use in RFCs to Indicate Requirement Levels"">RFC2119</a>].
The definition of live property is provided in [<a href="./rfc2518" title=""HTTP Extensions for Distributed Authoring -- WebDAV"">RFC2518</a>]. The
definition of protected and computed properties is provided in
<a href="./rfc3253#section-1.4">[RFC3253], Section 1.4</a>.
<span class="h3"><a class="selflink" id="section-1.2" href="#section-1.2">1.2</a>. Requirement for Quotas</span>
WebDAV servers based on [<a href="./rfc2518" title=""HTTP Extensions for Distributed Authoring -- WebDAV"">RFC2518</a>] have been implemented and deployed
with quota restrictions on collections and users, so it makes sense
to standardize this functionality to improve user experience and
client interoperability.
The reasons why WebDAV servers frequently have quotas enforced are
the same reasons why any storage system comes with quotas.
o Sometimes the storage service charges according to quota.
o Sometimes the storage service is provided free, but the storage
service provider has limited storage space (e.g., university-
provided student accounts).
o Even in cases where the storage can be upgraded, the storage
managers may choose to limit quota in order to encourage users to
limit the files they store on the system and to clean up obsolete
files (e.g., IT departments within corporations).
In order to work best with repositories that support quotas, client
software should be able to determine and display the DAV:quota-
available-bytes (defined below) on collections. Further, client
software should have some way of fairly reliably determining how much
storage space is already counted towards that quota.
Support for the properties defined in this document enhances the
client experience, because the client has a chance of managing its
files to avoid running out of allocated storage space. Clients may
not be able to calculate the value as accurately on their own,
depending on how total space used is calculated by the server.
<span class="grey">Korver & Dusseault Standards Track [Page 2]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-3" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
<span class="h2"><a class="selflink" id="section-2" href="#section-2">2</a>. Solution Overview</span>
The approach to meeting the requirements and scenarios outlined above
is to define two live properties. This specification can be met on a
server by implementing both DAV:quota-available-bytes and DAV:quota-
used-bytes on collections only.
A <DAV:allprop> PROPFIND request SHOULD NOT return any of the
properties defined by this document. However, these property names
MUST be returned in a <DAV:propname> request for a resource that
supports the properties, except in the case of infinite limits, which
are explained below.
The DAV:quota-available-bytes and DAV:quota-used-bytes definitions
below borrow heavily from the quota definitions in the Network File
System (NFS) [<a href="./rfc3530" title=""Network File System (NFS) version 4 Protocol"">RFC3530</a>] specification.
<span class="h2"><a class="selflink" id="section-3" href="#section-3">3</a>. DAV:quota-available-bytes</span>
Name: quota-available-bytes
Namespace: DAV:
Purpose: Indicates the maximum amount of additional storage available
to be allocated to a resource.
DTD: <!ELEMENT quota-available-bytes (#PCDATA) >
The DAV:quota-available-bytes property value is the value in octets
representing the amount of additional disk space beyond the current
allocation that can be allocated to this resource before further
allocations will be refused. It is understood that this space may be
consumed by allocations to other resources.
Support for this property is REQUIRED on collections, and OPTIONAL on
other resources. A server SHOULD implement this property for each
resource that has the DAV:quota-used-bytes property.
Clients SHOULD expect that as the DAV:quota-available-bytes on a
resource approaches 0, further allocations to that resource may be
refused. A value of 0 indicates that users will probably not be able
to perform operations that write additional information (e.g., a PUT
inside a collection), but may be able to replace through overwrite an
existing resource of equal size.
Note that there may be a number of distinct but overlapping limits,
which may even include physical media limits. When reporting DAV:
quota-available-bytes, the server is at liberty to choose any of
<span class="grey">Korver & Dusseault Standards Track [Page 3]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-4" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
those limits but SHOULD do so in a repeatable way. The rule may be
configured per repository, or may be "choose the smallest number".
If a resource has no quota enforced or unlimited storage ("infinite
limits"), the server MAY choose not to return this property (404 Not
Found response in Multi-Status), although this specification
RECOMMENDS that servers return some appropriate value (e.g., the
amount of free disk space). A client cannot entirely assume that
there is no quota enforced on a resource that does not have this
property, but might as well act as if there is no quota.
The value of this property is protected (see <a href="./rfc3253#section-1.4.2">Section 1.4.2 of
[RFC3253]</a> for the definition of protected properties). A 403
Forbidden response is RECOMMENDED for attempts to write a protected
property, and the server SHOULD include an XML error body as defined
by DeltaV [<a href="./rfc3253" title=""Versioning Extensions to WebDAV (Web Distributed Authoring and Versioning)"">RFC3253</a>] with the <DAV:cannot-modify-protected-property/>
precondition tag.
<span class="h2"><a class="selflink" id="section-4" href="#section-4">4</a>. DAV:quota-used-bytes</span>
Name: quota-used-bytes
Namespace: DAV:
Purpose: Contains the amount of storage counted against the quota on
a resource.
DTD: <!ELEMENT quota-used-bytes (#PCDATA) >
The DAV:quota-used-bytes value is the value in octets representing
the amount of space used by this resource and possibly a number of
other similar resources, where the set of "similar" meets at least
the criterion that allocating space to any resource in the set will
count against the DAV:quota-available-bytes. It MUST include the
total count including usage derived from sub-resources if
appropriate. It SHOULD include metadata storage size if metadata
storage is counted against the DAV:quota-available-bytes.
Note that there may be a number of distinct but overlapping sets of
resources for which a DAV:quota-used-bytes is maintained (e.g., "all
files with a given owner", "all files with a given group owner",
etc.). The server is at liberty to choose any of those sets but
SHOULD do so in a repeatable way. The rule may be configured per
repository.
Support for this property is REQUIRED on collections, and OPTIONAL on
other resources. A server SHOULD implement this property for each
resource that has the DAV:quota-available-bytes property.
<span class="grey">Korver & Dusseault Standards Track [Page 4]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-5" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
This value of this property is computed (see <a href="./rfc3253#section-1.4.3">Section 1.4.3 of
[RFC3253]</a> for the definition of computed property). A 403 Forbidden
response is RECOMMENDED for attempts to write a protected property,
and the server SHOULD include an XML error body as defined by DeltaV
[<a href="./rfc3253" title=""Versioning Extensions to WebDAV (Web Distributed Authoring and Versioning)"">RFC3253</a>] with the <DAV:cannot-modify-protected-property/>
precondition tag.
<span class="h2"><a class="selflink" id="section-5" href="#section-5">5</a>. Example PROPFIND Request and Response</span>
Request:
PROPFIND /~milele/public/ HTTP/1.1
Depth: 0
Host: www.example.com
Content-Type: text/xml
Content-Length: xxx
<?xml version="1.0" ?>
<D:propfind xmlns:D="DAV:">
<D:prop>
<D:quota-available-bytes/>
<D:quota-used-bytes/>
</D:prop>
</D:propfind>
Response:
HTTP/1.1 207 Multi-Status
Date: Tue, 16 Oct 2001 22:13:39 GMT
Content-Length: xxx
Content-Type: text/xml; charset=UTF-8
<?xml version="1.0" encoding="utf-8" ?>
<D:multistatus xmlns:D="DAV:">
<D:response>
<D:href>http://www.example.com/~milele/public/</D:href>
<D:propstat>
<D:prop>
<D:quota-available-bytes>596650</D:quota-available-bytes>
<D:quota-used-bytes>403350</D:quota-used-bytes>
</D:prop>
<D:status>HTTP/1.1 200 OK</D:status>
</D:propstat>
</D:response>
</D:multistatus>
<span class="grey">Korver & Dusseault Standards Track [Page 5]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-6" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
<span class="h2"><a class="selflink" id="section-6" href="#section-6">6</a>. Error Reporting</span>
WebDAV [<a href="./rfc2518" title=""HTTP Extensions for Distributed Authoring -- WebDAV"">RFC2518</a>] defines the status code 507 (Insufficient Storage).
This status code SHOULD be used when a client request (e.g., a PUT,
PROPFIND, MKCOL, MOVE, or COPY) fails because it would exceed their
quota or physical storage limits. In order to differentiate the
response from other storage problems, the server SHOULD include an
XML error body as defined by DeltaV [<a href="./rfc3253" title=""Versioning Extensions to WebDAV (Web Distributed Authoring and Versioning)"">RFC3253</a>] with the appropriate
precondition tag.
Preconditions:
(DAV:quota-not-exceeded): the request MUST NOT cause the allocated
quota to be exceeded.
(DAV:sufficient-disk-space): there is sufficient physical space to
execute the request.
Example error response:
HTTP/1.1 507 Insufficient Storage
Content-Length: xxx
Content-Type: text/xml
<?xml version="1.0">
<error xmlns="DAV:">
<quota-not-exceeded/>
</error>
Implementation note: some clients may be able to take advantage of
the different precondition codes when mapping to operating system
status codes, such as E_NOSPC and E_DQUOT in NFS (see <a href="./rfc3530#section-12">[RFC3530],
Section 12</a>).
<span class="h2"><a class="selflink" id="section-7" href="#section-7">7</a>. Notes</span>
Server implementations store and account for their data in many
different ways. Some of the challenges:
o Some server implementations find it prohibitive to count storage
used for metadata; others may choose to do so for better
accounting.
o Older versions of resources may be stored as well.
o Variants of one resource may exist with different content lengths.
o Content may be dynamically generated.
<span class="grey">Korver & Dusseault Standards Track [Page 6]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-7" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
o Resource bodies can be compressed.
o Some resources may be stored for "free", not counting against
quota.
Since server storage accounting can vary so much, clients should
expect the following:
o The size of a file on the client's file system, or in a PUT
message, may not correspond to the amount of storage required by
the server to store the resource. Thus, the client cannot predict
with 100% accuracy whether a given file will be allowed given the
storage quota.
o Deleting or overwriting a resource may not free up the same amount
of storage as indicated by the DAV:getcontentlength property
defined in [<a href="./rfc2518" title=""HTTP Extensions for Distributed Authoring -- WebDAV"">RFC2518</a>] for the resource. If deleting a resource
does not free up any space, the file may have been moved to a
"trash" folder or "recycle bin", or retained as in versioning
systems ([<a href="./rfc3253" title=""Versioning Extensions to WebDAV (Web Distributed Authoring and Versioning)"">RFC3253</a>]).
o Since there are many factors that affect the storage used by a set
of resources, including automatic compression, the size of
associated metadata, and server-inserted content (such as that
created by PHP code) in the on-the-wire representation of
resources, clients are advised not to depend on the value of DAV:
quota-used-bytes being the sum of the DAV:getcontentlength
properties for resources contained by a collection.
o Additionally, because there may be a number of distinct but
overlapping sets of resources for which a DAV:quota-used-bytes is
maintained (<a href="#section-4">Section 4</a>), there may be no correlation between the
size of the resources in a collection and DAV:quota-used-bytes.
For example, for a server that implements user-based quotas,
DAV:quota-used-bytes usually will be the same for a collection and
its members.
o On some systems where quota is counted by collection and not by
user, a quota on a sub-collection may be larger than the quota on
the parent collection that contains it. For example, the quota on
/~milele/ may be 100 MB, but the quota on /~milele/public/ may be
unlimited. This allows the space used by /~milele/public/ to be
as large as the quota on /~milele/ allows (depending on the other
contents of /~milele/) even if the quota on /~milele/ is changed.
Thus, even when the quota on a parent collection is changed, it is
not necessarily required to change the quota on every child or
descendant collection.
<span class="grey">Korver & Dusseault Standards Track [Page 7]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-8" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
<span class="h2"><a class="selflink" id="section-8" href="#section-8">8</a>. Security Considerations</span>
A hacker may prefer to store files in collections with a large quota.
This isn't strictly a security concern because it doesn't make it any
easier to store files. On the other hand, the DAV:quota-used-bytes
property may make it easier to detect tampering or misuse.
<span class="h2"><a class="selflink" id="section-9" href="#section-9">9</a>. Internationalization Considerations</span>
Quota is counted in Arabic numerals expressed in strings. There are
no internationalization considerations.
<span class="h2"><a class="selflink" id="section-10" href="#section-10">10</a>. Acknowledgements</span>
Stefan Eissing, Geoff Clemm, Jim Luther, Julian Reschke, and Jim
Whitehead, among others, have provided valuable comments on this
document.
<span class="h2"><a class="selflink" id="section-11" href="#section-11">11</a>. References</span>
<span class="h3"><a class="selflink" id="section-11.1" href="#section-11.1">11.1</a>. Normative References</span>
[<a id="ref-RFC2119">RFC2119</a>] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", <a href="https://www.rfc-editor.org/bcp/bcp14">BCP 14</a>, <a href="./rfc2119">RFC 2119</a>, March 1997.
[<a id="ref-RFC2518">RFC2518</a>] Goland, Y., Whitehead, E., Faizi, A., Carter, S., and D.
Jensen, "HTTP Extensions for Distributed Authoring --
WebDAV", <a href="./rfc2518">RFC 2518</a>, February 1999.
[<a id="ref-RFC3253">RFC3253</a>] Clemm, G., Amsden, J., Ellison, T., Kaler, C., and J.
Whitehead, "Versioning Extensions to WebDAV (Web
Distributed Authoring and Versioning)", <a href="./rfc3253">RFC 3253</a>, March
2002.
<span class="h3"><a class="selflink" id="section-11.2" href="#section-11.2">11.2</a>. Informative References</span>
[<a id="ref-RFC3530">RFC3530</a>] Shepler, S., Callaghan, B., Robinson, D., Thurlow, R.,
Beame, C., Eisler, M., and D. Noveck, "Network File System
(NFS) version 4 Protocol", <a href="./rfc3530">RFC 3530</a>, April 2003.
<span class="grey">Korver & Dusseault Standards Track [Page 8]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-9" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
Authors' Addresses
Brian Korver
Network Resonance, Inc.
2483 E. Bayshore Road
Suite 212
Palo Alto, CA 94303
US
Phone: +1 650 812-7705
EMail: briank@networkresonance.com
Lisa Dusseault
Open Source Applications Foundation
543 Howard Street
5th Floor
San Francisco, CA 94105
US
Phone: +1 415 946-3040
EMail: lisa@osafoundation.org
<span class="grey">Korver & Dusseault Standards Track [Page 9]</span></pre>
<hr class='noprint'/><!--NewPage--><pre class='newpage'><span id="page-10" ></span>
<span class="grey"><a href="./rfc4331">RFC 4331</a> WebDAV Quotas February 2006</span>
Full Copyright Statement
Copyright (C) The Internet Society (2006).
This document is subject to the rights, licenses and restrictions
contained in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a>, and except as set forth therein, the authors
retain all their rights.
This document and the information contained herein are provided on an
"AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATION HE/SHE REPRESENTS
OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET
ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED,
INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE
INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Intellectual Property
The IETF takes no position regarding the validity or scope of any
Intellectual Property Rights or other rights that might be claimed to
pertain to the implementation or use of the technology described in
this document or the extent to which any license under such rights
might or might not be available; nor does it represent that it has
made any independent effort to identify any such rights. Information
on the procedures with respect to rights in RFC documents can be
found in <a href="https://www.rfc-editor.org/bcp/bcp78">BCP 78</a> and <a href="https://www.rfc-editor.org/bcp/bcp79">BCP 79</a>.
Copies of IPR disclosures made to the IETF Secretariat and any
assurances of licenses to be made available, or the result of an
attempt made to obtain a general license or permission for the use of
such proprietary rights by implementers or users of this
specification can be obtained from the IETF on-line IPR repository at
<a href="http://www.ietf.org/ipr">http://www.ietf.org/ipr</a>.
The IETF invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights that may cover technology that may be required to implement
this standard. Please address the information to the IETF at
ietf-ipr@ietf.org.
Acknowledgement
Funding for the RFC Editor function is provided by the IETF
Administrative Support Activity (IASA).
Korver & Dusseault Standards Track [Page 10]
</pre>
|
