Apache2
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
mod_dav.h
Go to the documentation of this file.
1 /* Licensed to the Apache Software Foundation (ASF) under one or more
2  * contributor license agreements. See the NOTICE file distributed with
3  * this work for additional information regarding copyright ownership.
4  * The ASF licenses this file to You under the Apache License, Version 2.0
5  * (the "License"); you may not use this file except in compliance with
6  * the License. You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
26 #ifndef _MOD_DAV_H_
27 #define _MOD_DAV_H_
28 
29 #include "apr_hooks.h"
30 #include "apr_hash.h"
31 #include "apr_dbm.h"
32 #include "apr_tables.h"
33 
34 #include "httpd.h"
35 #include "util_filter.h"
36 #include "util_xml.h"
37 
38 #include <limits.h> /* for INT_MAX */
39 #include <time.h> /* for time_t */
40 
41 #ifdef __cplusplus
42 extern "C" {
43 #endif
44 
45 
46 #define DAV_VERSION AP_SERVER_BASEREVISION
47 
48 #define DAV_XML_HEADER "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
49 #define DAV_XML_CONTENT_TYPE "text/xml; charset=\"utf-8\""
50 
51 #define DAV_READ_BLOCKSIZE 2048 /* used for reading input blocks */
52 
53 #define DAV_RESPONSE_BODY_1 "<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML 2.0//EN\">\n<html><head>\n<title>"
54 #define DAV_RESPONSE_BODY_2 "</title>\n</head><body>\n<h1>"
55 #define DAV_RESPONSE_BODY_3 "</h1>\n<p>"
56 #define DAV_RESPONSE_BODY_4 "</p>\n"
57 #define DAV_RESPONSE_BODY_5 "</body></html>\n"
58 
59 #define DAV_DO_COPY 0
60 #define DAV_DO_MOVE 1
61 
62 
63 #if 1
64 #define DAV_DEBUG 1
65 #define DEBUG_CR "\n"
66 #define DBG0(f) ap_log_error(APLOG_MARK, \
67  APLOG_ERR, 0, NULL, (f))
68 #define DBG1(f,a1) ap_log_error(APLOG_MARK, \
69  APLOG_ERR, 0, NULL, f, a1)
70 #define DBG2(f,a1,a2) ap_log_error(APLOG_MARK, \
71  APLOG_ERR, 0, NULL, f, a1, a2)
72 #define DBG3(f,a1,a2,a3) ap_log_error(APLOG_MARK, \
73  APLOG_ERR, 0, NULL, f, a1, a2, a3)
74 #else
75 #undef DAV_DEBUG
76 #define DEBUG_CR ""
77 #endif
78 
79 #define DAV_INFINITY INT_MAX /* for the Depth: header */
80 
81 /* Create a set of DAV_DECLARE(type), DAV_DECLARE_NONSTD(type) and
82  * DAV_DECLARE_DATA with appropriate export and import tags for the platform
83  */
84 #if !defined(WIN32)
85 #define DAV_DECLARE(type) type
86 #define DAV_DECLARE_NONSTD(type) type
87 #define DAV_DECLARE_DATA
88 #elif defined(DAV_DECLARE_STATIC)
89 #define DAV_DECLARE(type) type __stdcall
90 #define DAV_DECLARE_NONSTD(type) type
91 #define DAV_DECLARE_DATA
92 #elif defined(DAV_DECLARE_EXPORT)
93 #define DAV_DECLARE(type) __declspec(dllexport) type __stdcall
94 #define DAV_DECLARE_NONSTD(type) __declspec(dllexport) type
95 #define DAV_DECLARE_DATA __declspec(dllexport)
96 #else
97 #define DAV_DECLARE(type) __declspec(dllimport) type __stdcall
98 #define DAV_DECLARE_NONSTD(type) __declspec(dllimport) type
99 #define DAV_DECLARE_DATA __declspec(dllimport)
100 #endif
101 
102 /* --------------------------------------------------------------------
103 **
104 ** ERROR MANAGEMENT
105 */
106 
107 /*
108 ** dav_error structure.
109 **
110 ** In most cases, mod_dav uses a pointer to a dav_error structure. If the
111 ** pointer is NULL, then no error has occurred.
112 **
113 ** In certain cases, a dav_error structure is directly used. In these cases,
114 ** a status value of 0 means that an error has not occurred.
115 **
116 ** Note: this implies that status != 0 whenever an error occurs.
117 **
118 ** The desc field is optional (it may be NULL). When NULL, it typically
119 ** implies that Apache has a proper description for the specified status.
120 */
121 typedef struct dav_error {
122  int status; /* suggested HTTP status (0 for no error) */
123  int error_id; /* DAV-specific error ID */
124  const char *desc; /* DAV:responsedescription and error log */
125 
126  apr_status_t aprerr; /* APR error if any, or 0/APR_SUCCESS */
127 
128  const char *namespace; /* [optional] namespace of error */
129  const char *tagname; /* name of error-tag */
130 
131  struct dav_error *prev; /* previous error (in stack) */
132 
133  const char *childtags; /* error-tag may have children */
134 
135 } dav_error;
136 
137 /*
138 ** Create a new error structure. save_errno will be filled with the current
139 ** errno value.
140 */
141 DAV_DECLARE(dav_error*) dav_new_error(apr_pool_t *p, int status,
143  const char *desc);
144 
145 
146 /*
147 ** Create a new error structure with tagname and (optional) namespace;
148 ** namespace may be NULL, which means "DAV:".
149 */
150 DAV_DECLARE(dav_error*) dav_new_error_tag(apr_pool_t *p, int status,
151  int error_id, apr_status_t aprerr,
152  const char *desc,
153  const char *namespace,
154  const char *tagname);
155 
156 
157 /*
158 ** Push a new error description onto the stack of errors.
159 **
160 ** This function is used to provide an additional description to an existing
161 ** error.
162 **
163 ** <status> should contain the caller's view of what the current status is,
164 ** given the underlying error. If it doesn't have a better idea, then the
165 ** caller should pass prev->status.
166 **
167 ** <error_id> can specify a new error_id since the topmost description has
168 ** changed.
169 */
170 DAV_DECLARE(dav_error*) dav_push_error(apr_pool_t *p, int status, int error_id,
171  const char *desc, dav_error *prev);
172 
173 
174 /*
175 ** Join two errors together.
176 **
177 ** This function is used to add a new error stack onto an existing error so
178 ** that subsequent errors can be reported after the first error. It returns
179 ** the correct error stack to use so that the caller can blindly call it
180 ** without checking that both dest and src are not NULL.
181 **
182 ** <dest> is the error stack that the error will be added to.
183 **
184 ** <src> is the error stack that will be appended.
185 */
186 DAV_DECLARE(dav_error*) dav_join_error(dav_error* dest, dav_error* src);
187 
188 typedef struct dav_response dav_response;
189 
190 /*
191 ** dav_handle_err()
192 **
193 ** Handle the standard error processing. <err> must be non-NULL.
194 **
195 ** <response> is set by the following:
196 ** - dav_validate_request()
197 ** - dav_add_lock()
198 ** - repos_hooks->remove_resource
199 ** - repos_hooks->move_resource
200 ** - repos_hooks->copy_resource
201 ** - vsn_hooks->update
202 */
203 DAV_DECLARE(int) dav_handle_err(request_rec *r, dav_error *err,
204  dav_response *response);
205 
206 /* error ID values... */
207 
208 /* IF: header errors */
209 #define DAV_ERR_IF_PARSE 100 /* general parsing error */
210 #define DAV_ERR_IF_MULTIPLE_NOT 101 /* multiple "Not" found */
211 #define DAV_ERR_IF_UNK_CHAR 102 /* unknown char in header */
212 #define DAV_ERR_IF_ABSENT 103 /* no locktokens given */
213 #define DAV_ERR_IF_TAGGED 104 /* in parsing tagged-list */
214 #define DAV_ERR_IF_UNCLOSED_PAREN 105 /* in no-tagged-list */
215 
216 /* Prop DB errors */
217 #define DAV_ERR_PROP_BAD_MAJOR 200 /* major version was wrong */
218 #define DAV_ERR_PROP_READONLY 201 /* prop is read-only */
219 #define DAV_ERR_PROP_NO_DATABASE 202 /* writable db not avail */
220 #define DAV_ERR_PROP_NOT_FOUND 203 /* prop not found */
221 #define DAV_ERR_PROP_BAD_LOCKDB 204 /* could not open lockdb */
222 #define DAV_ERR_PROP_OPENING 205 /* problem opening propdb */
223 #define DAV_ERR_PROP_EXEC 206 /* problem exec'ing patch */
224 
225 /* Predefined DB errors */
226 /* ### any to define?? */
227 
228 /* Predefined locking system errors */
229 #define DAV_ERR_LOCK_OPENDB 400 /* could not open lockdb */
230 #define DAV_ERR_LOCK_NO_DB 401 /* no database defined */
231 #define DAV_ERR_LOCK_CORRUPT_DB 402 /* DB is corrupt */
232 #define DAV_ERR_LOCK_UNK_STATE_TOKEN 403 /* unknown State-token */
233 #define DAV_ERR_LOCK_PARSE_TOKEN 404 /* bad opaquelocktoken */
234 #define DAV_ERR_LOCK_SAVE_LOCK 405 /* err saving locks */
235 
236 /*
237 ** Some comments on Error ID values:
238 **
239 ** The numbers do not necessarily need to be unique. Uniqueness simply means
240 ** that two errors that have not been predefined above can be distinguished
241 ** from each other. At the moment, mod_dav does not use this distinguishing
242 ** feature, but it could be used in the future to collapse <response> elements
243 ** into groups based on the error ID (and associated responsedescription).
244 **
245 ** If a compute_desc is provided, then the error ID should be unique within
246 ** the context of the compute_desc function (so the function can figure out
247 ** what to filled into the desc).
248 **
249 ** Basically, subsystems can ignore defining new error ID values if they want
250 ** to. The subsystems *do* need to return the predefined errors when
251 ** appropriate, so that mod_dav can figure out what to do. Subsystems can
252 ** simply leave the error ID field unfilled (zero) if there isn't an error
253 ** that must be placed there.
254 */
255 
256 
257 /* --------------------------------------------------------------------
258 **
259 ** HOOK STRUCTURES
260 **
261 ** These are here for forward-declaration purposes. For more info, see
262 ** the section title "HOOK HANDLING" for more information, plus each
263 ** structure definition.
264 */
265 
266 /* forward-declare this structure */
274 
275 /* ### deprecated name */
277 
278 
279 /* --------------------------------------------------------------------
280 **
281 ** RESOURCE HANDLING
282 */
283 
284 /*
285 ** Resource Types:
286 ** The base protocol defines only file and collection resources.
287 ** The versioning protocol defines several additional resource types
288 ** to represent artifacts of a version control system.
289 **
290 ** This enumeration identifies the type of URL used to identify the
291 ** resource. Since the same resource may have more than one type of
292 ** URL which can identify it, dav_resource_type cannot be used
293 ** alone to determine the type of the resource; attributes of the
294 ** dav_resource object must also be consulted.
295 */
296 typedef enum {
298 
299  DAV_RESOURCE_TYPE_REGULAR, /* file or collection; could be
300  * unversioned, or version selector,
301  * or baseline selector */
302 
303  DAV_RESOURCE_TYPE_VERSION, /* version or baseline URL */
304 
305  DAV_RESOURCE_TYPE_HISTORY, /* version or baseline history URL */
306 
307  DAV_RESOURCE_TYPE_WORKING, /* working resource URL */
308 
309  DAV_RESOURCE_TYPE_WORKSPACE, /* workspace URL */
310 
311  DAV_RESOURCE_TYPE_ACTIVITY, /* activity URL */
312 
313  DAV_RESOURCE_TYPE_PRIVATE /* repository-private type */
314 
316 
317 /*
318 ** Opaque, repository-specific information for a resource.
319 */
321 
323 
324 /*
325 ** Resource descriptor, generated by a repository provider.
326 **
327 ** Note: the lock-null state is not explicitly represented here,
328 ** since it may be expensive to compute. Use dav_get_resource_state()
329 ** to determine whether a non-existent resource is a lock-null resource.
330 **
331 ** A quick explanation of how the flags can apply to different resources:
332 **
333 ** unversioned file or collection:
334 ** type = DAV_RESOURCE_TYPE_REGULAR
335 ** exists = ? (1 if exists)
336 ** collection = ? (1 if collection)
337 ** versioned = 0
338 ** baselined = 0
339 ** working = 0
340 **
341 ** version-controlled resource or configuration:
342 ** type = DAV_RESOURCE_TYPE_REGULAR
343 ** exists = 1
344 ** collection = ? (1 if collection)
345 ** versioned = 1
346 ** baselined = ? (1 if configuration)
347 ** working = ? (1 if checked out)
348 **
349 ** version/baseline history:
350 ** type = DAV_RESOURCE_TYPE_HISTORY
351 ** exists = 1
352 ** collection = 0
353 ** versioned = 0
354 ** baselined = 0
355 ** working = 0
356 **
357 ** version/baseline:
358 ** type = DAV_RESOURCE_TYPE_VERSION
359 ** exists = 1
360 ** collection = ? (1 if collection)
361 ** versioned = 1
362 ** baselined = ? (1 if baseline)
363 ** working = 0
364 **
365 ** working resource:
366 ** type = DAV_RESOURCE_TYPE_WORKING
367 ** exists = 1
368 ** collection = ? (1 if collection)
369 ** versioned = 1
370 ** baselined = 0
371 ** working = 1
372 **
373 ** workspace:
374 ** type = DAV_RESOURCE_TYPE_WORKSPACE
375 ** exists = ? (1 if exists)
376 ** collection = 1
377 ** versioned = ? (1 if version-controlled)
378 ** baselined = ? (1 if baseline-controlled)
379 ** working = ? (1 if checked out)
380 **
381 ** activity:
382 ** type = DAV_RESOURCE_TYPE_ACTIVITY
383 ** exists = ? (1 if exists)
384 ** collection = 0
385 ** versioned = 0
386 ** baselined = 0
387 ** working = 0
388 */
389 typedef struct dav_resource {
391 
392  int exists; /* 0 => null resource */
393 
394  int collection; /* 0 => file; can be 1 for
395  * REGULAR, VERSION, and WORKING resources,
396  * and is always 1 for WORKSPACE */
397 
398  int versioned; /* 0 => unversioned; can be 1 for
399  * REGULAR and WORKSPACE resources,
400  * and is always 1 for VERSION and WORKING */
401 
402  int baselined; /* 0 => not baselined; can be 1 for
403  * REGULAR, VERSION, and WORKSPACE resources;
404  * versioned == 1 when baselined == 1 */
405 
406  int working; /* 0 => not checked out; can be 1 for
407  * REGULAR and WORKSPACE resources,
408  * and is always 1 for WORKING */
409 
410  const char *uri; /* the URI for this resource;
411  * currently has an ABI flaw where sometimes it is
412  * assumed to be encoded and sometimes not */
413 
414  dav_resource_private *info; /* the provider's private info */
415 
416  const dav_hooks_repository *hooks; /* hooks used for this resource */
417 
418  /* When allocating items related specifically to this resource, the
419  following pool should be used. Its lifetime will be at least as
420  long as the dav_resource structure. */
422 
423  const dav_acl_provider *acls; /* acls used for this resource */
424 
425  void *ctx; /* additional parameter */
426 
427 } dav_resource;
428 
429 /*
430 ** Lock token type. Lock providers define the details of a lock token.
431 ** However, all providers are expected to at least be able to parse
432 ** the "opaquelocktoken" scheme, which is represented by a uuid_t.
433 */
435 
436 
437 /* --------------------------------------------------------------------
438 **
439 ** BUFFER HANDLING
440 **
441 ** These buffers are used as a lightweight buffer reuse mechanism. Apache
442 ** provides sub-pool creation and destruction to much the same effect, but
443 ** the sub-pools are a bit more general and heavyweight than these buffers.
444 */
445 
446 /* buffer for reuse; can grow to accommodate needed size */
447 typedef struct
448 {
449  apr_size_t alloc_len; /* how much has been allocated */
450  apr_size_t cur_len; /* how much is currently being used */
451  char *buf; /* buffer contents */
452 } dav_buffer;
453 #define DAV_BUFFER_MINSIZE 256 /* minimum size for buffer */
454 #define DAV_BUFFER_PAD 64 /* amount of pad when growing */
455 
456 /* set the cur_len to the given size and ensure space is available */
457 DAV_DECLARE(void) dav_set_bufsize(apr_pool_t *p, dav_buffer *pbuf,
458  apr_size_t size);
459 
460 /* initialize a buffer and copy the specified (null-term'd) string into it */
461 DAV_DECLARE(void) dav_buffer_init(apr_pool_t *p, dav_buffer *pbuf,
462  const char *str);
463 
464 /* check that the buffer can accommodate <extra_needed> more bytes */
465 DAV_DECLARE(void) dav_check_bufsize(apr_pool_t *p, dav_buffer *pbuf,
467 
468 /* append a string to the end of the buffer, adjust length */
469 DAV_DECLARE(void) dav_buffer_append(apr_pool_t *p, dav_buffer *pbuf,
470  const char *str);
471 
472 /* place a string on the end of the buffer, do NOT adjust length */
473 DAV_DECLARE(void) dav_buffer_place(apr_pool_t *p, dav_buffer *pbuf,
474  const char *str);
475 
476 /* place some memory on the end of a buffer; do NOT adjust length */
477 DAV_DECLARE(void) dav_buffer_place_mem(apr_pool_t *p, dav_buffer *pbuf,
478  const void *mem, apr_size_t amt,
479  apr_size_t pad);
480 
481 
482 /* --------------------------------------------------------------------
483 **
484 ** HANDY UTILITIES
485 */
486 
487 /* contains results from one of the getprop functions */
488 typedef struct
489 {
490  apr_text * propstats; /* <propstat> element text */
491  apr_text * xmlns; /* namespace decls for <response> elem */
493 
494 /* holds the contents of a <response> element */
495 struct dav_response
496 {
497  const char *href; /* always */
498  const char *desc; /* optional description at <response> level */
499 
500  /* use status if propresult.propstats is NULL. */
502 
503  int status;
504 
505  struct dav_response *next;
506 };
507 
508 typedef struct
509 {
510  request_rec *rnew; /* new subrequest */
511  dav_error err; /* potential error response */
513 
514 
515 DAV_DECLARE(dav_lookup_result) dav_lookup_uri(const char *uri, request_rec *r,
516  int must_be_absolute);
517 
518 /* defines type of property info a provider is to return */
519 typedef enum {
520  DAV_PROP_INSERT_NOTDEF, /* property is defined by this provider,
521  but nothing was inserted because the
522  (live) property is not defined for this
523  resource (it may be present as a dead
524  property). */
525  DAV_PROP_INSERT_NOTSUPP, /* property is recognized by this provider,
526  but it is not supported, and cannot be
527  treated as a dead property */
528  DAV_PROP_INSERT_NAME, /* a property name (empty elem) was
529  inserted into the text block */
530  DAV_PROP_INSERT_VALUE, /* a property name/value pair was inserted
531  into the text block */
532  DAV_PROP_INSERT_SUPPORTED /* a supported live property was added to
533  the text block as a
534  <DAV:supported-live-property> element */
536 
537 /* ### this stuff is private to dav/fs/repos.c; move it... */
538 /* format a time string (buf must be at least DAV_TIMEBUF_SIZE chars) */
539 #define DAV_STYLE_ISO8601 1
540 #define DAV_STYLE_RFC822 2
541 #define DAV_TIMEBUF_SIZE 30
542 
543 /* Write a complete RESPONSE object out as a <DAV:response> xml
544  * element. Data is sent into brigade BB, which is auto-flushed into
545  * the output filter stack for request R. Use POOL for any temporary
546  * allocations.
547  *
548  * [Presumably the <multistatus> tag has already been written; this
549  * routine is shared by dav_send_multistatus and dav_stream_response.]
550  */
551 DAV_DECLARE(void) dav_send_one_response(dav_response *response,
553  request_rec *r,
554  apr_pool_t *pool);
555 
556 /* Factorized helper function: prep request_rec R for a multistatus
557  * response and write <multistatus> tag into BB, destined for
558  * R->output_filters. Use xml NAMESPACES in initial tag, if
559  * non-NULL.
560  */
561 DAV_DECLARE(void) dav_begin_multistatus(apr_bucket_brigade *bb,
562  request_rec *r, int status,
564 
565 /* Finish a multistatus response started by dav_begin_multistatus: */
566 DAV_DECLARE(apr_status_t) dav_finish_multistatus(request_rec *r,
567  apr_bucket_brigade *bb);
568 
569 /* Send a multistatus response */
570 DAV_DECLARE(void) dav_send_multistatus(request_rec *r, int status,
571  dav_response *first,
572  apr_array_header_t *namespaces);
573 
574 DAV_DECLARE(apr_text *) dav_failed_proppatch(apr_pool_t *p,
576 DAV_DECLARE(apr_text *) dav_success_proppatch(apr_pool_t *p,
577  apr_array_header_t *prop_ctx);
578 
579 DAV_DECLARE(int) dav_get_depth(request_rec *r, int def_depth);
580 
581 DAV_DECLARE(int) dav_validate_root(const apr_xml_doc *doc,
582  const char *tagname);
583 DAV_DECLARE(apr_xml_elem *) dav_find_child(const apr_xml_elem *elem,
584  const char *tagname);
585 
586 /* gather up all the CDATA into a single string */
587 DAV_DECLARE(const char *) dav_xml_get_cdata(const apr_xml_elem *elem, apr_pool_t *pool,
588  int strip_white);
589 
590 /*
591 ** XML namespace handling
592 **
593 ** This structure tracks namespace declarations (xmlns:prefix="URI").
594 ** It maintains a one-to-many relationship of URIs-to-prefixes. In other
595 ** words, one URI may be defined by many prefixes, but any specific
596 ** prefix will specify only one URI.
597 **
598 ** Prefixes using the "g###" pattern can be generated automatically if
599 ** the caller does not have specific prefix requirements.
600 */
601 typedef struct {
603  apr_hash_t *uri_prefix; /* map URIs to an available prefix */
604  apr_hash_t *prefix_uri; /* map all prefixes to their URIs */
605  int count; /* counter for "g###" prefixes */
607 
608 /* create an empty dav_xmlns_info structure */
609 DAV_DECLARE(dav_xmlns_info *) dav_xmlns_create(apr_pool_t *pool);
610 
611 /* add a specific prefix/URI pair. the prefix/uri should have a lifetime
612  at least that of xmlns->pool */
613 DAV_DECLARE(void) dav_xmlns_add(dav_xmlns_info *xi,
614  const char *prefix, const char *uri);
615 
616 /* add a URI (if not present); any prefix is acceptable and is returned.
617  the uri should have a lifetime at least that xmlns->pool */
618 DAV_DECLARE(const char *) dav_xmlns_add_uri(dav_xmlns_info *xi,
619  const char *uri);
620 
621 /* return the URI for a specified prefix (or NULL if the prefix is unknown) */
622 DAV_DECLARE(const char *) dav_xmlns_get_uri(dav_xmlns_info *xi,
623  const char *prefix);
624 
625 /* return an available prefix for a specified URI (or NULL if the URI
626  is unknown) */
627 DAV_DECLARE(const char *) dav_xmlns_get_prefix(dav_xmlns_info *xi,
628  const char *uri);
629 
630 /* generate xmlns declarations (appending into the given text) */
631 DAV_DECLARE(void) dav_xmlns_generate(dav_xmlns_info *xi,
633 
634 /* --------------------------------------------------------------------
635 **
636 ** DAV PLUGINS
637 */
638 
639 /* ### docco ... */
640 
641 /*
642 ** dav_provider
643 **
644 ** This structure wraps up all of the hooks that a mod_dav provider can
645 ** supply. The provider MUST supply <repos> and <propdb>. The rest are
646 ** optional and should contain NULL if that feature is not supplied.
647 **
648 ** Note that a provider cannot pick and choose portions from various
649 ** underlying implementations (which was theoretically possible in
650 ** mod_dav 1.0). There are too many dependencies between a dav_resource
651 ** (defined by <repos>) and the other functionality.
652 **
653 ** Live properties are not part of the dav_provider structure because they
654 ** are handled through the APR_HOOK interface (to allow for multiple liveprop
655 ** providers). The core always provides some properties, and then a given
656 ** provider will add more properties.
657 **
658 ** Some providers may need to associate a context with the dav_provider
659 ** structure -- the ctx field is available for storing this context. Just
660 ** leave it NULL if it isn't required.
661 */
662 typedef struct {
669 
670  void *ctx;
671 } dav_provider;
672 
673 /*
674 ** gather_propsets: gather all live property propset-URIs
675 **
676 ** The hook implementor should push one or more URIs into the specified
677 ** array. These URIs are returned in the DAV: header to let clients know
678 ** what sets of live properties are supported by the installation. mod_dav
679 ** will place open/close angle brackets around each value (much like
680 ** a Coded-URL); quotes and brackets should not be in the value.
681 **
682 ** Example: http://apache.org/dav/props/
683 **
684 ** (of course, use your own domain to ensure a unique value)
685 */
686 APR_DECLARE_EXTERNAL_HOOK(dav, DAV, void, gather_propsets,
687  (apr_array_header_t *uris))
688 
689 /*
690 ** find_liveprop: find a live property, returning a non-zero, unique,
691 ** opaque identifier.
692 **
693 ** If the hook implementor determines the specified URI/name refers to
694 ** one of its properties, then it should fill in HOOKS and return a
695 ** non-zero value. The returned value is the "property ID" and will
696 ** be passed to the various liveprop hook functions.
697 **
698 ** Return 0 if the property is not defined by the hook implementor.
699 */
700 APR_DECLARE_EXTERNAL_HOOK(dav, DAV, int, find_liveprop,
701  (const dav_resource *resource,
702  const char *ns_uri, const char *name,
703  const dav_hooks_liveprop **hooks))
704 
705 /*
706 ** insert_all_liveprops: insert all (known) live property names/values.
707 **
708 ** The hook implementor should append XML text to PHDR, containing liveprop
709 ** names. If INSVALUE is true, then the property values should also be
710 ** inserted into the output XML stream.
711 **
712 ** The liveprop provider should insert *all* known and *defined* live
713 ** properties on the specified resource. If a particular liveprop is
714 ** not defined for this resource, then it should not be inserted.
715 */
716 APR_DECLARE_EXTERNAL_HOOK(dav, DAV, void, insert_all_liveprops,
717  (request_rec *r, const dav_resource *resource,
719 
720 DAV_DECLARE(const dav_hooks_locks *) dav_get_lock_hooks(request_rec *r);
721 DAV_DECLARE(const dav_hooks_propdb *) dav_get_propdb_hooks(request_rec *r);
722 DAV_DECLARE(const dav_hooks_vsn *) dav_get_vsn_hooks(request_rec *r);
723 DAV_DECLARE(const dav_hooks_binding *) dav_get_binding_hooks(request_rec *r);
724 DAV_DECLARE(const dav_hooks_search *) dav_get_search_hooks(request_rec *r);
725 
726 DAV_DECLARE(void) dav_register_provider(apr_pool_t *p, const char *name,
727  const dav_provider *hooks);
728 DAV_DECLARE(const dav_provider *) dav_lookup_provider(const char *name);
729 DAV_DECLARE(const char *) dav_get_provider_name(request_rec *r);
730 
731 
732 /* ### deprecated */
733 #define DAV_GET_HOOKS_PROPDB(r) dav_get_propdb_hooks(r)
734 #define DAV_GET_HOOKS_LOCKS(r) dav_get_lock_hooks(r)
735 #define DAV_GET_HOOKS_VSN(r) dav_get_vsn_hooks(r)
736 #define DAV_GET_HOOKS_BINDING(r) dav_get_binding_hooks(r)
737 #define DAV_GET_HOOKS_SEARCH(r) dav_get_search_hooks(r)
738 
739 
740 /* --------------------------------------------------------------------
741 **
742 ** IF HEADER PROCESSING
743 **
744 ** Here is the definition of the If: header from RFC 2518, S9.4:
745 **
746 ** If = "If" ":" (1*No-tag-list | 1*Tagged-list)
747 ** No-tag-list = List
748 ** Tagged-list = Resource 1*List
749 ** Resource = Coded-URL
750 ** List = "(" 1*(["Not"](State-token | "[" entity-tag "]")) ")"
751 ** State-token = Coded-URL
752 ** Coded-URL = "<" absoluteURI ">" ; absoluteURI from RFC 2616
753 **
754 ** List corresponds to dav_if_state_list. No-tag-list corresponds to
755 ** dav_if_header with uri==NULL. Tagged-list corresponds to a sequence of
756 ** dav_if_header structures with (duplicate) uri==Resource -- one
757 ** dav_if_header per state_list. A second Tagged-list will start a new
758 ** sequence of dav_if_header structures with the new URI.
759 **
760 ** A summary of the semantics, mapped into our structures:
761 ** - Chained dav_if_headers: OR
762 ** - Chained dav_if_state_lists: AND
763 ** - NULL uri matches all resources
764 */
765 
766 typedef enum
767 {
770  dav_if_unknown /* the "unknown" state type; always matches false. */
772 
773 typedef struct dav_if_state_list
774 {
776 
778 #define DAV_IF_COND_NORMAL 0
779 #define DAV_IF_COND_NOT 1 /* "Not" was applied */
780 
781  const char *etag;
783 
786 
787 typedef struct dav_if_header
788 {
789  const char *uri;
793 
794  int dummy_header; /* used internally by the lock/etag validation */
795 } dav_if_header;
796 
797 typedef struct dav_locktoken_list
798 {
802 
803 DAV_DECLARE(dav_error *) dav_get_locktoken_list(request_rec *r,
805 
806 
807 /* --------------------------------------------------------------------
808 **
809 ** LIVE PROPERTY HANDLING
810 */
811 
812 /* opaque type for PROPPATCH rollback information */
814 
816 {
817  /*
818  ** Insert property information into a text block. The property to
819  ** insert is identified by the propid value. The information to insert
820  ** is identified by the "what" argument, as follows:
821  ** DAV_PROP_INSERT_NAME
822  ** property name, as an empty XML element
823  ** DAV_PROP_INSERT_VALUE
824  ** property name/value, as an XML element
825  ** DAV_PROP_INSERT_SUPPORTED
826  ** if the property is defined on the resource, then
827  ** a DAV:supported-live-property element, as defined
828  ** by the DeltaV extensions to RFC2518.
829  **
830  ** Providers should return DAV_PROP_INSERT_NOTDEF if the property is
831  ** known and not defined for this resource, so should be handled as a
832  ** dead property. If a provider recognizes, but does not support, a
833  ** property, and does not want it handled as a dead property, it should
834  ** return DAV_PROP_INSERT_NOTSUPP.
835  **
836  ** Returns one of DAV_PROP_INSERT_* based on what happened.
837  **
838  ** ### we may need more context... ie. the lock database
839  */
840  dav_prop_insert (*insert_prop)(const dav_resource *resource,
841  int propid, dav_prop_insert what,
843 
844  /*
845  ** Determine whether a given property is writable.
846  **
847  ** ### we may want a different semantic. i.e. maybe it should be
848  ** ### "can we write <value> into this property?"
849  **
850  ** Returns 1 if the live property can be written, 0 if read-only.
851  */
852  int (*is_writable)(const dav_resource *resource, int propid);
853 
854  /*
855  ** This member defines the set of namespace URIs that the provider
856  ** uses for its properties. When insert_all is called, it will be
857  ** passed a list of integers that map from indices into this list
858  ** to namespace IDs for output generation.
859  **
860  ** The last entry in this list should be a NULL value (sentinel).
861  */
862  const char * const * namespace_uris;
863 
864  /*
865  ** ### this is not the final design. we want an open-ended way for
866  ** ### liveprop providers to attach *new* properties. To this end,
867  ** ### we'll have a "give me a list of the props you define", a way
868  ** ### to check for a prop's existence, a way to validate a set/remove
869  ** ### of a prop, and a way to execute/commit/rollback that change.
870  */
871 
872  /*
873  ** Validate that the live property can be assigned a value, and that
874  ** the provided value is valid.
875  **
876  ** elem will point to the XML element that names the property. For
877  ** example:
878  ** <lp1:executable>T</lp1:executable>
879  **
880  ** The provider can access the cdata fields and the child elements
881  ** to extract the relevant pieces.
882  **
883  ** operation is one of DAV_PROP_OP_SET or _DELETE.
884  **
885  ** The provider may return a value in *context which will be passed
886  ** to each of the exec/commit/rollback functions. For example, this
887  ** may contain an internal value which has been processed from the
888  ** input element.
889  **
890  ** The provider must set defer_to_dead to true (non-zero) or false.
891  ** If true, then the set/remove is deferred to the dead property
892  ** database. Note: it will be set to zero on entry.
893  */
894  dav_error * (*patch_validate)(const dav_resource *resource,
895  const apr_xml_elem *elem,
896  int operation,
897  void **context,
898  int *defer_to_dead);
899 
900  /* ### doc... */
901  dav_error * (*patch_exec)(const dav_resource *resource,
902  const apr_xml_elem *elem,
903  int operation,
904  void *context,
905  dav_liveprop_rollback **rollback_ctx);
906 
907  /* ### doc... */
908  void (*patch_commit)(const dav_resource *resource,
909  int operation,
910  void *context,
911  dav_liveprop_rollback *rollback_ctx);
912 
913  /* ### doc... */
914  dav_error * (*patch_rollback)(const dav_resource *resource,
915  int operation,
916  void *context,
917  dav_liveprop_rollback *rollback_ctx);
918 
919  /*
920  ** If a provider needs a context to associate with this hooks structure,
921  ** then this field may be used. In most cases, it will just be NULL.
922  */
923  void *ctx;
924 };
925 
926 /*
927 ** dav_liveprop_spec: specify a live property
928 **
929 ** This structure is used as a standard way to determine if a particular
930 ** property is a live property. Its use is not part of the mandated liveprop
931 ** interface, but can be used by liveprop providers in conjunction with the
932 ** utility routines below.
933 **
934 ** spec->name == NULL is the defined end-sentinel for a list of specs.
935 */
936 typedef struct {
937  int ns; /* provider-local namespace index */
938  const char *name; /* name of the property */
939 
940  int propid; /* provider-local property ID */
941 
942  int is_writable; /* is the property writable? */
943 
945 
946 /*
947 ** dav_liveprop_group: specify a group of liveprops
948 **
949 ** This structure specifies a group of live properties, their namespaces,
950 ** and how to handle them.
951 */
952 typedef struct {
954  const char * const *namespace_uris;
956 
958 
959 /* ### docco */
960 DAV_DECLARE(int) dav_do_find_liveprop(const char *ns_uri, const char *name,
961  const dav_liveprop_group *group,
962  const dav_hooks_liveprop **hooks);
963 
964 /* ### docco */
965 DAV_DECLARE(long) dav_get_liveprop_info(int propid,
966  const dav_liveprop_group *group,
967  const dav_liveprop_spec **info);
968 
969 /* ### docco */
970 DAV_DECLARE(void) dav_register_liveprop_group(apr_pool_t *pool,
971  const dav_liveprop_group *group);
972 
973 /* ### docco */
974 DAV_DECLARE(long) dav_get_liveprop_ns_index(const char *uri);
975 
976 /* ### docco */
977 DAV_DECLARE(long) dav_get_liveprop_ns_count(void);
978 
979 /* ### docco */
980 DAV_DECLARE(void) dav_add_all_liveprop_xmlns(apr_pool_t *p,
982 
983 /*
984 ** The following three functions are part of mod_dav's internal handling
985 ** for the core WebDAV properties. They are not part of mod_dav's API.
986 */
987 DAV_DECLARE_NONSTD(int) dav_core_find_liveprop(
988  const dav_resource *resource,
989  const char *ns_uri,
990  const char *name,
991  const dav_hooks_liveprop **hooks);
992 DAV_DECLARE_NONSTD(void) dav_core_insert_all_liveprops(
993  request_rec *r,
994  const dav_resource *resource,
996  apr_text_header *phdr);
997 DAV_DECLARE_NONSTD(void) dav_core_register_uris(apr_pool_t *p);
998 
999 
1000 /*
1001 ** Standard WebDAV Property Identifiers
1002 **
1003 ** A live property provider does not need to use these; they are simply
1004 ** provided for convenience.
1005 **
1006 ** Property identifiers need to be unique within a given provider, but not
1007 ** *across* providers (note: this uniqueness constraint was different in
1008 ** older versions of mod_dav).
1009 **
1010 ** The identifiers start at 20000 to make it easier for providers to avoid
1011 ** conflicts with the standard properties. The properties are arranged
1012 ** alphabetically, and may be reordered from time to time (as properties
1013 ** are introduced).
1014 **
1015 ** NOTE: there is no problem with reordering (e.g. binary compat) since the
1016 ** identifiers are only used within a given provider, which would pick up
1017 ** the entire set of changes upon a recompile.
1018 */
1019 enum {
1021 
1022  /* Standard WebDAV properties (RFC 2518) */
1034 
1035  /* DeltaV properties (from the I-D (#14)) */
1074 
1076 };
1077 
1078 /*
1079 ** Property Identifier Registration
1080 **
1081 ** At the moment, mod_dav requires live property providers to ensure that
1082 ** each property returned has a unique value. For now, this is done through
1083 ** central registration (there are no known providers other than the default,
1084 ** so this remains manageable).
1085 **
1086 ** WARNING: the TEST ranges should never be "shipped".
1087 */
1088 #define DAV_PROPID_CORE 10000 /* ..10099. defined by mod_dav */
1089 #define DAV_PROPID_FS 10100 /* ..10299.
1090  mod_dav filesystem provider. */
1091 #define DAV_PROPID_TEST1 10300 /* ..10399 */
1092 #define DAV_PROPID_TEST2 10400 /* ..10499 */
1093 #define DAV_PROPID_TEST3 10500 /* ..10599 */
1094 /* Next: 10600 */
1095 
1096 
1097 /* --------------------------------------------------------------------
1098 **
1099 ** DATABASE FUNCTIONS
1100 */
1101 
1102 typedef struct dav_db dav_db;
1105 
1106 typedef struct {
1107  const char *ns; /* "" signals "no namespace" */
1108  const char *name;
1109 } dav_prop_name;
1110 
1111 /* hook functions to enable pluggable databases */
1113 {
1114  dav_error * (*open)(apr_pool_t *p, const dav_resource *resource, int ro,
1115  dav_db **pdb);
1116  void (*close)(dav_db *db);
1117 
1118  /*
1119  ** In bulk, define any namespaces that the values and their name
1120  ** elements may need.
1121  **
1122  ** Note: sometimes mod_dav will defer calling this until output_value
1123  ** returns found==1. If the output process needs the dav_xmlns_info
1124  ** filled for its work, then it will need to fill it on demand rather
1125  ** than depending upon this hook to fill in the structure.
1126  **
1127  ** Note: this will *always* be called during an output sequence. Thus,
1128  ** the provider may rely solely on using this to fill the xmlns info.
1129  */
1130  dav_error * (*define_namespaces)(dav_db *db, dav_xmlns_info *xi);
1131 
1132  /*
1133  ** Output the value from the database (i.e. add an element name and
1134  ** the value into *phdr). Set *found based on whether the name/value
1135  ** was found in the propdb.
1136  **
1137  ** Note: it is NOT an error for the key/value pair to not exist.
1138  **
1139  ** The dav_xmlns_info passed to define_namespaces() is also passed to
1140  ** each output_value() call so that namespaces can be added on-demand.
1141  ** It can also be used to look up prefixes or URIs during the output
1142  ** process.
1143  */
1144  dav_error * (*output_value)(dav_db *db, const dav_prop_name *name,
1145  dav_xmlns_info *xi,
1146  apr_text_header *phdr, int *found);
1147 
1148  /*
1149  ** Build a mapping from "global" namespaces (stored in apr_xml_*)
1150  ** into provider-local namespace identifiers.
1151  **
1152  ** This mapping should be done once per set of namespaces, and the
1153  ** resulting mapping should be passed into the store() hook function.
1154  **
1155  ** Note: usually, there is just a single document/namespaces for all
1156  ** elements passed. However, the generality of creating multiple
1157  ** mappings and passing them to store() is provided here.
1158  **
1159  ** Note: this is only in preparation for a series of store() calls.
1160  ** As a result, the propdb must be open for read/write access when
1161  ** this function is called.
1162  */
1163  dav_error * (*map_namespaces)(dav_db *db,
1165  dav_namespace_map **mapping);
1166 
1167  /*
1168  ** Store a property value for a given name. The value->combined field
1169  ** MUST be set for this call.
1170  **
1171  ** ### WARNING: current providers will quote the text within ELEM.
1172  ** ### this implies you can call this function only once with a given
1173  ** ### element structure (a second time will quote it again).
1174  */
1175  dav_error * (*store)(dav_db *db, const dav_prop_name *name,
1176  const apr_xml_elem *elem,
1177  dav_namespace_map *mapping);
1178 
1179  /* remove a given property */
1180  dav_error * (*remove)(dav_db *db, const dav_prop_name *name);
1181 
1182  /* returns 1 if the record specified by "key" exists; 0 otherwise */
1184 
1185  /*
1186  ** Iterate over the property names in the database.
1187  **
1188  ** iter->name.ns == iter->name.name == NULL when there are no more names.
1189  **
1190  ** Note: only one iteration may occur over the propdb at a time.
1191  */
1192  dav_error * (*first_name)(dav_db *db, dav_prop_name *pname);
1193  dav_error * (*next_name)(dav_db *db, dav_prop_name *pname);
1194 
1195  /*
1196  ** Rollback support: get rollback context, and apply it.
1197  **
1198  ** struct dav_deadprop_rollback is a provider-private structure; it
1199  ** should remember the name, and the name's old value (or the fact that
1200  ** the value was not present, and should be deleted if a rollback occurs).
1201  */
1202  dav_error * (*get_rollback)(dav_db *db, const dav_prop_name *name,
1203  dav_deadprop_rollback **prollback);
1204  dav_error * (*apply_rollback)(dav_db *db,
1205  dav_deadprop_rollback *rollback);
1206 
1207  /*
1208  ** If a provider needs a context to associate with this hooks structure,
1209  ** then this field may be used. In most cases, it will just be NULL.
1210  */
1211  void *ctx;
1212 };
1213 
1214 
1215 /* --------------------------------------------------------------------
1216 **
1217 ** LOCK FUNCTIONS
1218 */
1219 
1220 /* Used to represent a Timeout header of "Infinity" */
1221 #define DAV_TIMEOUT_INFINITE 0
1222 
1223 DAV_DECLARE(time_t) dav_get_timeout(request_rec *r);
1224 
1225 /*
1226 ** Opaque, provider-specific information for a lock database.
1227 */
1229 
1230 /*
1231 ** Opaque, provider-specific information for a lock record.
1232 */
1234 
1235 /*
1236 ** Lock database type. Lock providers are urged to implement a "lazy" open, so
1237 ** doing an "open" is cheap until something is actually needed from the DB.
1238 */
1239 typedef struct
1240 {
1241  const dav_hooks_locks *hooks; /* the hooks used for this lockdb */
1242  int ro; /* was it opened readonly? */
1243 
1244  dav_lockdb_private *info;
1245 
1246 } dav_lockdb;
1247 
1248 typedef enum {
1252 } dav_lock_scope;
1253 
1254 typedef enum {
1257 } dav_lock_type;
1258 
1259 typedef enum {
1260  DAV_LOCKREC_DIRECT, /* lock asserted on this resource */
1261  DAV_LOCKREC_INDIRECT, /* lock inherited from a parent */
1262  DAV_LOCKREC_INDIRECT_PARTIAL /* most info is not filled in */
1264 
1265 /*
1266 ** dav_lock: hold information about a lock on a resource.
1267 **
1268 ** This structure is used for both direct and indirect locks. A direct lock
1269 ** is a lock applied to a specific resource by the client. An indirect lock
1270 ** is one that is inherited from a parent resource by virtue of a non-zero
1271 ** Depth: header when the lock was applied.
1272 **
1273 ** mod_dav records both types of locks in the lock database, managing their
1274 ** addition/removal as resources are moved about the namespace.
1275 **
1276 ** Note that the lockdb is free to marshal this structure in any form that
1277 ** it likes.
1278 **
1279 ** For a "partial" lock, the <rectype> and <locktoken> fields must be filled
1280 ** in. All other (user) fields should be zeroed. The lock provider will
1281 ** usually fill in the <info> field, and the <next> field may be used to
1282 ** construct a list of partial locks.
1283 **
1284 ** The lock provider MUST use the info field to store a value such that a
1285 ** dav_lock structure can locate itself in the underlying lock database.
1286 ** This requirement is needed for refreshing: when an indirect dav_lock is
1287 ** refreshed, its reference to the direct lock does not specify the direct's
1288 ** resource, so the only way to locate the (refreshed, direct) lock in the
1289 ** database is to use the info field.
1290 **
1291 ** Note that <is_locknull> only refers to the resource where this lock was
1292 ** found.
1293 ** ### hrm. that says the abstraction is wrong. is_locknull may disappear.
1294 */
1295 typedef struct dav_lock
1296 {
1297  dav_lock_rectype rectype; /* type of lock record */
1298  int is_locknull; /* lock establishes a locknull resource */
1299 
1300  /* ### put the resource in here? */
1301 
1302  dav_lock_scope scope; /* scope of the lock */
1303  dav_lock_type type; /* type of lock */
1304  int depth; /* depth of the lock */
1305  time_t timeout; /* when the lock will timeout */
1306 
1307  const dav_locktoken *locktoken; /* the token that was issued */
1308 
1309  const char *owner; /* (XML) owner of the lock */
1310  const char *auth_user; /* auth'd username owning lock */
1311 
1312  dav_lock_private *info; /* private to the lockdb */
1313 
1314  struct dav_lock *next; /* for managing a list of locks */
1315 } dav_lock;
1316 
1317 /* Property-related public lock functions */
1318 DAV_DECLARE(const char *)dav_lock_get_activelock(request_rec *r,
1320  dav_buffer *pbuf);
1321 
1322 /* LockDB-related public lock functions */
1323 DAV_DECLARE(dav_error *) dav_lock_parse_lockinfo(request_rec *r,
1325  dav_lockdb *lockdb,
1326  const apr_xml_doc *doc,
1328 DAV_DECLARE(int) dav_unlock(request_rec *r,
1330  const dav_locktoken *locktoken);
1331 DAV_DECLARE(dav_error *) dav_add_lock(request_rec *r,
1332  const dav_resource *resource,
1333  dav_lockdb *lockdb, dav_lock *request,
1334  dav_response **response);
1335 DAV_DECLARE(dav_error *) dav_notify_created(request_rec *r,
1336  dav_lockdb *lockdb,
1337  const dav_resource *resource,
1338  int resource_state,
1339  int depth);
1340 
1341 DAV_DECLARE(dav_error*) dav_lock_query(dav_lockdb *lockdb,
1342  const dav_resource *resource,
1343  dav_lock **locks);
1344 
1345 DAV_DECLARE(dav_error *) dav_validate_request(request_rec *r,
1346  dav_resource *resource,
1347  int depth,
1348  dav_locktoken *locktoken,
1349  dav_response **response,
1350  int flags,
1351  dav_lockdb *lockdb);
1352 /*
1353 ** flags:
1354 ** 0x0F -- reserved for <dav_lock_scope> values
1355 **
1356 ** other flags, detailed below
1357 */
1358 #define DAV_VALIDATE_RESOURCE 0x0010 /* validate just the resource */
1359 #define DAV_VALIDATE_PARENT 0x0020 /* validate resource AND its parent */
1360 #define DAV_VALIDATE_ADD_LD 0x0040 /* add DAV:lockdiscovery into
1361  the 424 DAV:response */
1362 #define DAV_VALIDATE_USE_424 0x0080 /* return 424 status, not 207 */
1363 #define DAV_VALIDATE_IS_PARENT 0x0100 /* for internal use */
1364 #define DAV_VALIDATE_NO_MODIFY 0x0200 /* resource is not being modified
1365  so allow even if lock token
1366  is not provided */
1367 
1368 /* Lock-null related public lock functions */
1369 DAV_DECLARE(int) dav_get_resource_state(request_rec *r,
1370  const dav_resource *resource);
1371 
1372 /* Lock provider hooks. Locking is optional, so there may be no
1373  * lock provider for a given repository.
1374  */
1376 {
1377  /* Return the supportedlock property for a resource */
1378  const char * (*get_supportedlock)(
1379  const dav_resource *resource
1380  );
1381 
1382  /* Parse a lock token URI, returning a lock token object allocated
1383  * in the given pool.
1384  */
1385  dav_error * (*parse_locktoken)(
1386  apr_pool_t *p,
1387  const char *char_token,
1388  dav_locktoken **locktoken_p
1389  );
1390 
1391  /* Format a lock token object into a URI string, allocated in
1392  * the given pool.
1393  *
1394  * Always returns non-NULL.
1395  */
1396  const char * (*format_locktoken)(
1397  apr_pool_t *p,
1398  const dav_locktoken *locktoken
1399  );
1400 
1401  /* Compare two lock tokens.
1402  *
1403  * Result < 0 => lt1 < lt2
1404  * Result == 0 => lt1 == lt2
1405  * Result > 0 => lt1 > lt2
1406  */
1407  int (*compare_locktoken)(
1408  const dav_locktoken *lt1,
1409  const dav_locktoken *lt2
1410  );
1411 
1412  /* Open the provider's lock database.
1413  *
1414  * The provider may or may not use a "real" database for locks
1415  * (a lock could be an attribute on a resource, for example).
1416  *
1417  * The provider may choose to use the value of the DAVLockDB directive
1418  * (as returned by dav_get_lockdb_path()) to decide where to place
1419  * any storage it may need.
1420  *
1421  * The request storage pool should be associated with the lockdb,
1422  * so it can be used in subsequent operations.
1423  *
1424  * If ro != 0, only readonly operations will be performed.
1425  * If force == 0, the open can be "lazy"; no subsequent locking operations
1426  * may occur.
1427  * If force != 0, locking operations will definitely occur.
1428  */
1429  dav_error * (*open_lockdb)(
1430  request_rec *r,
1431  int ro,
1432  int force,
1433  dav_lockdb **lockdb
1434  );
1435 
1436  /* Indicates completion of locking operations */
1437  void (*close_lockdb)(
1439  );
1440 
1441  /* Take a resource out of the lock-null state. */
1442  dav_error * (*remove_locknull_state)(
1443  dav_lockdb *lockdb,
1444  const dav_resource *resource
1445  );
1446 
1447  /*
1448  ** Create a (direct) lock structure for the given resource. A locktoken
1449  ** will be created.
1450  **
1451  ** The lock provider may store private information into lock->info.
1452  */
1453  dav_error * (*create_lock)(dav_lockdb *lockdb,
1454  const dav_resource *resource,
1455  dav_lock **lock);
1456 
1457  /*
1458  ** Get the locks associated with the specified resource.
1459  **
1460  ** If resolve_locks is true (non-zero), then any indirect locks are
1461  ** resolved to their actual, direct lock (i.e. the reference to followed
1462  ** to the original lock).
1463  **
1464  ** The locks, if any, are returned as a linked list in no particular
1465  ** order. If no locks are present, then *locks will be NULL.
1466  */
1467  dav_error * (*get_locks)(dav_lockdb *lockdb,
1468  const dav_resource *resource,
1469  int calltype,
1470  dav_lock **locks);
1471 
1472 #define DAV_GETLOCKS_RESOLVED 0 /* resolve indirects to directs */
1473 #define DAV_GETLOCKS_PARTIAL 1 /* leave indirects partially filled */
1474 #define DAV_GETLOCKS_COMPLETE 2 /* fill out indirect locks */
1475 
1476  /*
1477  ** Find a particular lock on a resource (specified by its locktoken).
1478  **
1479  ** *lock will be set to NULL if the lock is not found.
1480  **
1481  ** Note that the provider can optimize the unmarshalling -- only one
1482  ** lock (or none) must be constructed and returned.
1483  **
1484  ** If partial_ok is true (non-zero), then an indirect lock can be
1485  ** partially filled in. Otherwise, another lookup is done and the
1486  ** lock structure will be filled out as a DAV_LOCKREC_INDIRECT.
1487  */
1488  dav_error * (*find_lock)(dav_lockdb *lockdb,
1489  const dav_resource *resource,
1490  const dav_locktoken *locktoken,
1491  int partial_ok,
1492  dav_lock **lock);
1493 
1494  /*
1495  ** Quick test to see if the resource has *any* locks on it.
1496  **
1497  ** This is typically used to determine if a non-existent resource
1498  ** has a lock and is (therefore) a locknull resource.
1499  **
1500  ** WARNING: this function may return TRUE even when timed-out locks
1501  ** exist (i.e. it may not perform timeout checks).
1502  */
1503  dav_error * (*has_locks)(dav_lockdb *lockdb,
1504  const dav_resource *resource,
1505  int *locks_present);
1506 
1507  /*
1508  ** Append the specified lock(s) to the set of locks on this resource.
1509  **
1510  ** If "make_indirect" is true (non-zero), then the specified lock(s)
1511  ** should be converted to an indirect lock (if it is a direct lock)
1512  ** before appending. Note that the conversion to an indirect lock does
1513  ** not alter the passed-in lock -- the change is internal the
1514  ** append_locks function.
1515  **
1516  ** Multiple locks are specified using the lock->next links.
1517  */
1518  dav_error * (*append_locks)(dav_lockdb *lockdb,
1519  const dav_resource *resource,
1520  int make_indirect,
1521  const dav_lock *lock);
1522 
1523  /*
1524  ** Remove any lock that has the specified locktoken.
1525  **
1526  ** If locktoken == NULL, then ALL locks are removed.
1527  */
1528  dav_error * (*remove_lock)(dav_lockdb *lockdb,
1529  const dav_resource *resource,
1530  const dav_locktoken *locktoken);
1531 
1532  /*
1533  ** Refresh all locks, found on the specified resource, which has a
1534  ** locktoken in the provided list.
1535  **
1536  ** If the lock is indirect, then the direct lock is referenced and
1537  ** refreshed.
1538  **
1539  ** Each lock that is updated is returned in the <locks> argument.
1540  ** Note that the locks will be fully resolved.
1541  */
1542  dav_error * (*refresh_locks)(dav_lockdb *lockdb,
1543  const dav_resource *resource,
1544  const dav_locktoken_list *ltl,
1545  time_t new_time,
1546  dav_lock **locks);
1547 
1548  /*
1549  ** Look up the resource associated with a particular locktoken.
1550  **
1551  ** The search begins at the specified <start_resource> and the lock
1552  ** specified by <locktoken>.
1553  **
1554  ** If the resource/token specifies an indirect lock, then the direct
1555  ** lock will be looked up, and THAT resource will be returned. In other
1556  ** words, this function always returns the resource where a particular
1557  ** lock (token) was asserted.
1558  **
1559  ** NOTE: this function pointer is allowed to be NULL, indicating that
1560  ** the provider does not support this type of functionality. The
1561  ** caller should then traverse up the repository hierarchy looking
1562  ** for the resource defining a lock with this locktoken.
1563  */
1564  dav_error * (*lookup_resource)(dav_lockdb *lockdb,
1565  const dav_locktoken *locktoken,
1566  const dav_resource *start_resource,
1567  const dav_resource **resource);
1568 
1569  /*
1570  ** If a provider needs a context to associate with this hooks structure,
1571  ** then this field may be used. In most cases, it will just be NULL.
1572  */
1573  void *ctx;
1574 };
1575 
1576 /* what types of resources can be discovered by dav_get_resource_state() */
1577 #define DAV_RESOURCE_LOCK_NULL 10 /* resource lock-null */
1578 #define DAV_RESOURCE_NULL 11 /* resource null */
1579 #define DAV_RESOURCE_EXISTS 12 /* resource exists */
1580 #define DAV_RESOURCE_ERROR 13 /* an error occurred */
1581 
1582 
1583 /* --------------------------------------------------------------------
1584 **
1585 ** PROPERTY HANDLING
1586 */
1587 
1588 typedef struct dav_propdb dav_propdb;
1589 
1590 
1591 DAV_DECLARE(dav_error *) dav_open_propdb(
1592  request_rec *r,
1593  dav_lockdb *lockdb,
1594  const dav_resource *resource,
1595  int ro,
1597  dav_propdb **propdb);
1598 
1599 DAV_DECLARE(void) dav_close_propdb(dav_propdb *db);
1600 
1601 DAV_DECLARE(dav_get_props_result) dav_get_props(
1602  dav_propdb *db,
1603  apr_xml_doc *doc);
1604 
1605 DAV_DECLARE(dav_get_props_result) dav_get_allprops(
1606  dav_propdb *db,
1608 
1609 DAV_DECLARE(void) dav_get_liveprop_supported(
1610  dav_propdb *propdb,
1611  const char *ns_uri,
1612  const char *propname,
1614 
1615 /*
1616 ** 3-phase property modification.
1617 **
1618 ** 1) validate props. readable? unlocked? ACLs allow access?
1619 ** 2) execute operation (set/delete)
1620 ** 3) commit or rollback
1621 **
1622 ** ### eventually, auth must be available. a ref to the request_rec (which
1623 ** ### contains the auth info) should be in the shared context struct.
1624 **
1625 ** Each function may alter the error values and information contained within
1626 ** the context record. This should be done as an "increasing" level of
1627 ** error, rather than overwriting any previous error.
1628 **
1629 ** Note that commit() cannot generate errors. It should simply free the
1630 ** rollback information.
1631 **
1632 ** rollback() may generate additional errors because the rollback operation
1633 ** can sometimes fail(!).
1634 **
1635 ** The caller should allocate an array of these, one per operation. It should
1636 ** be zero-initialized, then the db, operation, and prop fields should be
1637 ** filled in before calling dav_prop_validate. Note that the set/delete
1638 ** operations are order-dependent. For a given (logical) context, the same
1639 ** pointer must be passed to each phase.
1640 **
1641 ** error_type is an internal value, but will have the same numeric value
1642 ** for each possible "desc" value. This allows the caller to group the
1643 ** descriptions via the error_type variable, rather than through string
1644 ** comparisons. Note that "status" does not provide enough granularity to
1645 ** differentiate/group the "desc" values.
1646 **
1647 ** Note that the propdb will maintain some (global) context across all
1648 ** of the property change contexts. This implies that you can have only
1649 ** one open transaction per propdb.
1650 */
1651 typedef struct dav_prop_ctx
1652 {
1654 
1655  apr_xml_elem *prop; /* property to affect */
1656 
1658 #define DAV_PROP_OP_SET 1 /* set a property value */
1659 #define DAV_PROP_OP_DELETE 2 /* delete a prop value */
1660 /* ### add a GET? */
1661 
1662  /* private items to the propdb */
1665  struct dav_rollback_item *rollback; /* optional rollback info */
1666 
1667  dav_error *err; /* error (if any) */
1668 
1669  /* private to mod_dav.c */
1671 
1672 } dav_prop_ctx;
1673 
1674 DAV_DECLARE_NONSTD(void) dav_prop_validate(dav_prop_ctx *ctx);
1675 DAV_DECLARE_NONSTD(void) dav_prop_exec(dav_prop_ctx *ctx);
1676 DAV_DECLARE_NONSTD(void) dav_prop_commit(dav_prop_ctx *ctx);
1677 DAV_DECLARE_NONSTD(void) dav_prop_rollback(dav_prop_ctx *ctx);
1678 
1679 #define DAV_PROP_CTX_HAS_ERR(dpc) ((dpc).err && (dpc).err->status >= 300)
1680 
1681 
1682 /* --------------------------------------------------------------------
1683 **
1684 ** WALKER STRUCTURE
1685 */
1686 
1687 enum {
1688  DAV_CALLTYPE_MEMBER = 1, /* called for a member resource */
1689  DAV_CALLTYPE_COLLECTION, /* called for a collection */
1690  DAV_CALLTYPE_LOCKNULL /* called for a locknull resource */
1691 };
1692 
1693 typedef struct
1694 {
1695  /* the client-provided context */
1696  void *walk_ctx;
1697 
1698  /* pool to use for allocations in the callback */
1700 
1701  /* the current resource */
1703 
1704  /* OUTPUT: add responses to this */
1705  dav_response *response;
1706 
1708 
1709 typedef struct
1710 {
1712 #define DAV_WALKTYPE_AUTH 0x0001 /* limit to authorized files */
1713 #define DAV_WALKTYPE_NORMAL 0x0002 /* walk normal files */
1714 #define DAV_WALKTYPE_LOCKNULL 0x0004 /* walk locknull resources */
1715 
1716  /* callback function and a client context for the walk */
1717  dav_error * (*func)(dav_walk_resource *wres, int calltype);
1718  void *walk_ctx;
1719 
1720  /* what pool to use for allocations needed by walk logic */
1722 
1723  /* beginning root of the walk */
1725 
1726  /* lock database to enable walking LOCKNULL resources */
1728 
1729 } dav_walk_params;
1730 
1731 /* directory tree walking context */
1732 typedef struct dav_walker_ctx
1733 {
1734  /* input: */
1736 
1737 
1738  /* ### client data... phasing out this big glom */
1739 
1740  /* this brigade buffers data being sent to r->output_filters */
1742 
1743  /* a scratch pool, used to stream responses and iteratively cleared. */
1745 
1746  request_rec *r; /* original request */
1747 
1748  /* for PROPFIND operations */
1751 #define DAV_PROPFIND_IS_ALLPROP 1
1752 #define DAV_PROPFIND_IS_PROPNAME 2
1753 #define DAV_PROPFIND_IS_PROP 3
1754 
1755  apr_text *propstat_404; /* (cached) propstat giving a 404 error */
1756 
1757  const dav_if_header *if_header; /* for validation */
1758  const dav_locktoken *locktoken; /* for UNLOCK */
1759  const dav_lock *lock; /* for LOCK */
1760  int skip_root; /* for dav_inherit_locks() */
1761 
1762  int flags;
1763 
1764  dav_buffer work_buf; /* for dav_validate_request() */
1765 
1766 } dav_walker_ctx;
1767 
1768 DAV_DECLARE(void) dav_add_response(dav_walk_resource *wres,
1769  int status,
1771 
1772 
1773 /* --------------------------------------------------------------------
1774 **
1775 ** "STREAM" STRUCTURE
1776 **
1777 ** mod_dav uses this abstraction for interacting with the repository
1778 ** while fetching/storing resources. mod_dav views resources as a stream
1779 ** of bytes.
1780 **
1781 ** Note that the structure is opaque -- it is private to the repository
1782 ** that created the stream in the repository's "open" function.
1783 **
1784 ** ### THIS STUFF IS GOING AWAY ... GET/read requests are handled by
1785 ** ### having the provider jam stuff straight into the filter stack.
1786 ** ### this is only left for handling PUT/write requests.
1787 */
1788 
1789 typedef struct dav_stream dav_stream;
1790 
1791 typedef enum {
1792  DAV_MODE_WRITE_TRUNC, /* truncate and open for writing */
1793  DAV_MODE_WRITE_SEEKABLE /* open for writing; random access */
1794 } dav_stream_mode;
1795 
1796 
1797 /* --------------------------------------------------------------------
1798 **
1799 ** REPOSITORY FUNCTIONS
1800 */
1801 
1802 /* Repository provider hooks */
1804 {
1805  /* Flag for whether repository requires special GET handling.
1806  * If resources in the repository are not visible in the
1807  * filesystem location which URLs map to, then special handling
1808  * is required to first fetch a resource from the repository,
1809  * respond to the GET request, then free the resource copy.
1810  */
1812 
1813  /* Get a resource descriptor for the URI in a request. A descriptor
1814  * should always be returned even if the resource does not exist. This
1815  * repository has been identified as handling the resource given by
1816  * the URI, so an answer must be given. If there is a problem with the
1817  * URI or accessing the resource or whatever, then an error should be
1818  * returned.
1819  *
1820  * root_dir:
1821  * the root of the directory for which this repository is configured.
1822  *
1823  * label:
1824  * if a Label: header is present (and allowed), this is the label
1825  * to use to identify a version resource from the resource's
1826  * corresponding version history. Otherwise, it will be NULL.
1827  *
1828  * use_checked_in:
1829  * use the DAV:checked-in property of the resource identified by the
1830  * Request-URI to identify and return a version resource
1831  *
1832  * The provider may associate the request storage pool with the resource
1833  * (in the resource->pool field), to use in other operations on that
1834  * resource.
1835  */
1836  dav_error * (*get_resource)(
1837  request_rec *r,
1838  const char *root_dir,
1839  const char *label,
1840  int use_checked_in,
1842  );
1843 
1844  /* Get a resource descriptor for the parent of the given resource.
1845  * The resources need not exist. NULL is returned if the resource
1846  * is the root collection.
1847  *
1848  * An error should be returned only if there is a fatal error in
1849  * fetching information about the parent resource.
1850  */
1851  dav_error * (*get_parent_resource)(
1852  const dav_resource *resource,
1853  dav_resource **parent_resource
1854  );
1855 
1856  /* Determine whether two resource descriptors refer to the same resource.
1857  *
1858  * Result != 0 => the resources are the same.
1859  */
1861  const dav_resource *res1,
1862  const dav_resource *res2
1863  );
1864 
1865  /* Determine whether one resource is a parent (immediate or otherwise)
1866  * of another.
1867  *
1868  * Result != 0 => res1 is a parent of res2.
1869  */
1871  const dav_resource *res1,
1872  const dav_resource *res2
1873  );
1874 
1875  /*
1876  ** Open a stream for this resource, using the specified mode. The
1877  ** stream will be returned in *stream.
1878  */
1879  dav_error * (*open_stream)(const dav_resource *resource,
1880  dav_stream_mode mode,
1881  dav_stream **stream);
1882 
1883  /*
1884  ** Close the specified stream.
1885  **
1886  ** mod_dav will (ideally) make sure to call this. For safety purposes,
1887  ** a provider should (ideally) register a cleanup function with the
1888  ** request pool to get this closed and cleaned up.
1889  **
1890  ** Note the possibility of an error from the close -- it is entirely
1891  ** feasible that the close does a "commit" of some kind, which can
1892  ** produce an error.
1893  **
1894  ** commit should be TRUE (non-zero) or FALSE (0) if the stream was
1895  ** opened for writing. This flag states whether to retain the file
1896  ** or not.
1897  ** Note: the commit flag is ignored for streams opened for reading.
1898  */
1899  dav_error * (*close_stream)(dav_stream *stream, int commit);
1900 
1901  /*
1902  ** Write data to the stream.
1903  **
1904  ** All of the bytes must be written, or an error should be returned.
1905  */
1906  dav_error * (*write_stream)(dav_stream *stream,
1907  const void *buf, apr_size_t bufsize);
1908 
1909  /*
1910  ** Seek to an absolute position in the stream. This is used to support
1911  ** Content-Range in a GET/PUT.
1912  **
1913  ** NOTE: if this function is NULL (which is allowed), then any
1914  ** operations using Content-Range will be refused.
1915  */
1916  dav_error * (*seek_stream)(dav_stream *stream, apr_off_t abs_position);
1917 
1918  /*
1919  ** If a GET is processed using a stream (open_stream, read_stream)
1920  ** rather than via a sub-request (on get_pathname), then this function
1921  ** is used to provide the repository with a way to set the headers
1922  ** in the response.
1923  **
1924  ** This function may be called without a following deliver(), to
1925  ** handle a HEAD request.
1926  **
1927  ** This may be NULL if handle_get is FALSE.
1928  */
1929  dav_error * (*set_headers)(request_rec *r,
1930  const dav_resource *resource);
1931 
1932  /*
1933  ** The provider should deliver the resource into the request's output
1934  ** filter stack. Basically, this is the response to the GET method.
1935  **
1936  ** Note that this is called for all resources, including collections.
1937  ** The provider should determine what has content to deliver or not.
1938  **
1939  ** set_headers will be called prior to this function, allowing the
1940  ** provider to set the appropriate response headers.
1941  **
1942  ** This may be NULL if handle_get is FALSE.
1943  ** ### maybe toss handle_get and just use this function as the marker
1944  **
1945  ** API ISSUE: don't use the passed-in 'output' filter.
1946  **
1947  ** Instead, generate the response into the output filter stack for the
1948  ** request (r->output_filters). An implementation can use the request_rec
1949  ** that was passed to get_resource() for this purpose. Using 'output'
1950  ** filter for the response can cause unbounded memory usage.
1951  **
1952  ** See https://mail-archives.apache.org/mod_mbox/httpd-dev/201608.mbox/%3C20160822151917.GA22369%40redhat.com%3E
1953  */
1954  dav_error * (*deliver)(const dav_resource *resource,
1955  ap_filter_t *output);
1956 
1957  /* Create a collection resource. The resource must not already exist.
1958  *
1959  * Result == NULL if the collection was created successfully. Also, the
1960  * resource object is updated to reflect that the resource exists, and
1961  * is a collection.
1962  */
1963  dav_error * (*create_collection)(
1965  );
1966 
1967  /* Copy one resource to another. The destination may exist, if it is
1968  * versioned.
1969  * Handles both files and collections. Properties are copied as well.
1970  * If the destination exists and is versioned, the provider must update
1971  * the destination to have identical content to the source,
1972  * recursively for collections.
1973  * The depth argument is ignored for a file, and can be either 0 or
1974  * DAV_INFINITY for a collection.
1975  * If an error occurs in a child resource, then the return value is
1976  * non-NULL, and *response is set to a multistatus response.
1977  * If the copy is successful, the dst resource object is
1978  * updated to reflect that the resource exists.
1979  */
1980  dav_error * (*copy_resource)(
1981  const dav_resource *src,
1982  dav_resource *dst,
1983  int depth,
1984  dav_response **response
1985  );
1986 
1987  /* Move one resource to another. The destination must not exist.
1988  * Handles both files and collections. Properties are moved as well.
1989  * If an error occurs in a child resource, then the return value is
1990  * non-NULL, and *response is set to a multistatus response.
1991  * If the move is successful, the src and dst resource objects are
1992  * updated to reflect that the source no longer exists, and the
1993  * destination does.
1994  */
1995  dav_error * (*move_resource)(
1996  dav_resource *src,
1997  dav_resource *dst,
1998  dav_response **response
1999  );
2000 
2001  /* Remove a resource. Handles both files and collections.
2002  * Removes any associated properties as well.
2003  * If an error occurs in a child resource, then the return value is
2004  * non-NULL, and *response is set to a multistatus response.
2005  * If the delete is successful, the resource object is updated to
2006  * reflect that the resource no longer exists.
2007  */
2008  dav_error * (*remove_resource)(
2010  dav_response **response
2011  );
2012 
2013  /* Walk a resource hierarchy.
2014  *
2015  * Iterates over the resource hierarchy specified by params->root.
2016  * Control of the walk and the callback are specified by 'params'.
2017  *
2018  * An error may be returned. *response will contain multistatus
2019  * responses (if any) suitable for the body of the error. It is also
2020  * possible to return NULL, yet still have multistatus responses.
2021  * In this case, typically the caller should return a 207 (Multistatus)
2022  * and the responses (in the body) as the HTTP response.
2023  */
2024  dav_error * (*walk)(const dav_walk_params *params, int depth,
2025  dav_response **response);
2026 
2027  /* Get the entity tag for a resource */
2028  const char * (*getetag)(const dav_resource *resource);
2029 
2030  /*
2031  ** If a provider needs a context to associate with this hooks structure,
2032  ** then this field may be used. In most cases, it will just be NULL.
2033  */
2034  void *ctx;
2035 
2036  /* Get the request rec for a resource */
2037  request_rec * (*get_request_rec)(const dav_resource *resource);
2038 
2039  /* Get the pathname for a resource */
2040  const char * (*get_pathname)(const dav_resource *resource);
2041 };
2042 
2043 
2044 /* --------------------------------------------------------------------
2045 **
2046 ** VERSIONING FUNCTIONS
2047 */
2048 
2049 
2050 /* dav_add_vary_header
2051  *
2052  * If there were any headers in the request which require a Vary header
2053  * in the response, add it.
2054  */
2055 DAV_DECLARE(void) dav_add_vary_header(request_rec *in_req,
2057  const dav_resource *resource);
2058 
2059 /*
2060 ** Flags specifying auto-versioning behavior, returned by
2061 ** the auto_versionable hook. The value returned depends
2062 ** on both the state of the resource and the value of the
2063 ** DAV:auto-versioning property for the resource.
2064 **
2065 ** If the resource does not exist (null or lock-null),
2066 ** DAV_AUTO_VERSION_ALWAYS causes creation of a new version-controlled resource
2067 **
2068 ** If the resource is checked in,
2069 ** DAV_AUTO_VERSION_ALWAYS causes it to be checked out always,
2070 ** DAV_AUTO_VERSION_LOCKED causes it to be checked out only when locked
2071 **
2072 ** If the resource is checked out,
2073 ** DAV_AUTO_VERSION_ALWAYS causes it to be checked in always,
2074 ** DAV_AUTO_VERSION_LOCKED causes it to be checked in when unlocked
2075 ** (note: a provider should allow auto-checkin only for resources which
2076 ** were automatically checked out)
2077 **
2078 ** In all cases, DAV_AUTO_VERSION_NEVER results in no auto-versioning behavior.
2079 */
2080 typedef enum {
2085 
2086 /*
2087 ** This structure is used to record what auto-versioning operations
2088 ** were done to make a resource writable, so that they can be undone
2089 ** at the end of a request.
2090 */
2091 typedef struct {
2092  int resource_versioned; /* 1 => resource was auto-version-controlled */
2093  int resource_checkedout; /* 1 => resource was auto-checked-out */
2094  int parent_checkedout; /* 1 => parent was auto-checked-out */
2095  dav_resource *parent_resource; /* parent resource, if it was needed */
2097 
2098 /* Ensure that a resource is writable. If there is no versioning
2099  * provider, then this is essentially a no-op. Versioning repositories
2100  * require explicit resource creation and checkout before they can
2101  * be written to. If a new resource is to be created, or an existing
2102  * resource deleted, the parent collection must be checked out as well.
2103  *
2104  * Set the parent_only flag to only make the parent collection writable.
2105  * Otherwise, both parent and child are made writable as needed. If the
2106  * child does not exist, then a new versioned resource is created and
2107  * checked out.
2108  *
2109  * If auto-versioning is not enabled for a versioned resource, then an error is
2110  * returned, since the resource cannot be modified.
2111  *
2112  * The dav_auto_version_info structure is filled in with enough information
2113  * to restore both parent and child resources to the state they were in
2114  * before the auto-versioning operations occurred.
2115  */
2116 DAV_DECLARE(dav_error *) dav_auto_checkout(
2117  request_rec *r,
2118  dav_resource *resource,
2119  int parent_only,
2121 
2122 /* Revert the writability of resources back to what they were
2123  * before they were modified. If undo == 0, then the resource
2124  * modifications are maintained (i.e. they are checked in).
2125  * If undo != 0, then resource modifications are discarded
2126  * (i.e. they are unchecked out).
2127  *
2128  * Set the unlock flag to indicate that the resource is about
2129  * to be unlocked; it will be checked in if the resource
2130  * auto-versioning property indicates it should be. In this case,
2131  * av_info is ignored, so it can be NULL.
2132  *
2133  * The resource argument may be NULL if only the parent resource
2134  * was checked out (i.e. the parent_only was != 0 in the
2135  * dav_auto_checkout call).
2136  */
2137 DAV_DECLARE(dav_error *) dav_auto_checkin(
2138  request_rec *r,
2139  dav_resource *resource,
2140  int undo,
2141  int unlock,
2142  dav_auto_version_info *av_info);
2143 
2144 /*
2145 ** This structure is used to describe available reports
2146 **
2147 ** "nmspace" should be valid XML and URL-quoted. mod_dav will place
2148 ** double-quotes around it and use it in an xmlns declaration.
2149 */
2150 typedef struct {
2151  const char *nmspace; /* namespace of the XML report element */
2152  const char *name; /* element name for the XML report */
2153 } dav_report_elem;
2154 
2155 
2156 /* Versioning provider hooks */
2158 {
2159  /*
2160  ** MANDATORY HOOKS
2161  ** The following hooks are mandatory for all versioning providers;
2162  ** they define the functionality needed to implement "core" versioning.
2163  */
2164 
2165  /* Return supported versioning options.
2166  * Each dav_text item in the list will be returned as a separate
2167  * DAV header. Providers are advised to limit the length of an
2168  * individual text item to 63 characters, to conform to the limit
2169  * used by MS Web Folders.
2170  */
2172 
2173  /* Get the value of a specific option for an OPTIONS request.
2174  * The option being requested is given by the parsed XML
2175  * element object "elem". The value of the option should be
2176  * appended to the "option" text object.
2177  */
2178  dav_error * (*get_option)(const dav_resource *resource,
2179  const apr_xml_elem *elem,
2180  apr_text_header *option);
2181 
2182  /* Determine whether a non-versioned (or non-existent) resource
2183  * is versionable. Returns != 0 if resource can be versioned.
2184  */
2186 
2187  /* Determine whether auto-versioning is enabled for a resource
2188  * (which may not exist, or may not be versioned). If the resource
2189  * is a checked-out resource, the provider must only enable
2190  * auto-checkin if the resource was automatically checked out.
2191  *
2192  * The value returned depends on both the state of the resource
2193  * and the value of its DAV:auto-version property. See the description
2194  * of the dav_auto_version enumeration above for the details.
2195  */
2197 
2198  /* Put a resource under version control. If the resource already
2199  * exists unversioned, then it becomes the initial version of the
2200  * new version history, and it is replaced by a version selector
2201  * which targets the new version.
2202  *
2203  * If the resource does not exist, then a new version-controlled
2204  * resource is created which either targets an existing version (if the
2205  * "target" argument is not NULL), or the initial, empty version
2206  * in a new history resource (if the "target" argument is NULL).
2207  *
2208  * If successful, the resource object state is updated appropriately
2209  * (that is, changed to refer to the new version-controlled resource).
2210  */
2211  dav_error * (*vsn_control)(dav_resource *resource,
2212  const char *target);
2213 
2214  /* Checkout a resource. If successful, the resource
2215  * object state is updated appropriately.
2216  *
2217  * The auto_checkout flag will be set if this checkout is being
2218  * done automatically, as part of some method which modifies
2219  * the resource. The provider must remember that the resource
2220  * was automatically checked out, so it can determine whether it
2221  * can be automatically checked in. (Auto-checkin should only be
2222  * enabled for resources which were automatically checked out.)
2223  *
2224  * If the working resource has a different URL from the
2225  * target resource, a dav_resource descriptor is returned
2226  * for the new working resource. Otherwise, the original
2227  * resource descriptor will refer to the working resource.
2228  * The working_resource argument can be NULL if the caller
2229  * is not interested in the working resource.
2230  *
2231  * If the client has specified DAV:unreserved or DAV:fork-ok in the
2232  * checkout request, then the corresponding flags are set. If
2233  * DAV:activity-set has been specified, then create_activity is set
2234  * if DAV:new was specified; otherwise, the DAV:href elements' CDATA
2235  * (the actual href text) is passed in the "activities" array (each
2236  * element of the array is a const char *). activities will be NULL
2237  * no DAV:activity-set was provided or when create_activity is set.
2238  */
2240  int auto_checkout,
2241  int is_unreserved, int is_fork_ok,
2242  int create_activity,
2243  apr_array_header_t *activities,
2244  dav_resource **working_resource);
2245 
2246  /* Uncheckout a checked-out resource. If successful, the resource
2247  * object state is updated appropriately.
2248  */
2249  dav_error * (*uncheckout)(dav_resource *resource);
2250 
2251  /* Checkin a checked-out resource. If successful, the resource
2252  * object state is updated appropriately, and the
2253  * version_resource descriptor will refer to the new version.
2254  * The version_resource argument can be NULL if the caller
2255  * is not interested in the new version resource.
2256  *
2257  * If the client has specified DAV:keep-checked-out in the checkin
2258  * request, then the keep_checked_out flag is set. The provider
2259  * should create a new version, but keep the resource in the
2260  * checked-out state.
2261  */
2263  int keep_checked_out,
2264  dav_resource **version_resource);
2265 
2266  /*
2267  ** Return the set of reports available at this resource.
2268  **
2269  ** An array of report elements should be returned, with an end-marker
2270  ** element containing namespace==NULL. The value of the
2271  ** DAV:supported-report-set property will be constructed and
2272  ** returned.
2273  */
2274  dav_error * (*avail_reports)(const dav_resource *resource,
2275  const dav_report_elem **reports);
2276 
2277  /*
2278  ** Determine whether a Label header can be used
2279  ** with a particular report. The dav_xml_doc structure
2280  ** contains the parsed report request body.
2281  ** Returns 0 if the Label header is not allowed.
2282  */
2284 
2285  /*
2286  ** Generate a report on a resource. Since a provider is free
2287  ** to define its own reports, and the value of request headers
2288  ** may affect the interpretation of a report, the request record
2289  ** must be passed to this routine.
2290  **
2291  ** The dav_xml_doc structure contains the parsed report request
2292  ** body. The report response should be generated into the specified
2293  ** output filter.
2294  **
2295  ** If an error occurs, and a response has not yet been generated,
2296  ** then an error can be returned from this function. mod_dav will
2297  ** construct an appropriate error response. Once some output has
2298  ** been placed into the filter, however, the provider should not
2299  ** return an error -- there is no way that mod_dav can deliver it
2300  ** properly.
2301  **
2302  ** ### maybe we need a way to signal an error anyways, and then
2303  ** ### apache can abort the connection?
2304  **
2305  ** API ISSUE: don't use the passed-in 'output' filter.
2306  **
2307  ** Instead, generate the response into the output filter stack for the
2308  ** request (r->output_filters). An implementation can use the request_rec
2309  ** that was passed to get_resource() for this purpose. Using 'output'
2310  ** filter for the response can cause unbounded memory usage.
2311  **
2312  ** See https://mail-archives.apache.org/mod_mbox/httpd-dev/201608.mbox/%3C20160822151917.GA22369%40redhat.com%3E
2313  */
2314  dav_error * (*deliver_report)(request_rec *r,
2315  const dav_resource *resource,
2316  const apr_xml_doc *doc,
2317  ap_filter_t *output);
2318 
2319  /*
2320  ** OPTIONAL HOOKS
2321  ** The following hooks are optional; if not defined, then the
2322  ** corresponding protocol methods will be unsupported.
2323  */
2324 
2325  /*
2326  ** Set the state of a checked-in version-controlled resource.
2327  **
2328  ** If the request specified a version, the version resource
2329  ** represents that version. If the request specified a label,
2330  ** then "version" is NULL, and "label" is the label.
2331  **
2332  ** The depth argument is ignored for a file, and can be 0, 1, or
2333  ** DAV_INFINITY for a collection. The depth argument only applies
2334  ** with a label, not a version.
2335  **
2336  ** If an error occurs in a child resource, then the return value is
2337  ** non-NULL, and *response is set to a multistatus response.
2338  **
2339  ** This hook is optional; if not defined, then the UPDATE method
2340  ** will not be supported.
2341  */
2342  dav_error * (*update)(const dav_resource *resource,
2343  const dav_resource *version,
2344  const char *label,
2345  int depth,
2346  dav_response **response);
2347 
2348  /*
2349  ** Add a label to a version. The resource is either a specific
2350  ** version, or a version selector, in which case the label should
2351  ** be added to the current target of the version selector. The
2352  ** version selector cannot be checked out.
2353  **
2354  ** If replace != 0, any existing label by the same name is
2355  ** effectively deleted first. Otherwise, it is an error to
2356  ** attempt to add a label which already exists on some version
2357  ** of the same history resource.
2358  **
2359  ** This hook is optional; if not defined, then the LABEL method
2360  ** will not be supported. If it is defined, then the remove_label
2361  ** hook must be defined also.
2362  */
2363  dav_error * (*add_label)(const dav_resource *resource,
2364  const char *label,
2365  int replace);
2366 
2367  /*
2368  ** Remove a label from a version. The resource is either a specific
2369  ** version, or a version selector, in which case the label should
2370  ** be added to the current target of the version selector. The
2371  ** version selector cannot be checked out.
2372  **
2373  ** It is an error if no such label exists on the specified version.
2374  **
2375  ** This hook is optional, but if defined, the add_label hook
2376  ** must be defined also.
2377  */
2378  dav_error * (*remove_label)(const dav_resource *resource,
2379  const char *label);
2380 
2381  /*
2382  ** Determine whether a null resource can be created as a workspace.
2383  ** The provider may restrict workspaces to certain locations.
2384  ** Returns 0 if the resource cannot be a workspace.
2385  **
2386  ** This hook is optional; if the provider does not support workspaces,
2387  ** it should be set to NULL.
2388  */
2390 
2391  /*
2392  ** Create a workspace resource. The resource must not already
2393  ** exist. Any <DAV:mkworkspace> element is passed to the provider
2394  ** in the "doc" structure; it may be empty.
2395  **
2396  ** If workspace creation is successful, the state of the resource
2397  ** object is updated appropriately.
2398  **
2399  ** This hook is optional; if the provider does not support workspaces,
2400  ** it should be set to NULL.
2401  */
2402  dav_error * (*make_workspace)(dav_resource *resource,
2403  apr_xml_doc *doc);
2404 
2405  /*
2406  ** Determine whether a null resource can be created as an activity.
2407  ** The provider may restrict activities to certain locations.
2408  ** Returns 0 if the resource cannot be an activity.
2409  **
2410  ** This hook is optional; if the provider does not support activities,
2411  ** it should be set to NULL.
2412  */
2414 
2415  /*
2416  ** Create an activity resource. The resource must not already
2417  ** exist.
2418  **
2419  ** If activity creation is successful, the state of the resource
2420  ** object is updated appropriately.
2421  **
2422  ** This hook is optional; if the provider does not support activities,
2423  ** it should be set to NULL.
2424  */
2425  dav_error * (*make_activity)(dav_resource *resource);
2426 
2427  /*
2428  ** Merge a resource (tree) into target resource (tree).
2429  **
2430  ** ### more doc...
2431  **
2432  ** This hook is optional; if the provider does not support merging,
2433  ** then this should be set to NULL.
2434  **
2435  ** API ISSUE: don't use the passed-in 'output' filter.
2436  **
2437  ** Instead, generate the response into the output filter stack for the
2438  ** request (r->output_filters). An implementation can use the request_rec
2439  ** that was passed to get_resource() for this purpose. Using 'output'
2440  ** filter for the response can cause unbounded memory usage.
2441  **
2442  ** See https://mail-archives.apache.org/mod_mbox/httpd-dev/201608.mbox/%3C20160822151917.GA22369%40redhat.com%3E
2443  */
2444  dav_error * (*merge)(dav_resource *target, dav_resource *source,
2445  int no_auto_merge, int no_checkout,
2446  apr_xml_elem *prop_elem,
2447  ap_filter_t *output);
2448 
2449  /*
2450  ** If a provider needs a context to associate with this hooks structure,
2451  ** then this field may be used. In most cases, it will just be NULL.
2452  */
2453  void *ctx;
2454 };
2455 
2456 
2457 /* --------------------------------------------------------------------
2458 **
2459 ** BINDING FUNCTIONS
2460 */
2461 
2462 /* binding provider hooks */
2464 
2465  /* Determine whether a resource can be the target of a binding.
2466  * Returns 0 if the resource cannot be a binding target.
2467  */
2469 
2470  /* Create a binding to a resource.
2471  * The resource argument is the target of the binding;
2472  * the binding argument must be a resource which does not already
2473  * exist.
2474  */
2475  dav_error * (*bind_resource)(const dav_resource *resource,
2476  dav_resource *binding);
2477 
2478  /*
2479  ** If a provider needs a context to associate with this hooks structure,
2480  ** then this field may be used. In most cases, it will just be NULL.
2481  */
2482  void *ctx;
2483 
2484 };
2485 
2486 
2487 /* --------------------------------------------------------------------
2488 **
2489 ** SEARCH(DASL) FUNCTIONS
2490 */
2491 
2492 /* search provider hooks */
2494  /* Set header for a OPTION method
2495  * An error may be returned.
2496  * To set a hadder, this function might call
2497  * apr_table_setn(r->headers_out, "DASL", dasl_optin1);
2498  *
2499  * Examples:
2500  * DASL: <DAV:basicsearch>
2501  * DASL: <http://foo.bar.com/syntax1>
2502  * DASL: <http://akuma.com/syntax2>
2503  */
2504  dav_error * (*set_option_head)(request_rec *r);
2505 
2506  /* Search resources
2507  * An error may be returned. *response will contain multistatus
2508  * responses (if any) suitable for the body of the error. It is also
2509  * possible to return NULL, yet still have multistatus responses.
2510  * In this case, typically the caller should return a 207 (Multistatus)
2511  * and the responses (in the body) as the HTTP response.
2512  */
2513  dav_error * (*search_resource)(request_rec *r,
2514  dav_response **response);
2515 
2516  /*
2517  ** If a provider needs a context to associate with this hooks structure,
2518  ** then this field may be used. In most cases, it will just be NULL.
2519  */
2520  void *ctx;
2521 
2522 };
2523 
2524 
2525 /* --------------------------------------------------------------------
2526 **
2527 ** MISCELLANEOUS STUFF
2528 */
2529 
2530 typedef struct {
2531  int propid; /* live property ID */
2532  const dav_hooks_liveprop *provider; /* the provider defining this prop */
2534 
2535 
2536 /* --------------------------------------------------------------------
2537 **
2538 ** DAV ACL HOOKS
2539 */
2540 
2542 {
2543  dav_error * (*acl_check_method)(request_rec *r,
2544  const dav_resource *resource);
2545 
2546  dav_error * (*acl_check_read)(request_rec *r,
2547  const dav_resource *resource);
2548 
2549  dav_error * (*acl_check_prop)(request_rec *r,
2550  const dav_resource *resource,
2551  const dav_prop_name *name,
2553 
2555  const dav_resource *resource,
2556  int new_resource_created);
2557  void *ctx;
2558 };
2559 
2560 DAV_DECLARE(void) dav_acl_provider_register(apr_pool_t *p,
2562 
2563 DAV_DECLARE(const dav_acl_provider *) dav_get_acl_providers(void);
2564 
2565 
2566 /* --------------------------------------------------------------------
2567 **
2568 ** DAV OPTIONS
2569 */
2570 #define DAV_OPTIONS_EXTENSION_GROUP "dav_options"
2571 
2572 typedef struct dav_options_provider
2573 {
2574  dav_error* (*dav_header)(request_rec *r,
2575  const dav_resource *resource,
2577 
2578  dav_error* (*dav_method)(request_rec *r,
2579  const dav_resource *resource,
2581 
2582  void *ctx;
2584 
2585 extern DAV_DECLARE(const dav_options_provider *) dav_get_options_providers(const char *name);
2586 
2587 extern DAV_DECLARE(void) dav_options_provider_register(apr_pool_t *p,
2588  const char *name,
2590 
2591 /* --------------------------------------------------------------------
2592 **
2593 ** DAV RESOURCE TYPE HOOKS
2594 */
2595 
2597 {
2598  int (*get_resource_type)(const dav_resource *resource,
2599  const char **name,
2600  const char **uri);
2602 
2603 #define DAV_RESOURCE_TYPE_GROUP "dav_resource_type"
2604 
2605 DAV_DECLARE(void) dav_resource_type_provider_register(apr_pool_t *p,
2606  const char *name,
2608 
2609 DAV_DECLARE(const dav_resource_type_provider *) dav_get_resource_type_providers(const char *name);
2610 
2611 #ifdef __cplusplus
2612 }
2613 #endif
2614 
2615 #endif /* _MOD_DAV_H_ */
2616 
const dav_hooks_propdb * propdb
Definition: mod_dav.h:664
size_t apr_size_t
Definition: apr.h:375
struct dav_if_state_list * state
Definition: mod_dav.h:791
dav_response * response
Definition: mod_dav.h:1705
dav_buffer work_buf
Definition: mod_dav.h:1764
void(* close)(dav_db *db)
Definition: mod_dav.h:1116
Definition: mod_dav.h:1062
apr_text * propstats
Definition: mod_dav.h:490
#define DAV_DECLARE_NONSTD(type)
Definition: mod_dav.h:86
Definition: mod_dav.h:1053
Definition: mod_dav.h:508
struct dav_if_header * next
Definition: mod_dav.h:792
void * ctx
Definition: mod_dav.h:923
dav_buffer * pbuf
Definition: mod_dav.h:457
struct dav_lockdb_private dav_lockdb_private
Definition: mod_dav.h:1228
const dav_hooks_repository * repos
Definition: mod_dav.h:663
Definition: mod_dav.h:1039
Definition: apr_xml.h:200
Definition: mod_dav.h:662
const char *const * namespace_uris
Definition: mod_dav.h:862
Definition: mod_dav.h:1041
struct dav_prop_ctx dav_prop_ctx
Definition: apr_tables.h:62
void * liveprop_ctx
Definition: mod_dav.h:1664
const dav_resource dav_lockdb const apr_xml_doc dav_lock ** lock_request
Definition: mod_dav.h:1324
int versioned
Definition: mod_dav.h:398
Definition: mod_dav.h:769
void * ctx
Definition: mod_dav.h:2453
APR-UTIL DBM library.
Definition: mod_dav.h:1072
const char const char apr_text_header * body
Definition: mod_dav.h:1611
void(* get_vsn_options)(apr_pool_t *p, apr_text_header *phdr)
Definition: mod_dav.h:2171
Definition: mod_dav.h:1793
const dav_acl_provider * acls
Definition: mod_dav.h:423
const dav_resource * resrouce
Definition: mod_dav.h:1324
Definition: mod_dav.h:305
Definition: mod_dav.h:2493
dav_resource int undo
Definition: mod_dav.h:2139
Definition: mod_dav.h:1045
apr_pool_t * scratchpool
Definition: mod_dav.h:1744
Definition: mod_dav.h:1688
apr_array_header_t * prop_ctx
Definition: mod_dav.h:575
Definition: mod_dav.h:1049
The representation of a filter chain.
Definition: util_filter.h:278
Definition: mod_dav.h:1375
const dav_resource * root
Definition: mod_dav.h:1724
const char * uri
Definition: mod_dav.h:789
Definition: mod_dav.h:299
Definition: mod_dav.h:601
int operation
Definition: mod_dav.h:1657
dav_lock_type
Definition: mod_dav.h:1254
int(* can_be_workspace)(const dav_resource *resource)
Definition: mod_dav.h:2389
apr_bucket_brigade request_rec apr_pool_t * pool
Definition: mod_dav.h:552
Definition: mod_dav.h:1061
Definition: mod_dav.h:1295
int propid
Definition: mod_dav.h:2531
void * ctx
Definition: mod_dav.h:2520
void * ctx
Definition: mod_dav.h:670
Definition: mod_dav.h:1038
const dav_resource dav_lockdb dav_lock * request
Definition: mod_dav.h:1332
int propfind_type
Definition: mod_dav.h:1750
dav_auto_version
Definition: mod_dav.h:2080
Definition: mod_dav.h:1651
Definition: mod_dav.h:1048
void * ctx
Definition: mod_dav.h:2034
Definition: mod_dav.h:1058
Definition: apr_xml.h:162
Definition: mod_dav.h:2541
Apache XML library.
struct dav_error * prev
Definition: mod_dav.h:131
dav_lockdb const dav_resource int apr_array_header_t dav_propdb ** propdb
Definition: mod_dav.h:1593
const char * desc
Definition: mod_dav.h:124
Definition: mod_dav.h:532
Definition: mod_dav.h:1071
Definition: mod_dav.h:1028
apr_text * xmlns
Definition: mod_dav.h:491
dav_resource_type
Definition: mod_dav.h:296
int parent_checkedout
Definition: mod_dav.h:2094
APR Hash Tables.
struct dav_rollback_item * rollback
Definition: mod_dav.h:1665
int dummy_header
Definition: mod_dav.h:794
Definition: mod_dav.h:1030
Definition: mod_dav.h:1067
Definition: mod_dav.h:309
Definition: mod_dav.h:1033
struct dav_resource_type_provider dav_resource_type_provider
Definition: mod_dav.h:2596
Definition: mod_dav.h:528
apr_pool_t * pool
Definition: mod_dav.h:421
Definition: mod_dav.h:389
Definition: mod_dav.h:1050
Definition: mod_dav.h:303
Definition: mod_dav.h:1693
Definition: mod_dav.h:2463
int(* exists)(dav_db *db, const dav_prop_name *name)
Definition: mod_dav.h:1183
apr_hash_t * prefix_uri
Definition: mod_dav.h:604
dav_locktoken_list ** ltl
Definition: mod_dav.h:804
Definition: mod_dav.h:1037
Definition: mod_dav.h:1112
const char * name
Definition: mod_dav.h:938
const dav_hooks_search * search
Definition: mod_dav.h:668
const dav_resource const dav_locktoken * locktoken
Definition: mod_dav.h:1329
void * ctx
Definition: mod_dav.h:425
Definition: apr_xml.h:53
int count
Definition: mod_dav.h:605
apr_pool_t int strip_white
Definition: mod_dav.h:587
apr_pool_t * pool
Definition: mod_dav.h:1721
const char const char * uri
Definition: mod_dav.h:614
int baselined
Definition: mod_dav.h:402
dav_lock * locks
Definition: mod_dav.h:1319
Definition: mod_dav.h:1026
void * ctx
Definition: mod_dav.h:2582
Definition: apr_buckets.h:258
int skip_root
Definition: mod_dav.h:1760
const char * nmspace
Definition: mod_dav.h:2151
dav_if_state_type
Definition: mod_dav.h:766
const char * name
Definition: mod_dav.h:1108
const char * prefix
Definition: mod_dav.h:614
Definition: mod_dav.h:1065
Definition: mod_dav.h:525
Definition: mod_dav.h:2083
apr_xml_doc * doc
Definition: mod_dav.h:1749
int is_liveprop
Definition: mod_dav.h:1663
struct dav_if_state_list * next
Definition: mod_dav.h:784
Definition: mod_dav.h:1792
Definition: mod_dav.h:770
dav_lockdb const dav_resource int int depth
Definition: mod_dav.h:1336
Definition: mod_dav.h:1044
Definition: mod_dav.h:1803
request_rec * r
Definition: mod_dav.h:1746
int dav_get_props_result * propstats
Definition: mod_dav.h:1769
Definition: mod_dav.h:1055
dav_buffer apr_size_t size
Definition: mod_dav.h:457
request_rec int apr_array_header_t * namespaces
Definition: mod_dav.h:562
Definition: mod_dav.h:1051
Definition: mod_dav.h:1023
Definition: mod_dav.h:815
int int apr_status_t const char * desc
Definition: mod_dav.h:141
void * ctx
Definition: mod_dav.h:2557
void * ctx
Definition: mod_dav.h:1573
const char * name
Definition: mod_dav.h:2152
Definition: mod_dav.h:1063
Definition: mod_dav.h:1239
Definition: mod_dav.h:1255
Definition: mod_dav.h:2091
apr_bucket_brigade * bb
Definition: mod_dav.h:552
dav_lock_rectype
Definition: mod_dav.h:1259
const dav_lock * lock
Definition: mod_dav.h:1759
struct dav_walker_ctx dav_walker_ctx
Definition: mod_dav.h:936
HTTP Daemon routines.
apr_size_t alloc_len
Definition: mod_dav.h:449
Apache hook functions.
request_rec * r
Definition: mod_dav.h:1670
Definition: mod_dav.h:1046
apr_text * propstat_404
Definition: mod_dav.h:1755
int int apr_status_t aprerr
Definition: mod_dav.h:141
int(* is_same_resource)(const dav_resource *res1, const dav_resource *res2)
Definition: mod_dav.h:1860
Definition: mod_dav.h:1260
int int error_id
Definition: mod_dav.h:141
const char * etag
Definition: mod_dav.h:781
Definition: mod_dav.h:2082
int
Definition: mod_proxy.h:626
dav_lock_rectype rectype
Definition: mod_dav.h:1297
Definition: mod_dav.h:2530
struct dav_options_provider dav_options_provider
Definition: mod_dav.h:488
Definition: mod_dav.h:1075
Definition: mod_dav.h:1690
Definition: mod_dav.h:1024
Definition: mod_dav.h:1732
const dav_acl_provider * acl
Definition: mod_dav.h:2561
#define APR_DECLARE_EXTERNAL_HOOK(ns, link, ret, name, args)
Definition: apr_hooks.h:118
struct dav_db dav_db
Definition: mod_dav.h:1102
int(* versionable)(const dav_resource *resource)
Definition: mod_dav.h:2185
const char * childtags
Definition: mod_dav.h:133
dav_buffer const void apr_size_t amt
Definition: mod_dav.h:477
apr_xml_elem * prop
Definition: mod_dav.h:1655
dav_error * src
Definition: mod_dav.h:186
dav_error * err
Definition: mod_dav.h:203
const char const dav_liveprop_group * group
Definition: mod_dav.h:960
int error_id
Definition: mod_dav.h:123
int(* is_bindable)(const dav_resource *resource)
Definition: mod_dav.h:2468
APR Table library.
apr_bucket_brigade * bb
Definition: mod_dav.h:1741
struct dav_stream dav_stream
Definition: mod_dav.h:1789
dav_lockdb const dav_resource int apr_array_header_t * ns_xlate
Definition: mod_dav.h:1593
time_t timeout
Definition: mod_dav.h:1305
void * walk_ctx
Definition: mod_dav.h:1696
Definition: mod_dav.h:1064
const char const char * propname
Definition: mod_dav.h:1611
const dav_resource * resource
Definition: mod_dav.h:1702
dav_if_state_type type
Definition: mod_dav.h:775
dav_lockdb const dav_resource int resource_state
Definition: mod_dav.h:1336
Definition: mod_dav.h:1106
int flags
Definition: mod_dav.h:1762
apr_size_t uri_len
Definition: mod_dav.h:790
Definition: mod_dav.h:1056
const dav_locktoken * locktoken
Definition: mod_dav.h:1758
Definition: mod_dav.h:2081
int dav_response * first
Definition: mod_dav.h:570
Definition: mod_dav.h:1025
dav_lockdb_private * info
Definition: mod_dav.h:1244
Definition: mod_dav.h:1059
Definition: mod_dav.h:773
const dav_hooks_liveprop * provider
Definition: mod_dav.h:2532
dav_locktoken * locktoken
Definition: mod_dav.h:782
dav_propdb * propdb
Definition: mod_dav.h:1653
int status
Definition: mod_dav.h:122
Definition: mod_dav.h:1256
struct dav_if_header dav_if_header
char * buf
Definition: mod_dav.h:451
namespace const char * tagname
Definition: mod_dav.h:153
Definition: mod_dav.h:1052
dav_resource_type type
Definition: mod_dav.h:390
#define DAV_DECLARE(type)
Definition: mod_dav.h:85
int is_locknull
Definition: mod_dav.h:1298
dav_auto_version(* auto_versionable)(const dav_resource *resource)
Definition: mod_dav.h:2196
struct dav_liveprop_rollback dav_liveprop_rollback
Definition: mod_dav.h:813
const char * desc
Definition: mod_dav.h:498
struct apr_hash_t apr_hash_t
Definition: apr_hash.h:52
dav_error dav_response * response
Definition: mod_dav.h:203
const dav_liveprop_group const dav_liveprop_spec ** info
Definition: mod_dav.h:966
Definition: mod_dav.h:311
Definition: mod_dav.h:1036
Definition: mod_dav.h:1250
dav_buffer apr_size_t extra_needed
Definition: mod_dav.h:465
Definition: mod_dav.h:787
Definition: mod_dav.h:1060
request_rec int must_be_absolute
Definition: mod_dav.h:515
apr_pool_t * p
struct dav_if_state_list dav_if_state_list
int resource_versioned
Definition: mod_dav.h:2092
const dav_locktoken * locktoken
Definition: mod_dav.h:1307
Definition: mod_dav.h:1057
dav_hooks_propdb dav_hooks_db
Definition: mod_dav.h:276
int ro
Definition: mod_dav.h:1242
Definition: mod_dav.h:1689
const char * uri
Definition: mod_dav.h:410
int working
Definition: mod_dav.h:406
dav_stream_mode
Definition: mod_dav.h:1791
dav_lock_scope
Definition: mod_dav.h:1248
struct dav_lock_private dav_lock_private
Definition: mod_dav.h:1233
int is_writable
Definition: mod_dav.h:942
const char const dav_provider * hooks
Definition: mod_dav.h:726
const char const dav_options_provider * provider
Definition: mod_dav.h:2588
Definition: mod_dav.h:297
struct dav_lock * next
Definition: mod_dav.h:1314
dav_resource int dav_auto_version_info * av_info
Definition: mod_dav.h:2118
dav_lock_type type
Definition: mod_dav.h:1303
struct dav_propdb dav_propdb
Definition: mod_dav.h:1588
dav_resource_private * info
Definition: mod_dav.h:414
struct dav_namespace_map dav_namespace_map
Definition: mod_dav.h:1103
Definition: mod_dav.h:1027
void(* acl_post_processing)(request_rec *r, const dav_resource *resource, int new_resource_created)
Definition: mod_dav.h:2554
int ns
Definition: mod_dav.h:937
apr_hash_t * uri_prefix
Definition: mod_dav.h:603
Definition: mod_dav.h:1073
struct dav_error dav_error
struct dav_resource_private dav_resource_private
Definition: mod_dav.h:320
Definition: mod_dav.h:1066
struct dav_deadprop_rollback dav_deadprop_rollback
Definition: mod_dav.h:1104
Definition: mod_dav.h:1262
const dav_resource dav_lockdb * lockdb
Definition: mod_dav.h:1324
const dav_liveprop_spec * specs
Definition: mod_dav.h:953
A structure that represents the current request.
Definition: httpd.h:811
Definition: mod_dav.h:1054
Definition: mod_dav.h:1709
const dav_resource dav_lockdb const apr_xml_doc * doc
Definition: mod_dav.h:1324
Definition: mod_dav.h:121
Apache filter library.
int status
Definition: mod_dav.h:503
const char * ns
Definition: mod_dav.h:1107
dav_buffer const void apr_size_t apr_size_t pad
Definition: mod_dav.h:477
int condition
Definition: mod_dav.h:777
apr_status_t aprerr
Definition: mod_dav.h:126
apr_pool_t * pool
Definition: mod_dav.h:602
const dav_hooks_binding * binding
Definition: mod_dav.h:667
const dav_if_header * if_header
Definition: mod_dav.h:1757
Definition: mod_dav.h:1020
int(* can_be_activity)(const dav_resource *resource)
Definition: mod_dav.h:2413
void * ctx
Definition: mod_dav.h:1211
struct dav_resource dav_resource
apr_size_t cur_len
Definition: mod_dav.h:450
struct dav_locktoken dav_locktoken
Definition: mod_dav.h:434
const char *const * namespace_uris
Definition: mod_dav.h:954
int depth
Definition: mod_dav.h:1304
dav_buffer const char * str
Definition: mod_dav.h:461
dav_error err
Definition: mod_dav.h:511
const dav_resource * resource
Definition: mod_dav.h:994
int status
Definition: mod_dav.h:141
const dav_resource dav_prop_insert what
Definition: mod_dav.h:994
int int const char dav_error * prev
Definition: mod_dav.h:170
Definition: mod_dav.h:1070
dav_buffer const void * mem
Definition: mod_dav.h:477
dav_resource * parent_resource
Definition: mod_dav.h:2095
dav_lockdb const dav_resource int ro
Definition: mod_dav.h:1593
const char * name
Definition: mod_dav.h:726
dav_lock_scope scope
Definition: mod_dav.h:1302
Definition: apr_xml.h:64
const dav_hooks_repository * hooks
Definition: mod_dav.h:416
dav_walk_params w
Definition: mod_dav.h:1735
const char * tagname
Definition: mod_dav.h:128
int handle_get
Definition: mod_dav.h:1811
int walk_type
Definition: mod_dav.h:1711
struct apr_pool_t apr_pool_t
Definition: apr_pools.h:60
Definition: mod_dav.h:1029
struct dav_locktoken_list * next
Definition: mod_dav.h:800
typedef void(APR_THREAD_FUNC *PFN_HSE_IO_COMPLETION)(EXTENSION_CONTROL_BLOCK *ecb
const dav_hooks_vsn * vsn
Definition: mod_dav.h:666
int apr_status_t
Definition: apr_errno.h:44
int collection
Definition: mod_dav.h:394
request_rec * out_req
Definition: mod_dav.h:2056
request_rec * r
Definition: mod_dav.h:515
dav_get_props_result propresult
Definition: mod_dav.h:501
Definition: mod_dav.h:952
dav_lockdb * lockdb
Definition: mod_dav.h:1727
request_rec * rnew
Definition: mod_dav.h:510
Definition: mod_dav.h:520
Definition: mod_dav.h:1031
void * walk_ctx
Definition: mod_dav.h:1718
void * ctx
Definition: mod_dav.h:2482
const dav_hooks_liveprop * hooks
Definition: mod_dav.h:955
dav_resource int parent_only
Definition: mod_dav.h:2118
Definition: mod_dav.h:313
struct dav_response * next
Definition: mod_dav.h:505
Definition: mod_dav.h:530
apr_text_header * phdr
Definition: mod_dav.h:632
int def_depth
Definition: mod_dav.h:579
Definition: mod_dav.h:1249
dav_prop_insert
Definition: mod_dav.h:519
Definition: mod_dav.h:1047
Definition: mod_dav.h:1032
struct dav_locktoken_list dav_locktoken_list
int propid
Definition: mod_dav.h:940
const dav_hooks_locks * locks
Definition: mod_dav.h:665
int exists
Definition: mod_dav.h:392
apr_pool_t * pool
Definition: mod_dav.h:1699
Definition: mod_dav.h:1261
Definition: mod_dav.h:1251
int(* report_label_header_allowed)(const apr_xml_doc *doc)
Definition: mod_dav.h:2283
const dav_hooks_locks * hooks
Definition: mod_dav.h:1241
Definition: mod_dav.h:2572
dav_error * err
Definition: mod_dav.h:1667
Definition: mod_dav.h:768
const char * auth_user
Definition: mod_dav.h:1310
const char * href
Definition: mod_dav.h:497
dav_resource int dav_locktoken dav_response int flags
Definition: mod_dav.h:1346
Definition: mod_dav.h:495
int resource_checkedout
Definition: mod_dav.h:2093
int(* is_parent_resource)(const dav_resource *res1, const dav_resource *res2)
Definition: mod_dav.h:1870
dav_lock_private * info
Definition: mod_dav.h:1312
struct dav_lock dav_lock
Definition: mod_dav.h:307
Definition: mod_dav.h:797
dav_resource int int unlock
Definition: mod_dav.h:2139
off_t apr_off_t
Definition: apr.h:377
Definition: mod_dav.h:1040
dav_locktoken * locktoken
Definition: mod_dav.h:799
const char * ns_uri
Definition: mod_dav.h:989
Definition: mod_dav.h:2157
Definition: mod_dav.h:447
const char * owner
Definition: mod_dav.h:1309
Definition: mod_dav.h:2150