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
8
* http://www.apache.org/licenses/LICENSE-2.0
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.
19
* @brief DAV extension module for Apache 2.0.*
21
* @defgroup MOD_DAV mod_dav
22
* @ingroup APACHE_MODS
29
#include "apr_hooks.h"
32
#include "apr_tables.h"
35
#include "util_filter.h"
38
#include <limits.h> /* for INT_MAX */
39
#include <time.h> /* for time_t */
46
#define DAV_VERSION AP_SERVER_BASEREVISION
48
#define DAV_XML_HEADER "<?xml version=\"1.0\" encoding=\"utf-8\"?>"
49
#define DAV_XML_CONTENT_TYPE "text/xml; charset=\"utf-8\""
51
#define DAV_READ_BLOCKSIZE 2048 /* used for reading input blocks */
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"
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)
79
#define DAV_INFINITY INT_MAX /* for the Depth: header */
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
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)
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)
102
/* --------------------------------------------------------------------
108
** dav_error structure.
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.
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.
116
** Note: this implies that status != 0 whenever an error occurs.
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.
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 */
126
int save_errno; /* copy of errno causing the error */
128
const char *namespace; /* [optional] namespace of error */
129
const char *tagname; /* name of error-tag */
131
struct dav_error *prev; /* previous error (in stack) */
136
** Create a new error structure. save_errno will be filled with the current
139
DAV_DECLARE(dav_error*) dav_new_error(apr_pool_t *p, int status,
140
int error_id, const char *desc);
144
** Create a new error structure with tagname and (optional) namespace;
145
** namespace may be NULL, which means "DAV:". save_errno will be
146
** filled with the current errno value.
148
DAV_DECLARE(dav_error*) dav_new_error_tag(apr_pool_t *p, int status,
149
int error_id, const char *desc,
150
const char *namespace,
151
const char *tagname);
155
** Push a new error description onto the stack of errors.
157
** This function is used to provide an additional description to an existing
160
** <status> should contain the caller's view of what the current status is,
161
** given the underlying error. If it doesn't have a better idea, then the
162
** caller should pass prev->status.
164
** <error_id> can specify a new error_id since the topmost description has
167
DAV_DECLARE(dav_error*) dav_push_error(apr_pool_t *p, int status, int error_id,
168
const char *desc, dav_error *prev);
171
/* error ID values... */
173
/* IF: header errors */
174
#define DAV_ERR_IF_PARSE 100 /* general parsing error */
175
#define DAV_ERR_IF_MULTIPLE_NOT 101 /* multiple "Not" found */
176
#define DAV_ERR_IF_UNK_CHAR 102 /* unknown char in header */
177
#define DAV_ERR_IF_ABSENT 103 /* no locktokens given */
178
#define DAV_ERR_IF_TAGGED 104 /* in parsing tagged-list */
179
#define DAV_ERR_IF_UNCLOSED_PAREN 105 /* in no-tagged-list */
182
#define DAV_ERR_PROP_BAD_MAJOR 200 /* major version was wrong */
183
#define DAV_ERR_PROP_READONLY 201 /* prop is read-only */
184
#define DAV_ERR_PROP_NO_DATABASE 202 /* writable db not avail */
185
#define DAV_ERR_PROP_NOT_FOUND 203 /* prop not found */
186
#define DAV_ERR_PROP_BAD_LOCKDB 204 /* could not open lockdb */
187
#define DAV_ERR_PROP_OPENING 205 /* problem opening propdb */
188
#define DAV_ERR_PROP_EXEC 206 /* problem exec'ing patch */
190
/* Predefined DB errors */
191
/* ### any to define?? */
193
/* Predefined locking system errors */
194
#define DAV_ERR_LOCK_OPENDB 400 /* could not open lockdb */
195
#define DAV_ERR_LOCK_NO_DB 401 /* no database defined */
196
#define DAV_ERR_LOCK_CORRUPT_DB 402 /* DB is corrupt */
197
#define DAV_ERR_LOCK_UNK_STATE_TOKEN 403 /* unknown State-token */
198
#define DAV_ERR_LOCK_PARSE_TOKEN 404 /* bad opaquelocktoken */
199
#define DAV_ERR_LOCK_SAVE_LOCK 405 /* err saving locks */
202
** Some comments on Error ID values:
204
** The numbers do not necessarily need to be unique. Uniqueness simply means
205
** that two errors that have not been predefined above can be distinguished
206
** from each other. At the moment, mod_dav does not use this distinguishing
207
** feature, but it could be used in the future to collapse <response> elements
208
** into groups based on the error ID (and associated responsedescription).
210
** If a compute_desc is provided, then the error ID should be unique within
211
** the context of the compute_desc function (so the function can figure out
212
** what to filled into the desc).
214
** Basically, subsystems can ignore defining new error ID values if they want
215
** to. The subsystems *do* need to return the predefined errors when
216
** appropriate, so that mod_dav can figure out what to do. Subsystems can
217
** simply leave the error ID field unfilled (zero) if there isn't an error
218
** that must be placed there.
222
/* --------------------------------------------------------------------
226
** These are here for forward-declaration purposes. For more info, see
227
** the section title "HOOK HANDLING" for more information, plus each
228
** structure definition.
231
/* forward-declare this structure */
232
typedef struct dav_hooks_propdb dav_hooks_propdb;
233
typedef struct dav_hooks_locks dav_hooks_locks;
234
typedef struct dav_hooks_vsn dav_hooks_vsn;
235
typedef struct dav_hooks_repository dav_hooks_repository;
236
typedef struct dav_hooks_liveprop dav_hooks_liveprop;
237
typedef struct dav_hooks_binding dav_hooks_binding;
238
typedef struct dav_hooks_search dav_hooks_search;
240
/* ### deprecated name */
241
typedef dav_hooks_propdb dav_hooks_db;
244
/* --------------------------------------------------------------------
251
** The base protocol defines only file and collection resources.
252
** The versioning protocol defines several additional resource types
253
** to represent artifacts of a version control system.
255
** This enumeration identifies the type of URL used to identify the
256
** resource. Since the same resource may have more than one type of
257
** URL which can identify it, dav_resource_type cannot be used
258
** alone to determine the type of the resource; attributes of the
259
** dav_resource object must also be consulted.
262
DAV_RESOURCE_TYPE_UNKNOWN,
264
DAV_RESOURCE_TYPE_REGULAR, /* file or collection; could be
265
* unversioned, or version selector,
266
* or baseline selector */
268
DAV_RESOURCE_TYPE_VERSION, /* version or baseline URL */
270
DAV_RESOURCE_TYPE_HISTORY, /* version or baseline history URL */
272
DAV_RESOURCE_TYPE_WORKING, /* working resource URL */
274
DAV_RESOURCE_TYPE_WORKSPACE, /* workspace URL */
276
DAV_RESOURCE_TYPE_ACTIVITY, /* activity URL */
278
DAV_RESOURCE_TYPE_PRIVATE /* repository-private type */
283
** Opaque, repository-specific information for a resource.
285
typedef struct dav_resource_private dav_resource_private;
288
** Resource descriptor, generated by a repository provider.
290
** Note: the lock-null state is not explicitly represented here,
291
** since it may be expensive to compute. Use dav_get_resource_state()
292
** to determine whether a non-existent resource is a lock-null resource.
294
** A quick explanation of how the flags can apply to different resources:
296
** unversioned file or collection:
297
** type = DAV_RESOURCE_TYPE_REGULAR
298
** exists = ? (1 if exists)
299
** collection = ? (1 if collection)
304
** version-controlled resource or configuration:
305
** type = DAV_RESOURCE_TYPE_REGULAR
307
** collection = ? (1 if collection)
309
** baselined = ? (1 if configuration)
310
** working = ? (1 if checked out)
312
** version/baseline history:
313
** type = DAV_RESOURCE_TYPE_HISTORY
321
** type = DAV_RESOURCE_TYPE_VERSION
323
** collection = ? (1 if collection)
325
** baselined = ? (1 if baseline)
329
** type = DAV_RESOURCE_TYPE_WORKING
331
** collection = ? (1 if collection)
337
** type = DAV_RESOURCE_TYPE_WORKSPACE
338
** exists = ? (1 if exists)
340
** versioned = ? (1 if version-controlled)
341
** baselined = ? (1 if baseline-controlled)
342
** working = ? (1 if checked out)
345
** type = DAV_RESOURCE_TYPE_ACTIVITY
346
** exists = ? (1 if exists)
352
typedef struct dav_resource {
353
dav_resource_type type;
355
int exists; /* 0 => null resource */
357
int collection; /* 0 => file; can be 1 for
358
* REGULAR, VERSION, and WORKING resources,
359
* and is always 1 for WORKSPACE */
361
int versioned; /* 0 => unversioned; can be 1 for
362
* REGULAR and WORKSPACE resources,
363
* and is always 1 for VERSION and WORKING */
365
int baselined; /* 0 => not baselined; can be 1 for
366
* REGULAR, VERSION, and WORKSPACE resources;
367
* versioned == 1 when baselined == 1 */
369
int working; /* 0 => not checked out; can be 1 for
370
* REGULAR and WORKSPACE resources,
371
* and is always 1 for WORKING */
373
const char *uri; /* the URI for this resource */
375
dav_resource_private *info; /* the provider's private info */
377
const dav_hooks_repository *hooks; /* hooks used for this resource */
379
/* When allocating items related specifically to this resource, the
380
following pool should be used. Its lifetime will be at least as
381
long as the dav_resource structure. */
387
** Lock token type. Lock providers define the details of a lock token.
388
** However, all providers are expected to at least be able to parse
389
** the "opaquelocktoken" scheme, which is represented by a uuid_t.
391
typedef struct dav_locktoken dav_locktoken;
394
/* --------------------------------------------------------------------
398
** These buffers are used as a lightweight buffer reuse mechanism. Apache
399
** provides sub-pool creation and destruction to much the same effect, but
400
** the sub-pools are a bit more general and heavyweight than these buffers.
403
/* buffer for reuse; can grow to accomodate needed size */
406
apr_size_t alloc_len; /* how much has been allocated */
407
apr_size_t cur_len; /* how much is currently being used */
408
char *buf; /* buffer contents */
410
#define DAV_BUFFER_MINSIZE 256 /* minimum size for buffer */
411
#define DAV_BUFFER_PAD 64 /* amount of pad when growing */
413
/* set the cur_len to the given size and ensure space is available */
414
DAV_DECLARE(void) dav_set_bufsize(apr_pool_t *p, dav_buffer *pbuf,
417
/* initialize a buffer and copy the specified (null-term'd) string into it */
418
DAV_DECLARE(void) dav_buffer_init(apr_pool_t *p, dav_buffer *pbuf,
421
/* check that the buffer can accomodate <extra_needed> more bytes */
422
DAV_DECLARE(void) dav_check_bufsize(apr_pool_t *p, dav_buffer *pbuf,
423
apr_size_t extra_needed);
425
/* append a string to the end of the buffer, adjust length */
426
DAV_DECLARE(void) dav_buffer_append(apr_pool_t *p, dav_buffer *pbuf,
429
/* place a string on the end of the buffer, do NOT adjust length */
430
DAV_DECLARE(void) dav_buffer_place(apr_pool_t *p, dav_buffer *pbuf,
433
/* place some memory on the end of a buffer; do NOT adjust length */
434
DAV_DECLARE(void) dav_buffer_place_mem(apr_pool_t *p, dav_buffer *pbuf,
435
const void *mem, apr_size_t amt,
439
/* --------------------------------------------------------------------
444
/* contains results from one of the getprop functions */
447
apr_text * propstats; /* <propstat> element text */
448
apr_text * xmlns; /* namespace decls for <response> elem */
449
} dav_get_props_result;
451
/* holds the contents of a <response> element */
452
typedef struct dav_response
454
const char *href; /* always */
455
const char *desc; /* optional description at <response> level */
457
/* use status if propresult.propstats is NULL. */
458
dav_get_props_result propresult;
462
struct dav_response *next;
467
request_rec *rnew; /* new subrequest */
468
dav_error err; /* potential error response */
472
DAV_DECLARE(dav_lookup_result) dav_lookup_uri(const char *uri, request_rec *r,
473
int must_be_absolute);
475
/* defines type of property info a provider is to return */
477
DAV_PROP_INSERT_NOTDEF, /* property is defined by this provider,
478
but nothing was inserted because the
479
(live) property is not defined for this
480
resource (it may be present as a dead
482
DAV_PROP_INSERT_NOTSUPP, /* property is recognized by this provider,
483
but it is not supported, and cannot be
484
treated as a dead property */
485
DAV_PROP_INSERT_NAME, /* a property name (empty elem) was
486
inserted into the text block */
487
DAV_PROP_INSERT_VALUE, /* a property name/value pair was inserted
488
into the text block */
489
DAV_PROP_INSERT_SUPPORTED /* a supported live property was added to
491
<DAV:supported-live-property> element */
494
/* ### this stuff is private to dav/fs/repos.c; move it... */
495
/* format a time string (buf must be at least DAV_TIMEBUF_SIZE chars) */
496
#define DAV_STYLE_ISO8601 1
497
#define DAV_STYLE_RFC822 2
498
#define DAV_TIMEBUF_SIZE 30
500
DAV_DECLARE(int) dav_get_depth(request_rec *r, int def_depth);
502
DAV_DECLARE(int) dav_validate_root(const apr_xml_doc *doc,
503
const char *tagname);
504
DAV_DECLARE(apr_xml_elem *) dav_find_child(const apr_xml_elem *elem,
505
const char *tagname);
507
/* gather up all the CDATA into a single string */
508
DAV_DECLARE(const char *) dav_xml_get_cdata(const apr_xml_elem *elem, apr_pool_t *pool,
512
** XML namespace handling
514
** This structure tracks namespace declarations (xmlns:prefix="URI").
515
** It maintains a one-to-many relationship of URIs-to-prefixes. In other
516
** words, one URI may be defined by many prefixes, but any specific
517
** prefix will specify only one URI.
519
** Prefixes using the "g###" pattern can be generated automatically if
520
** the caller does not have specific prefix requirements.
524
apr_hash_t *uri_prefix; /* map URIs to an available prefix */
525
apr_hash_t *prefix_uri; /* map all prefixes to their URIs */
526
int count; /* counter for "g###" prefixes */
529
/* create an empty dav_xmlns_info structure */
530
DAV_DECLARE(dav_xmlns_info *) dav_xmlns_create(apr_pool_t *pool);
532
/* add a specific prefix/URI pair. the prefix/uri should have a lifetime
533
at least that of xmlns->pool */
534
DAV_DECLARE(void) dav_xmlns_add(dav_xmlns_info *xi,
535
const char *prefix, const char *uri);
537
/* add a URI (if not present); any prefix is acceptable and is returned.
538
the uri should have a lifetime at least that xmlns->pool */
539
DAV_DECLARE(const char *) dav_xmlns_add_uri(dav_xmlns_info *xi,
542
/* return the URI for a specified prefix (or NULL if the prefix is unknown) */
543
DAV_DECLARE(const char *) dav_xmlns_get_uri(dav_xmlns_info *xi,
546
/* return an available prefix for a specified URI (or NULL if the URI
548
DAV_DECLARE(const char *) dav_xmlns_get_prefix(dav_xmlns_info *xi,
551
/* generate xmlns declarations (appending into the given text) */
552
DAV_DECLARE(void) dav_xmlns_generate(dav_xmlns_info *xi,
553
apr_text_header *phdr);
555
/* --------------------------------------------------------------------
565
** This structure wraps up all of the hooks that a mod_dav provider can
566
** supply. The provider MUST supply <repos> and <propdb>. The rest are
567
** optional and should contain NULL if that feature is not supplied.
569
** Note that a provider cannot pick and choose portions from various
570
** underlying implementations (which was theoretically possible in
571
** mod_dav 1.0). There are too many dependencies between a dav_resource
572
** (defined by <repos>) and the other functionality.
574
** Live properties are not part of the dav_provider structure because they
575
** are handled through the APR_HOOK interface (to allow for multiple liveprop
576
** providers). The core always provides some properties, and then a given
577
** provider will add more properties.
579
** Some providers may need to associate a context with the dav_provider
580
** structure -- the ctx field is available for storing this context. Just
581
** leave it NULL if it isn't required.
584
const dav_hooks_repository *repos;
585
const dav_hooks_propdb *propdb;
586
const dav_hooks_locks *locks;
587
const dav_hooks_vsn *vsn;
588
const dav_hooks_binding *binding;
589
const dav_hooks_search *search;
595
** gather_propsets: gather all live property propset-URIs
597
** The hook implementor should push one or more URIs into the specified
598
** array. These URIs are returned in the DAV: header to let clients know
599
** what sets of live properties are supported by the installation. mod_dav
600
** will place open/close angle brackets around each value (much like
601
** a Coded-URL); quotes and brackets should not be in the value.
603
** Example: http://apache.org/dav/props/
605
** (of course, use your own domain to ensure a unique value)
607
APR_DECLARE_EXTERNAL_HOOK(dav, DAV, void, gather_propsets,
608
(apr_array_header_t *uris))
611
** find_liveprop: find a live property, returning a non-zero, unique,
612
** opaque identifier.
614
** If the hook implementor determines the specified URI/name refers to
615
** one of its properties, then it should fill in HOOKS and return a
616
** non-zero value. The returned value is the "property ID" and will
617
** be passed to the various liveprop hook functions.
619
** Return 0 if the property is not defined by the hook implementor.
621
APR_DECLARE_EXTERNAL_HOOK(dav, DAV, int, find_liveprop,
622
(const dav_resource *resource,
623
const char *ns_uri, const char *name,
624
const dav_hooks_liveprop **hooks))
627
** insert_all_liveprops: insert all (known) live property names/values.
629
** The hook implementor should append XML text to PHDR, containing liveprop
630
** names. If INSVALUE is true, then the property values should also be
631
** inserted into the output XML stream.
633
** The liveprop provider should insert *all* known and *defined* live
634
** properties on the specified resource. If a particular liveprop is
635
** not defined for this resource, then it should not be inserted.
637
APR_DECLARE_EXTERNAL_HOOK(dav, DAV, void, insert_all_liveprops,
638
(request_rec *r, const dav_resource *resource,
639
dav_prop_insert what, apr_text_header *phdr))
641
DAV_DECLARE(const dav_hooks_locks *) dav_get_lock_hooks(request_rec *r);
642
DAV_DECLARE(const dav_hooks_propdb *) dav_get_propdb_hooks(request_rec *r);
643
DAV_DECLARE(const dav_hooks_vsn *) dav_get_vsn_hooks(request_rec *r);
644
DAV_DECLARE(const dav_hooks_binding *) dav_get_binding_hooks(request_rec *r);
645
DAV_DECLARE(const dav_hooks_search *) dav_get_search_hooks(request_rec *r);
647
DAV_DECLARE(void) dav_register_provider(apr_pool_t *p, const char *name,
648
const dav_provider *hooks);
649
DAV_DECLARE(const dav_provider *) dav_lookup_provider(const char *name);
653
#define DAV_GET_HOOKS_PROPDB(r) dav_get_propdb_hooks(r)
654
#define DAV_GET_HOOKS_LOCKS(r) dav_get_lock_hooks(r)
655
#define DAV_GET_HOOKS_VSN(r) dav_get_vsn_hooks(r)
656
#define DAV_GET_HOOKS_BINDING(r) dav_get_binding_hooks(r)
657
#define DAV_GET_HOOKS_SEARCH(r) dav_get_search_hooks(r)
660
/* --------------------------------------------------------------------
662
** IF HEADER PROCESSING
664
** Here is the definition of the If: header from RFC 2518, S9.4:
666
** If = "If" ":" (1*No-tag-list | 1*Tagged-list)
667
** No-tag-list = List
668
** Tagged-list = Resource 1*List
669
** Resource = Coded-URL
670
** List = "(" 1*(["Not"](State-token | "[" entity-tag "]")) ")"
671
** State-token = Coded-URL
672
** Coded-URL = "<" absoluteURI ">" ; absoluteURI from RFC 2616
674
** List corresponds to dav_if_state_list. No-tag-list corresponds to
675
** dav_if_header with uri==NULL. Tagged-list corresponds to a sequence of
676
** dav_if_header structures with (duplicate) uri==Resource -- one
677
** dav_if_header per state_list. A second Tagged-list will start a new
678
** sequence of dav_if_header structures with the new URI.
680
** A summary of the semantics, mapped into our structures:
681
** - Chained dav_if_headers: OR
682
** - Chained dav_if_state_lists: AND
683
** - NULL uri matches all resources
690
dav_if_unknown /* the "unknown" state type; always matches false. */
693
typedef struct dav_if_state_list
695
dav_if_state_type type;
698
#define DAV_IF_COND_NORMAL 0
699
#define DAV_IF_COND_NOT 1 /* "Not" was applied */
702
dav_locktoken *locktoken;
704
struct dav_if_state_list *next;
707
typedef struct dav_if_header
711
struct dav_if_state_list *state;
712
struct dav_if_header *next;
714
int dummy_header; /* used internally by the lock/etag validation */
717
typedef struct dav_locktoken_list
719
dav_locktoken *locktoken;
720
struct dav_locktoken_list *next;
721
} dav_locktoken_list;
723
DAV_DECLARE(dav_error *) dav_get_locktoken_list(request_rec *r,
724
dav_locktoken_list **ltl);
727
/* --------------------------------------------------------------------
729
** LIVE PROPERTY HANDLING
732
/* opaque type for PROPPATCH rollback information */
733
typedef struct dav_liveprop_rollback dav_liveprop_rollback;
735
struct dav_hooks_liveprop
738
** Insert property information into a text block. The property to
739
** insert is identified by the propid value. The information to insert
740
** is identified by the "what" argument, as follows:
741
** DAV_PROP_INSERT_NAME
742
** property name, as an empty XML element
743
** DAV_PROP_INSERT_VALUE
744
** property name/value, as an XML element
745
** DAV_PROP_INSERT_SUPPORTED
746
** if the property is defined on the resource, then
747
** a DAV:supported-live-property element, as defined
748
** by the DeltaV extensions to RFC2518.
750
** Providers should return DAV_PROP_INSERT_NOTDEF if the property is
751
** known and not defined for this resource, so should be handled as a
752
** dead property. If a provider recognizes, but does not support, a
753
** property, and does not want it handled as a dead property, it should
754
** return DAV_PROP_INSERT_NOTSUPP.
756
** Returns one of DAV_PROP_INSERT_* based on what happened.
758
** ### we may need more context... ie. the lock database
760
dav_prop_insert (*insert_prop)(const dav_resource *resource,
761
int propid, dav_prop_insert what,
762
apr_text_header *phdr);
765
** Determine whether a given property is writable.
767
** ### we may want a different semantic. i.e. maybe it should be
768
** ### "can we write <value> into this property?"
770
** Returns 1 if the live property can be written, 0 if read-only.
772
int (*is_writable)(const dav_resource *resource, int propid);
775
** This member defines the set of namespace URIs that the provider
776
** uses for its properties. When insert_all is called, it will be
777
** passed a list of integers that map from indices into this list
778
** to namespace IDs for output generation.
780
** The last entry in this list should be a NULL value (sentinel).
782
const char * const * namespace_uris;
785
** ### this is not the final design. we want an open-ended way for
786
** ### liveprop providers to attach *new* properties. To this end,
787
** ### we'll have a "give me a list of the props you define", a way
788
** ### to check for a prop's existence, a way to validate a set/remove
789
** ### of a prop, and a way to execute/commit/rollback that change.
793
** Validate that the live property can be assigned a value, and that
794
** the provided value is valid.
796
** elem will point to the XML element that names the property. For
798
** <lp1:executable>T</lp1:executable>
800
** The provider can access the cdata fields and the child elements
801
** to extract the relevant pieces.
803
** operation is one of DAV_PROP_OP_SET or _DELETE.
805
** The provider may return a value in *context which will be passed
806
** to each of the exec/commit/rollback functions. For example, this
807
** may contain an internal value which has been processed from the
810
** The provider must set defer_to_dead to true (non-zero) or false.
811
** If true, then the set/remove is deferred to the dead property
812
** database. Note: it will be set to zero on entry.
814
dav_error * (*patch_validate)(const dav_resource *resource,
815
const apr_xml_elem *elem,
821
dav_error * (*patch_exec)(const dav_resource *resource,
822
const apr_xml_elem *elem,
825
dav_liveprop_rollback **rollback_ctx);
828
void (*patch_commit)(const dav_resource *resource,
831
dav_liveprop_rollback *rollback_ctx);
834
dav_error * (*patch_rollback)(const dav_resource *resource,
837
dav_liveprop_rollback *rollback_ctx);
840
** If a provider needs a context to associate with this hooks structure,
841
** then this field may be used. In most cases, it will just be NULL.
847
** dav_liveprop_spec: specify a live property
849
** This structure is used as a standard way to determine if a particular
850
** property is a live property. Its use is not part of the mandated liveprop
851
** interface, but can be used by liveprop providers in conjuction with the
852
** utility routines below.
854
** spec->name == NULL is the defined end-sentinel for a list of specs.
857
int ns; /* provider-local namespace index */
858
const char *name; /* name of the property */
860
int propid; /* provider-local property ID */
862
int is_writable; /* is the property writable? */
867
** dav_liveprop_group: specify a group of liveprops
869
** This structure specifies a group of live properties, their namespaces,
870
** and how to handle them.
873
const dav_liveprop_spec *specs;
874
const char * const *namespace_uris;
875
const dav_hooks_liveprop *hooks;
877
} dav_liveprop_group;
880
DAV_DECLARE(int) dav_do_find_liveprop(const char *ns_uri, const char *name,
881
const dav_liveprop_group *group,
882
const dav_hooks_liveprop **hooks);
885
DAV_DECLARE(long) dav_get_liveprop_info(int propid,
886
const dav_liveprop_group *group,
887
const dav_liveprop_spec **info);
890
DAV_DECLARE(void) dav_register_liveprop_group(apr_pool_t *pool,
891
const dav_liveprop_group *group);
894
DAV_DECLARE(long) dav_get_liveprop_ns_index(const char *uri);
897
DAV_DECLARE(long) dav_get_liveprop_ns_count(void);
900
DAV_DECLARE(void) dav_add_all_liveprop_xmlns(apr_pool_t *p,
901
apr_text_header *phdr);
904
** The following three functions are part of mod_dav's internal handling
905
** for the core WebDAV properties. They are not part of mod_dav's API.
907
DAV_DECLARE_NONSTD(int) dav_core_find_liveprop(
908
const dav_resource *resource,
911
const dav_hooks_liveprop **hooks);
912
DAV_DECLARE_NONSTD(void) dav_core_insert_all_liveprops(
914
const dav_resource *resource,
915
dav_prop_insert what,
916
apr_text_header *phdr);
917
DAV_DECLARE_NONSTD(void) dav_core_register_uris(apr_pool_t *p);
921
** Standard WebDAV Property Identifiers
923
** A live property provider does not need to use these; they are simply
924
** provided for convenience.
926
** Property identifiers need to be unique within a given provider, but not
927
** *across* providers (note: this uniqueness constraint was different in
928
** older versions of mod_dav).
930
** The identifiers start at 20000 to make it easier for providers to avoid
931
** conflicts with the standard properties. The properties are arranged
932
** alphabetically, and may be reordered from time to time (as properties
935
** NOTE: there is no problem with reordering (e.g. binary compat) since the
936
** identifiers are only used within a given provider, which would pick up
937
** the entire set of changes upon a recompile.
940
DAV_PROPID_BEGIN = 20000,
942
/* Standard WebDAV properties (RFC 2518) */
943
DAV_PROPID_creationdate,
944
DAV_PROPID_displayname,
945
DAV_PROPID_getcontentlanguage,
946
DAV_PROPID_getcontentlength,
947
DAV_PROPID_getcontenttype,
949
DAV_PROPID_getlastmodified,
950
DAV_PROPID_lockdiscovery,
951
DAV_PROPID_resourcetype,
953
DAV_PROPID_supportedlock,
955
/* DeltaV properties (from the I-D (#14)) */
956
DAV_PROPID_activity_checkout_set,
957
DAV_PROPID_activity_set,
958
DAV_PROPID_activity_version_set,
959
DAV_PROPID_auto_merge_set,
960
DAV_PROPID_auto_version,
961
DAV_PROPID_baseline_collection,
962
DAV_PROPID_baseline_controlled_collection,
963
DAV_PROPID_baseline_controlled_collection_set,
964
DAV_PROPID_checked_in,
965
DAV_PROPID_checked_out,
966
DAV_PROPID_checkin_fork,
967
DAV_PROPID_checkout_fork,
968
DAV_PROPID_checkout_set,
970
DAV_PROPID_creator_displayname,
971
DAV_PROPID_current_activity_set,
972
DAV_PROPID_current_workspace_set,
973
DAV_PROPID_default_variant,
974
DAV_PROPID_eclipsed_set,
975
DAV_PROPID_label_name_set,
976
DAV_PROPID_merge_set,
977
DAV_PROPID_precursor_set,
978
DAV_PROPID_predecessor_set,
979
DAV_PROPID_root_version,
980
DAV_PROPID_subactivity_set,
981
DAV_PROPID_subbaseline_set,
982
DAV_PROPID_successor_set,
983
DAV_PROPID_supported_method_set,
984
DAV_PROPID_supported_live_property_set,
985
DAV_PROPID_supported_report_set,
986
DAV_PROPID_unreserved,
987
DAV_PROPID_variant_set,
988
DAV_PROPID_version_controlled_binding_set,
989
DAV_PROPID_version_controlled_configuration,
990
DAV_PROPID_version_history,
991
DAV_PROPID_version_name,
992
DAV_PROPID_workspace,
993
DAV_PROPID_workspace_checkout_set,
999
** Property Identifier Registration
1001
** At the moment, mod_dav requires live property providers to ensure that
1002
** each property returned has a unique value. For now, this is done through
1003
** central registration (there are no known providers other than the default,
1004
** so this remains manageable).
1006
** WARNING: the TEST ranges should never be "shipped".
1008
#define DAV_PROPID_CORE 10000 /* ..10099. defined by mod_dav */
1009
#define DAV_PROPID_FS 10100 /* ..10299.
1010
mod_dav filesystem provider. */
1011
#define DAV_PROPID_TEST1 10300 /* ..10399 */
1012
#define DAV_PROPID_TEST2 10400 /* ..10499 */
1013
#define DAV_PROPID_TEST3 10500 /* ..10599 */
1017
/* --------------------------------------------------------------------
1019
** DATABASE FUNCTIONS
1022
typedef struct dav_db dav_db;
1023
typedef struct dav_namespace_map dav_namespace_map;
1024
typedef struct dav_deadprop_rollback dav_deadprop_rollback;
1027
const char *ns; /* "" signals "no namespace" */
1031
/* hook functions to enable pluggable databases */
1032
struct dav_hooks_propdb
1034
dav_error * (*open)(apr_pool_t *p, const dav_resource *resource, int ro,
1036
void (*close)(dav_db *db);
1039
** In bulk, define any namespaces that the values and their name
1040
** elements may need.
1042
** Note: sometimes mod_dav will defer calling this until output_value
1043
** returns found==1. If the output process needs the dav_xmlns_info
1044
** filled for its work, then it will need to fill it on demand rather
1045
** than depending upon this hook to fill in the structure.
1047
** Note: this will *always* be called during an output sequence. Thus,
1048
** the provider may rely solely on using this to fill the xmlns info.
1050
dav_error * (*define_namespaces)(dav_db *db, dav_xmlns_info *xi);
1053
** Output the value from the database (i.e. add an element name and
1054
** the value into *phdr). Set *found based on whether the name/value
1055
** was found in the propdb.
1057
** Note: it is NOT an error for the key/value pair to not exist.
1059
** The dav_xmlns_info passed to define_namespaces() is also passed to
1060
** each output_value() call so that namespaces can be added on-demand.
1061
** It can also be used to look up prefixes or URIs during the output
1064
dav_error * (*output_value)(dav_db *db, const dav_prop_name *name,
1066
apr_text_header *phdr, int *found);
1069
** Build a mapping from "global" namespaces (stored in apr_xml_*)
1070
** into provider-local namespace identifiers.
1072
** This mapping should be done once per set of namespaces, and the
1073
** resulting mapping should be passed into the store() hook function.
1075
** Note: usually, there is just a single document/namespaces for all
1076
** elements passed. However, the generality of creating multiple
1077
** mappings and passing them to store() is provided here.
1079
** Note: this is only in preparation for a series of store() calls.
1080
** As a result, the propdb must be open for read/write access when
1081
** this function is called.
1083
dav_error * (*map_namespaces)(dav_db *db,
1084
const apr_array_header_t *namespaces,
1085
dav_namespace_map **mapping);
1088
** Store a property value for a given name. The value->combined field
1089
** MUST be set for this call.
1091
** ### WARNING: current providers will quote the text within ELEM.
1092
** ### this implies you can call this function only once with a given
1093
** ### element structure (a second time will quote it again).
1095
dav_error * (*store)(dav_db *db, const dav_prop_name *name,
1096
const apr_xml_elem *elem,
1097
dav_namespace_map *mapping);
1099
/* remove a given property */
1100
dav_error * (*remove)(dav_db *db, const dav_prop_name *name);
1102
/* returns 1 if the record specified by "key" exists; 0 otherwise */
1103
int (*exists)(dav_db *db, const dav_prop_name *name);
1106
** Iterate over the property names in the database.
1108
** iter->name.ns == iter->name.name == NULL when there are no more names.
1110
** Note: only one iteration may occur over the propdb at a time.
1112
dav_error * (*first_name)(dav_db *db, dav_prop_name *pname);
1113
dav_error * (*next_name)(dav_db *db, dav_prop_name *pname);
1116
** Rollback support: get rollback context, and apply it.
1118
** struct dav_deadprop_rollback is a provider-private structure; it
1119
** should remember the name, and the name's old value (or the fact that
1120
** the value was not present, and should be deleted if a rollback occurs).
1122
dav_error * (*get_rollback)(dav_db *db, const dav_prop_name *name,
1123
dav_deadprop_rollback **prollback);
1124
dav_error * (*apply_rollback)(dav_db *db,
1125
dav_deadprop_rollback *rollback);
1128
** If a provider needs a context to associate with this hooks structure,
1129
** then this field may be used. In most cases, it will just be NULL.
1135
/* --------------------------------------------------------------------
1140
/* Used to represent a Timeout header of "Infinity" */
1141
#define DAV_TIMEOUT_INFINITE 0
1143
DAV_DECLARE(time_t) dav_get_timeout(request_rec *r);
1146
** Opaque, provider-specific information for a lock database.
1148
typedef struct dav_lockdb_private dav_lockdb_private;
1151
** Opaque, provider-specific information for a lock record.
1153
typedef struct dav_lock_private dav_lock_private;
1156
** Lock database type. Lock providers are urged to implement a "lazy" open, so
1157
** doing an "open" is cheap until something is actually needed from the DB.
1161
const dav_hooks_locks *hooks; /* the hooks used for this lockdb */
1162
int ro; /* was it opened readonly? */
1164
dav_lockdb_private *info;
1169
DAV_LOCKSCOPE_UNKNOWN,
1170
DAV_LOCKSCOPE_EXCLUSIVE,
1171
DAV_LOCKSCOPE_SHARED
1175
DAV_LOCKTYPE_UNKNOWN,
1180
DAV_LOCKREC_DIRECT, /* lock asserted on this resource */
1181
DAV_LOCKREC_INDIRECT, /* lock inherited from a parent */
1182
DAV_LOCKREC_INDIRECT_PARTIAL /* most info is not filled in */
1186
** dav_lock: hold information about a lock on a resource.
1188
** This structure is used for both direct and indirect locks. A direct lock
1189
** is a lock applied to a specific resource by the client. An indirect lock
1190
** is one that is inherited from a parent resource by virtue of a non-zero
1191
** Depth: header when the lock was applied.
1193
** mod_dav records both types of locks in the lock database, managing their
1194
** addition/removal as resources are moved about the namespace.
1196
** Note that the lockdb is free to marshal this structure in any form that
1199
** For a "partial" lock, the <rectype> and <locktoken> fields must be filled
1200
** in. All other (user) fields should be zeroed. The lock provider will
1201
** usually fill in the <info> field, and the <next> field may be used to
1202
** construct a list of partial locks.
1204
** The lock provider MUST use the info field to store a value such that a
1205
** dav_lock structure can locate itself in the underlying lock database.
1206
** This requirement is needed for refreshing: when an indirect dav_lock is
1207
** refreshed, its reference to the direct lock does not specify the direct's
1208
** resource, so the only way to locate the (refreshed, direct) lock in the
1209
** database is to use the info field.
1211
** Note that <is_locknull> only refers to the resource where this lock was
1213
** ### hrm. that says the abstraction is wrong. is_locknull may disappear.
1215
typedef struct dav_lock
1217
dav_lock_rectype rectype; /* type of lock record */
1218
int is_locknull; /* lock establishes a locknull resource */
1220
/* ### put the resource in here? */
1222
dav_lock_scope scope; /* scope of the lock */
1223
dav_lock_type type; /* type of lock */
1224
int depth; /* depth of the lock */
1225
time_t timeout; /* when the lock will timeout */
1227
const dav_locktoken *locktoken; /* the token that was issued */
1229
const char *owner; /* (XML) owner of the lock */
1230
const char *auth_user; /* auth'd username owning lock */
1232
dav_lock_private *info; /* private to the lockdb */
1234
struct dav_lock *next; /* for managing a list of locks */
1237
/* Property-related public lock functions */
1238
DAV_DECLARE(const char *)dav_lock_get_activelock(request_rec *r,
1242
/* LockDB-related public lock functions */
1243
DAV_DECLARE(dav_error *) dav_lock_parse_lockinfo(request_rec *r,
1244
const dav_resource *resrouce,
1246
const apr_xml_doc *doc,
1247
dav_lock **lock_request);
1248
DAV_DECLARE(int) dav_unlock(request_rec *r,
1249
const dav_resource *resource,
1250
const dav_locktoken *locktoken);
1251
DAV_DECLARE(dav_error *) dav_add_lock(request_rec *r,
1252
const dav_resource *resource,
1253
dav_lockdb *lockdb, dav_lock *request,
1254
dav_response **response);
1255
DAV_DECLARE(dav_error *) dav_notify_created(request_rec *r,
1257
const dav_resource *resource,
1261
DAV_DECLARE(dav_error*) dav_lock_query(dav_lockdb *lockdb,
1262
const dav_resource *resource,
1265
DAV_DECLARE(dav_error *) dav_validate_request(request_rec *r,
1266
dav_resource *resource,
1268
dav_locktoken *locktoken,
1269
dav_response **response,
1271
dav_lockdb *lockdb);
1274
** 0x0F -- reserved for <dav_lock_scope> values
1276
** other flags, detailed below
1278
#define DAV_VALIDATE_RESOURCE 0x0010 /* validate just the resource */
1279
#define DAV_VALIDATE_PARENT 0x0020 /* validate resource AND its parent */
1280
#define DAV_VALIDATE_ADD_LD 0x0040 /* add DAV:lockdiscovery into
1281
the 424 DAV:response */
1282
#define DAV_VALIDATE_USE_424 0x0080 /* return 424 status, not 207 */
1283
#define DAV_VALIDATE_IS_PARENT 0x0100 /* for internal use */
1285
/* Lock-null related public lock functions */
1286
DAV_DECLARE(int) dav_get_resource_state(request_rec *r,
1287
const dav_resource *resource);
1289
/* Lock provider hooks. Locking is optional, so there may be no
1290
* lock provider for a given repository.
1292
struct dav_hooks_locks
1294
/* Return the supportedlock property for a resource */
1295
const char * (*get_supportedlock)(
1296
const dav_resource *resource
1299
/* Parse a lock token URI, returning a lock token object allocated
1300
* in the given pool.
1302
dav_error * (*parse_locktoken)(
1304
const char *char_token,
1305
dav_locktoken **locktoken_p
1308
/* Format a lock token object into a URI string, allocated in
1311
* Always returns non-NULL.
1313
const char * (*format_locktoken)(
1315
const dav_locktoken *locktoken
1318
/* Compare two lock tokens.
1320
* Result < 0 => lt1 < lt2
1321
* Result == 0 => lt1 == lt2
1322
* Result > 0 => lt1 > lt2
1324
int (*compare_locktoken)(
1325
const dav_locktoken *lt1,
1326
const dav_locktoken *lt2
1329
/* Open the provider's lock database.
1331
* The provider may or may not use a "real" database for locks
1332
* (a lock could be an attribute on a resource, for example).
1334
* The provider may choose to use the value of the DAVLockDB directive
1335
* (as returned by dav_get_lockdb_path()) to decide where to place
1336
* any storage it may need.
1338
* The request storage pool should be associated with the lockdb,
1339
* so it can be used in subsequent operations.
1341
* If ro != 0, only readonly operations will be performed.
1342
* If force == 0, the open can be "lazy"; no subsequent locking operations
1344
* If force != 0, locking operations will definitely occur.
1346
dav_error * (*open_lockdb)(
1353
/* Indicates completion of locking operations */
1354
void (*close_lockdb)(
1358
/* Take a resource out of the lock-null state. */
1359
dav_error * (*remove_locknull_state)(
1361
const dav_resource *resource
1365
** Create a (direct) lock structure for the given resource. A locktoken
1368
** The lock provider may store private information into lock->info.
1370
dav_error * (*create_lock)(dav_lockdb *lockdb,
1371
const dav_resource *resource,
1375
** Get the locks associated with the specified resource.
1377
** If resolve_locks is true (non-zero), then any indirect locks are
1378
** resolved to their actual, direct lock (i.e. the reference to followed
1379
** to the original lock).
1381
** The locks, if any, are returned as a linked list in no particular
1382
** order. If no locks are present, then *locks will be NULL.
1384
dav_error * (*get_locks)(dav_lockdb *lockdb,
1385
const dav_resource *resource,
1389
#define DAV_GETLOCKS_RESOLVED 0 /* resolve indirects to directs */
1390
#define DAV_GETLOCKS_PARTIAL 1 /* leave indirects partially filled */
1391
#define DAV_GETLOCKS_COMPLETE 2 /* fill out indirect locks */
1394
** Find a particular lock on a resource (specified by its locktoken).
1396
** *lock will be set to NULL if the lock is not found.
1398
** Note that the provider can optimize the unmarshalling -- only one
1399
** lock (or none) must be constructed and returned.
1401
** If partial_ok is true (non-zero), then an indirect lock can be
1402
** partially filled in. Otherwise, another lookup is done and the
1403
** lock structure will be filled out as a DAV_LOCKREC_INDIRECT.
1405
dav_error * (*find_lock)(dav_lockdb *lockdb,
1406
const dav_resource *resource,
1407
const dav_locktoken *locktoken,
1412
** Quick test to see if the resource has *any* locks on it.
1414
** This is typically used to determine if a non-existent resource
1415
** has a lock and is (therefore) a locknull resource.
1417
** WARNING: this function may return TRUE even when timed-out locks
1418
** exist (i.e. it may not perform timeout checks).
1420
dav_error * (*has_locks)(dav_lockdb *lockdb,
1421
const dav_resource *resource,
1422
int *locks_present);
1425
** Append the specified lock(s) to the set of locks on this resource.
1427
** If "make_indirect" is true (non-zero), then the specified lock(s)
1428
** should be converted to an indirect lock (if it is a direct lock)
1429
** before appending. Note that the conversion to an indirect lock does
1430
** not alter the passed-in lock -- the change is internal the
1431
** append_locks function.
1433
** Multiple locks are specified using the lock->next links.
1435
dav_error * (*append_locks)(dav_lockdb *lockdb,
1436
const dav_resource *resource,
1438
const dav_lock *lock);
1441
** Remove any lock that has the specified locktoken.
1443
** If locktoken == NULL, then ALL locks are removed.
1445
dav_error * (*remove_lock)(dav_lockdb *lockdb,
1446
const dav_resource *resource,
1447
const dav_locktoken *locktoken);
1450
** Refresh all locks, found on the specified resource, which has a
1451
** locktoken in the provided list.
1453
** If the lock is indirect, then the direct lock is referenced and
1456
** Each lock that is updated is returned in the <locks> argument.
1457
** Note that the locks will be fully resolved.
1459
dav_error * (*refresh_locks)(dav_lockdb *lockdb,
1460
const dav_resource *resource,
1461
const dav_locktoken_list *ltl,
1466
** Look up the resource associated with a particular locktoken.
1468
** The search begins at the specified <start_resource> and the lock
1469
** specified by <locktoken>.
1471
** If the resource/token specifies an indirect lock, then the direct
1472
** lock will be looked up, and THAT resource will be returned. In other
1473
** words, this function always returns the resource where a particular
1474
** lock (token) was asserted.
1476
** NOTE: this function pointer is allowed to be NULL, indicating that
1477
** the provider does not support this type of functionality. The
1478
** caller should then traverse up the repository hierarchy looking
1479
** for the resource defining a lock with this locktoken.
1481
dav_error * (*lookup_resource)(dav_lockdb *lockdb,
1482
const dav_locktoken *locktoken,
1483
const dav_resource *start_resource,
1484
const dav_resource **resource);
1487
** If a provider needs a context to associate with this hooks structure,
1488
** then this field may be used. In most cases, it will just be NULL.
1493
/* what types of resources can be discovered by dav_get_resource_state() */
1494
#define DAV_RESOURCE_LOCK_NULL 10 /* resource lock-null */
1495
#define DAV_RESOURCE_NULL 11 /* resource null */
1496
#define DAV_RESOURCE_EXISTS 12 /* resource exists */
1497
#define DAV_RESOURCE_ERROR 13 /* an error occurred */
1500
/* --------------------------------------------------------------------
1502
** PROPERTY HANDLING
1505
typedef struct dav_propdb dav_propdb;
1508
DAV_DECLARE(dav_error *) dav_open_propdb(
1511
const dav_resource *resource,
1513
apr_array_header_t *ns_xlate,
1514
dav_propdb **propdb);
1516
DAV_DECLARE(void) dav_close_propdb(dav_propdb *db);
1518
DAV_DECLARE(dav_get_props_result) dav_get_props(
1522
DAV_DECLARE(dav_get_props_result) dav_get_allprops(
1524
dav_prop_insert what);
1526
DAV_DECLARE(void) dav_get_liveprop_supported(
1529
const char *propname,
1530
apr_text_header *body);
1533
** 3-phase property modification.
1535
** 1) validate props. readable? unlocked? ACLs allow access?
1536
** 2) execute operation (set/delete)
1537
** 3) commit or rollback
1539
** ### eventually, auth must be available. a ref to the request_rec (which
1540
** ### contains the auth info) should be in the shared context struct.
1542
** Each function may alter the error values and information contained within
1543
** the context record. This should be done as an "increasing" level of
1544
** error, rather than overwriting any previous error.
1546
** Note that commit() cannot generate errors. It should simply free the
1547
** rollback information.
1549
** rollback() may generate additional errors because the rollback operation
1550
** can sometimes fail(!).
1552
** The caller should allocate an array of these, one per operation. It should
1553
** be zero-initialized, then the db, operation, and prop fields should be
1554
** filled in before calling dav_prop_validate. Note that the set/delete
1555
** operations are order-dependent. For a given (logical) context, the same
1556
** pointer must be passed to each phase.
1558
** error_type is an internal value, but will have the same numeric value
1559
** for each possible "desc" value. This allows the caller to group the
1560
** descriptions via the error_type variable, rather than through string
1561
** comparisons. Note that "status" does not provide enough granularity to
1562
** differentiate/group the "desc" values.
1564
** Note that the propdb will maintain some (global) context across all
1565
** of the property change contexts. This implies that you can have only
1566
** one open transaction per propdb.
1568
typedef struct dav_prop_ctx
1573
#define DAV_PROP_OP_SET 1 /* set a property value */
1574
#define DAV_PROP_OP_DELETE 2 /* delete a prop value */
1575
/* ### add a GET? */
1577
apr_xml_elem *prop; /* property to affect */
1579
dav_error *err; /* error (if any) */
1581
/* private items to the propdb */
1584
struct dav_rollback_item *rollback; /* optional rollback info */
1586
/* private to mod_dav.c */
1591
DAV_DECLARE_NONSTD(void) dav_prop_validate(dav_prop_ctx *ctx);
1592
DAV_DECLARE_NONSTD(void) dav_prop_exec(dav_prop_ctx *ctx);
1593
DAV_DECLARE_NONSTD(void) dav_prop_commit(dav_prop_ctx *ctx);
1594
DAV_DECLARE_NONSTD(void) dav_prop_rollback(dav_prop_ctx *ctx);
1596
#define DAV_PROP_CTX_HAS_ERR(dpc) ((dpc).err && (dpc).err->status >= 300)
1599
/* --------------------------------------------------------------------
1605
DAV_CALLTYPE_MEMBER = 1, /* called for a member resource */
1606
DAV_CALLTYPE_COLLECTION, /* called for a collection */
1607
DAV_CALLTYPE_LOCKNULL /* called for a locknull resource */
1612
/* the client-provided context */
1615
/* pool to use for allocations in the callback */
1618
/* the current resource */
1619
const dav_resource *resource;
1621
/* OUTPUT: add responses to this */
1622
dav_response *response;
1624
} dav_walk_resource;
1629
#define DAV_WALKTYPE_AUTH 0x0001 /* limit to authorized files */
1630
#define DAV_WALKTYPE_NORMAL 0x0002 /* walk normal files */
1631
#define DAV_WALKTYPE_LOCKNULL 0x0004 /* walk locknull resources */
1633
/* callback function and a client context for the walk */
1634
dav_error * (*func)(dav_walk_resource *wres, int calltype);
1637
/* what pool to use for allocations needed by walk logic */
1640
/* beginning root of the walk */
1641
const dav_resource *root;
1643
/* lock database to enable walking LOCKNULL resources */
1648
/* directory tree walking context */
1649
typedef struct dav_walker_ctx
1655
/* ### client data... phasing out this big glom */
1657
/* this brigade buffers data being sent to r->output_filters */
1658
apr_bucket_brigade *bb;
1660
/* a scratch pool, used to stream responses and iteratively cleared. */
1661
apr_pool_t *scratchpool;
1663
request_rec *r; /* original request */
1665
/* for PROPFIND operations */
1668
#define DAV_PROPFIND_IS_ALLPROP 1
1669
#define DAV_PROPFIND_IS_PROPNAME 2
1670
#define DAV_PROPFIND_IS_PROP 3
1672
apr_text *propstat_404; /* (cached) propstat giving a 404 error */
1674
const dav_if_header *if_header; /* for validation */
1675
const dav_locktoken *locktoken; /* for UNLOCK */
1676
const dav_lock *lock; /* for LOCK */
1677
int skip_root; /* for dav_inherit_locks() */
1681
dav_buffer work_buf; /* for dav_validate_request() */
1685
DAV_DECLARE(void) dav_add_response(dav_walk_resource *wres,
1687
dav_get_props_result *propstats);
1690
/* --------------------------------------------------------------------
1692
** "STREAM" STRUCTURE
1694
** mod_dav uses this abstraction for interacting with the repository
1695
** while fetching/storing resources. mod_dav views resources as a stream
1698
** Note that the structure is opaque -- it is private to the repository
1699
** that created the stream in the repository's "open" function.
1701
** ### THIS STUFF IS GOING AWAY ... GET/read requests are handled by
1702
** ### having the provider jam stuff straight into the filter stack.
1703
** ### this is only left for handling PUT/write requests.
1706
typedef struct dav_stream dav_stream;
1709
DAV_MODE_WRITE_TRUNC, /* truncate and open for writing */
1710
DAV_MODE_WRITE_SEEKABLE /* open for writing; random access */
1714
/* --------------------------------------------------------------------
1716
** REPOSITORY FUNCTIONS
1719
/* Repository provider hooks */
1720
struct dav_hooks_repository
1722
/* Flag for whether repository requires special GET handling.
1723
* If resources in the repository are not visible in the
1724
* filesystem location which URLs map to, then special handling
1725
* is required to first fetch a resource from the repository,
1726
* respond to the GET request, then free the resource copy.
1730
/* Get a resource descriptor for the URI in a request. A descriptor
1731
* should always be returned even if the resource does not exist. This
1732
* repository has been identified as handling the resource given by
1733
* the URI, so an answer must be given. If there is a problem with the
1734
* URI or accessing the resource or whatever, then an error should be
1738
* the root of the directory for which this repository is configured.
1741
* if a Label: header is present (and allowed), this is the label
1742
* to use to identify a version resource from the resource's
1743
* corresponding version history. Otherwise, it will be NULL.
1746
* use the DAV:checked-in property of the resource identified by the
1747
* Request-URI to identify and return a version resource
1749
* The provider may associate the request storage pool with the resource
1750
* (in the resource->pool field), to use in other operations on that
1753
dav_error * (*get_resource)(
1755
const char *root_dir,
1758
dav_resource **resource
1761
/* Get a resource descriptor for the parent of the given resource.
1762
* The resources need not exist. NULL is returned if the resource
1763
* is the root collection.
1765
* An error should be returned only if there is a fatal error in
1766
* fetching information about the parent resource.
1768
dav_error * (*get_parent_resource)(
1769
const dav_resource *resource,
1770
dav_resource **parent_resource
1773
/* Determine whether two resource descriptors refer to the same resource.
1775
* Result != 0 => the resources are the same.
1777
int (*is_same_resource)(
1778
const dav_resource *res1,
1779
const dav_resource *res2
1782
/* Determine whether one resource is a parent (immediate or otherwise)
1785
* Result != 0 => res1 is a parent of res2.
1787
int (*is_parent_resource)(
1788
const dav_resource *res1,
1789
const dav_resource *res2
1793
** Open a stream for this resource, using the specified mode. The
1794
** stream will be returned in *stream.
1796
dav_error * (*open_stream)(const dav_resource *resource,
1797
dav_stream_mode mode,
1798
dav_stream **stream);
1801
** Close the specified stream.
1803
** mod_dav will (ideally) make sure to call this. For safety purposes,
1804
** a provider should (ideally) register a cleanup function with the
1805
** request pool to get this closed and cleaned up.
1807
** Note the possibility of an error from the close -- it is entirely
1808
** feasible that the close does a "commit" of some kind, which can
1809
** produce an error.
1811
** commit should be TRUE (non-zero) or FALSE (0) if the stream was
1812
** opened for writing. This flag states whether to retain the file
1814
** Note: the commit flag is ignored for streams opened for reading.
1816
dav_error * (*close_stream)(dav_stream *stream, int commit);
1819
** Write data to the stream.
1821
** All of the bytes must be written, or an error should be returned.
1823
dav_error * (*write_stream)(dav_stream *stream,
1824
const void *buf, apr_size_t bufsize);
1827
** Seek to an absolute position in the stream. This is used to support
1828
** Content-Range in a GET/PUT.
1830
** NOTE: if this function is NULL (which is allowed), then any
1831
** operations using Content-Range will be refused.
1833
dav_error * (*seek_stream)(dav_stream *stream, apr_off_t abs_position);
1836
** If a GET is processed using a stream (open_stream, read_stream)
1837
** rather than via a sub-request (on get_pathname), then this function
1838
** is used to provide the repository with a way to set the headers
1841
** This function may be called without a following deliver(), to
1842
** handle a HEAD request.
1844
** This may be NULL if handle_get is FALSE.
1846
dav_error * (*set_headers)(request_rec *r,
1847
const dav_resource *resource);
1850
** The provider should deliver the resource into the specified filter.
1851
** Basically, this is the response to the GET method.
1853
** Note that this is called for all resources, including collections.
1854
** The provider should determine what has content to deliver or not.
1856
** set_headers will be called prior to this function, allowing the
1857
** provider to set the appropriate response headers.
1859
** This may be NULL if handle_get is FALSE.
1860
** ### maybe toss handle_get and just use this function as the marker
1862
dav_error * (*deliver)(const dav_resource *resource,
1863
ap_filter_t *output);
1865
/* Create a collection resource. The resource must not already exist.
1867
* Result == NULL if the collection was created successfully. Also, the
1868
* resource object is updated to reflect that the resource exists, and
1871
dav_error * (*create_collection)(
1872
dav_resource *resource
1875
/* Copy one resource to another. The destination may exist, if it is
1877
* Handles both files and collections. Properties are copied as well.
1878
* If the destination exists and is versioned, the provider must update
1879
* the destination to have identical content to the source,
1880
* recursively for collections.
1881
* The depth argument is ignored for a file, and can be either 0 or
1882
* DAV_INFINITY for a collection.
1883
* If an error occurs in a child resource, then the return value is
1884
* non-NULL, and *response is set to a multistatus response.
1885
* If the copy is successful, the dst resource object is
1886
* updated to reflect that the resource exists.
1888
dav_error * (*copy_resource)(
1889
const dav_resource *src,
1892
dav_response **response
1895
/* Move one resource to another. The destination must not exist.
1896
* Handles both files and collections. Properties are moved as well.
1897
* If an error occurs in a child resource, then the return value is
1898
* non-NULL, and *response is set to a multistatus response.
1899
* If the move is successful, the src and dst resource objects are
1900
* updated to reflect that the source no longer exists, and the
1903
dav_error * (*move_resource)(
1906
dav_response **response
1909
/* Remove a resource. Handles both files and collections.
1910
* Removes any associated properties as well.
1911
* If an error occurs in a child resource, then the return value is
1912
* non-NULL, and *response is set to a multistatus response.
1913
* If the delete is successful, the resource object is updated to
1914
* reflect that the resource no longer exists.
1916
dav_error * (*remove_resource)(
1917
dav_resource *resource,
1918
dav_response **response
1921
/* Walk a resource hierarchy.
1923
* Iterates over the resource hierarchy specified by params->root.
1924
* Control of the walk and the callback are specified by 'params'.
1926
* An error may be returned. *response will contain multistatus
1927
* responses (if any) suitable for the body of the error. It is also
1928
* possible to return NULL, yet still have multistatus responses.
1929
* In this case, typically the caller should return a 207 (Multistatus)
1930
* and the responses (in the body) as the HTTP response.
1932
dav_error * (*walk)(const dav_walk_params *params, int depth,
1933
dav_response **response);
1935
/* Get the entity tag for a resource */
1936
const char * (*getetag)(const dav_resource *resource);
1939
** If a provider needs a context to associate with this hooks structure,
1940
** then this field may be used. In most cases, it will just be NULL.
1946
/* --------------------------------------------------------------------
1948
** VERSIONING FUNCTIONS
1952
/* dav_add_vary_header
1954
* If there were any headers in the request which require a Vary header
1955
* in the response, add it.
1957
DAV_DECLARE(void) dav_add_vary_header(request_rec *in_req,
1958
request_rec *out_req,
1959
const dav_resource *resource);
1962
** Flags specifying auto-versioning behavior, returned by
1963
** the auto_versionable hook. The value returned depends
1964
** on both the state of the resource and the value of the
1965
** DAV:auto-versioning property for the resource.
1967
** If the resource does not exist (null or lock-null),
1968
** DAV_AUTO_VERSION_ALWAYS causes creation of a new version-controlled resource
1970
** If the resource is checked in,
1971
** DAV_AUTO_VERSION_ALWAYS causes it to be checked out always,
1972
** DAV_AUTO_VERSION_LOCKED causes it to be checked out only when locked
1974
** If the resource is checked out,
1975
** DAV_AUTO_VERSION_ALWAYS causes it to be checked in always,
1976
** DAV_AUTO_VERSION_LOCKED causes it to be checked in when unlocked
1977
** (note: a provider should allow auto-checkin only for resources which
1978
** were automatically checked out)
1980
** In all cases, DAV_AUTO_VERSION_NEVER results in no auto-versioning behavior.
1983
DAV_AUTO_VERSION_NEVER,
1984
DAV_AUTO_VERSION_ALWAYS,
1985
DAV_AUTO_VERSION_LOCKED
1989
** This structure is used to record what auto-versioning operations
1990
** were done to make a resource writable, so that they can be undone
1991
** at the end of a request.
1994
int resource_versioned; /* 1 => resource was auto-version-controlled */
1995
int resource_checkedout; /* 1 => resource was auto-checked-out */
1996
int parent_checkedout; /* 1 => parent was auto-checked-out */
1997
dav_resource *parent_resource; /* parent resource, if it was needed */
1998
} dav_auto_version_info;
2000
/* Ensure that a resource is writable. If there is no versioning
2001
* provider, then this is essentially a no-op. Versioning repositories
2002
* require explicit resource creation and checkout before they can
2003
* be written to. If a new resource is to be created, or an existing
2004
* resource deleted, the parent collection must be checked out as well.
2006
* Set the parent_only flag to only make the parent collection writable.
2007
* Otherwise, both parent and child are made writable as needed. If the
2008
* child does not exist, then a new versioned resource is created and
2011
* If auto-versioning is not enabled for a versioned resource, then an error is
2012
* returned, since the resource cannot be modified.
2014
* The dav_auto_version_info structure is filled in with enough information
2015
* to restore both parent and child resources to the state they were in
2016
* before the auto-versioning operations occurred.
2018
DAV_DECLARE(dav_error *) dav_auto_checkout(
2020
dav_resource *resource,
2022
dav_auto_version_info *av_info);
2024
/* Revert the writability of resources back to what they were
2025
* before they were modified. If undo == 0, then the resource
2026
* modifications are maintained (i.e. they are checked in).
2027
* If undo != 0, then resource modifications are discarded
2028
* (i.e. they are unchecked out).
2030
* Set the unlock flag to indicate that the resource is about
2031
* to be unlocked; it will be checked in if the resource
2032
* auto-versioning property indicates it should be. In this case,
2033
* av_info is ignored, so it can be NULL.
2035
* The resource argument may be NULL if only the parent resource
2036
* was checked out (i.e. the parent_only was != 0 in the
2037
* dav_auto_checkout call).
2039
DAV_DECLARE(dav_error *) dav_auto_checkin(
2041
dav_resource *resource,
2044
dav_auto_version_info *av_info);
2047
** This structure is used to describe available reports
2049
** "nmspace" should be valid XML and URL-quoted. mod_dav will place
2050
** double-quotes around it and use it in an xmlns declaration.
2053
const char *nmspace; /* namespace of the XML report element */
2054
const char *name; /* element name for the XML report */
2058
/* Versioning provider hooks */
2059
struct dav_hooks_vsn
2063
** The following hooks are mandatory for all versioning providers;
2064
** they define the functionality needed to implement "core" versioning.
2067
/* Return supported versioning options.
2068
* Each dav_text item in the list will be returned as a separate
2069
* DAV header. Providers are advised to limit the length of an
2070
* individual text item to 63 characters, to conform to the limit
2071
* used by MS Web Folders.
2073
void (*get_vsn_options)(apr_pool_t *p, apr_text_header *phdr);
2075
/* Get the value of a specific option for an OPTIONS request.
2076
* The option being requested is given by the parsed XML
2077
* element object "elem". The value of the option should be
2078
* appended to the "option" text object.
2080
dav_error * (*get_option)(const dav_resource *resource,
2081
const apr_xml_elem *elem,
2082
apr_text_header *option);
2084
/* Determine whether a non-versioned (or non-existent) resource
2085
* is versionable. Returns != 0 if resource can be versioned.
2087
int (*versionable)(const dav_resource *resource);
2089
/* Determine whether auto-versioning is enabled for a resource
2090
* (which may not exist, or may not be versioned). If the resource
2091
* is a checked-out resource, the provider must only enable
2092
* auto-checkin if the resource was automatically checked out.
2094
* The value returned depends on both the state of the resource
2095
* and the value of its DAV:auto-version property. See the description
2096
* of the dav_auto_version enumeration above for the details.
2098
dav_auto_version (*auto_versionable)(const dav_resource *resource);
2100
/* Put a resource under version control. If the resource already
2101
* exists unversioned, then it becomes the initial version of the
2102
* new version history, and it is replaced by a version selector
2103
* which targets the new version.
2105
* If the resource does not exist, then a new version-controlled
2106
* resource is created which either targets an existing version (if the
2107
* "target" argument is not NULL), or the initial, empty version
2108
* in a new history resource (if the "target" argument is NULL).
2110
* If successful, the resource object state is updated appropriately
2111
* (that is, changed to refer to the new version-controlled resource).
2113
dav_error * (*vsn_control)(dav_resource *resource,
2114
const char *target);
2116
/* Checkout a resource. If successful, the resource
2117
* object state is updated appropriately.
2119
* The auto_checkout flag will be set if this checkout is being
2120
* done automatically, as part of some method which modifies
2121
* the resource. The provider must remember that the resource
2122
* was automatically checked out, so it can determine whether it
2123
* can be automatically checked in. (Auto-checkin should only be
2124
* enabled for resources which were automatically checked out.)
2126
* If the working resource has a different URL from the
2127
* target resource, a dav_resource descriptor is returned
2128
* for the new working resource. Otherwise, the original
2129
* resource descriptor will refer to the working resource.
2130
* The working_resource argument can be NULL if the caller
2131
* is not interested in the working resource.
2133
* If the client has specified DAV:unreserved or DAV:fork-ok in the
2134
* checkout request, then the corresponding flags are set. If
2135
* DAV:activity-set has been specified, then create_activity is set
2136
* if DAV:new was specified; otherwise, the DAV:href elements' CDATA
2137
* (the actual href text) is passed in the "activities" array (each
2138
* element of the array is a const char *). activities will be NULL
2139
* no DAV:activity-set was provided or when create_activity is set.
2141
dav_error * (*checkout)(dav_resource *resource,
2143
int is_unreserved, int is_fork_ok,
2144
int create_activity,
2145
apr_array_header_t *activities,
2146
dav_resource **working_resource);
2148
/* Uncheckout a checked-out resource. If successful, the resource
2149
* object state is updated appropriately.
2151
dav_error * (*uncheckout)(dav_resource *resource);
2153
/* Checkin a checked-out resource. If successful, the resource
2154
* object state is updated appropriately, and the
2155
* version_resource descriptor will refer to the new version.
2156
* The version_resource argument can be NULL if the caller
2157
* is not interested in the new version resource.
2159
* If the client has specified DAV:keep-checked-out in the checkin
2160
* request, then the keep_checked_out flag is set. The provider
2161
* should create a new version, but keep the resource in the
2162
* checked-out state.
2164
dav_error * (*checkin)(dav_resource *resource,
2165
int keep_checked_out,
2166
dav_resource **version_resource);
2169
** Return the set of reports available at this resource.
2171
** An array of report elements should be returned, with an end-marker
2172
** element containing namespace==NULL. The value of the
2173
** DAV:supported-report-set property will be constructed and
2176
dav_error * (*avail_reports)(const dav_resource *resource,
2177
const dav_report_elem **reports);
2180
** Determine whether a Label header can be used
2181
** with a particular report. The dav_xml_doc structure
2182
** contains the parsed report request body.
2183
** Returns 0 if the Label header is not allowed.
2185
int (*report_label_header_allowed)(const apr_xml_doc *doc);
2188
** Generate a report on a resource. Since a provider is free
2189
** to define its own reports, and the value of request headers
2190
** may affect the interpretation of a report, the request record
2191
** must be passed to this routine.
2193
** The dav_xml_doc structure contains the parsed report request
2194
** body. The report response should be generated into the specified
2197
** If an error occurs, and a response has not yet been generated,
2198
** then an error can be returned from this function. mod_dav will
2199
** construct an appropriate error response. Once some output has
2200
** been placed into the filter, however, the provider should not
2201
** return an error -- there is no way that mod_dav can deliver it
2204
** ### maybe we need a way to signal an error anyways, and then
2205
** ### apache can abort the connection?
2207
dav_error * (*deliver_report)(request_rec *r,
2208
const dav_resource *resource,
2209
const apr_xml_doc *doc,
2210
ap_filter_t *output);
2214
** The following hooks are optional; if not defined, then the
2215
** corresponding protocol methods will be unsupported.
2219
** Set the state of a checked-in version-controlled resource.
2221
** If the request specified a version, the version resource
2222
** represents that version. If the request specified a label,
2223
** then "version" is NULL, and "label" is the label.
2225
** The depth argument is ignored for a file, and can be 0, 1, or
2226
** DAV_INFINITY for a collection. The depth argument only applies
2227
** with a label, not a version.
2229
** If an error occurs in a child resource, then the return value is
2230
** non-NULL, and *response is set to a multistatus response.
2232
** This hook is optional; if not defined, then the UPDATE method
2233
** will not be supported.
2235
dav_error * (*update)(const dav_resource *resource,
2236
const dav_resource *version,
2239
dav_response **response);
2242
** Add a label to a version. The resource is either a specific
2243
** version, or a version selector, in which case the label should
2244
** be added to the current target of the version selector. The
2245
** version selector cannot be checked out.
2247
** If replace != 0, any existing label by the same name is
2248
** effectively deleted first. Otherwise, it is an error to
2249
** attempt to add a label which already exists on some version
2250
** of the same history resource.
2252
** This hook is optional; if not defined, then the LABEL method
2253
** will not be supported. If it is defined, then the remove_label
2254
** hook must be defined also.
2256
dav_error * (*add_label)(const dav_resource *resource,
2261
** Remove a label from a version. The resource is either a specific
2262
** version, or a version selector, in which case the label should
2263
** be added to the current target of the version selector. The
2264
** version selector cannot be checked out.
2266
** It is an error if no such label exists on the specified version.
2268
** This hook is optional, but if defined, the add_label hook
2269
** must be defined also.
2271
dav_error * (*remove_label)(const dav_resource *resource,
2275
** Determine whether a null resource can be created as a workspace.
2276
** The provider may restrict workspaces to certain locations.
2277
** Returns 0 if the resource cannot be a workspace.
2279
** This hook is optional; if the provider does not support workspaces,
2280
** it should be set to NULL.
2282
int (*can_be_workspace)(const dav_resource *resource);
2285
** Create a workspace resource. The resource must not already
2286
** exist. Any <DAV:mkworkspace> element is passed to the provider
2287
** in the "doc" structure; it may be empty.
2289
** If workspace creation is succesful, the state of the resource
2290
** object is updated appropriately.
2292
** This hook is optional; if the provider does not support workspaces,
2293
** it should be set to NULL.
2295
dav_error * (*make_workspace)(dav_resource *resource,
2299
** Determine whether a null resource can be created as an activity.
2300
** The provider may restrict activities to certain locations.
2301
** Returns 0 if the resource cannot be an activity.
2303
** This hook is optional; if the provider does not support activities,
2304
** it should be set to NULL.
2306
int (*can_be_activity)(const dav_resource *resource);
2309
** Create an activity resource. The resource must not already
2312
** If activity creation is succesful, the state of the resource
2313
** object is updated appropriately.
2315
** This hook is optional; if the provider does not support activities,
2316
** it should be set to NULL.
2318
dav_error * (*make_activity)(dav_resource *resource);
2321
** Merge a resource (tree) into target resource (tree).
2325
** This hook is optional; if the provider does not support merging,
2326
** then this should be set to NULL.
2328
dav_error * (*merge)(dav_resource *target, dav_resource *source,
2329
int no_auto_merge, int no_checkout,
2330
apr_xml_elem *prop_elem,
2331
ap_filter_t *output);
2334
** If a provider needs a context to associate with this hooks structure,
2335
** then this field may be used. In most cases, it will just be NULL.
2341
/* --------------------------------------------------------------------
2343
** BINDING FUNCTIONS
2346
/* binding provider hooks */
2347
struct dav_hooks_binding {
2349
/* Determine whether a resource can be the target of a binding.
2350
* Returns 0 if the resource cannot be a binding target.
2352
int (*is_bindable)(const dav_resource *resource);
2354
/* Create a binding to a resource.
2355
* The resource argument is the target of the binding;
2356
* the binding argument must be a resource which does not already
2359
dav_error * (*bind_resource)(const dav_resource *resource,
2360
dav_resource *binding);
2363
** If a provider needs a context to associate with this hooks structure,
2364
** then this field may be used. In most cases, it will just be NULL.
2371
/* --------------------------------------------------------------------
2373
** SEARCH(DASL) FUNCTIONS
2376
/* search provider hooks */
2377
struct dav_hooks_search {
2378
/* Set header for a OPTION method
2379
* An error may be returned.
2380
* To set a hadder, this function might call
2381
* apr_table_setn(r->headers_out, "DASL", dasl_optin1);
2384
* DASL: <DAV:basicsearch>
2385
* DASL: <http://foo.bar.com/syntax1>
2386
* DASL: <http://akuma.com/syntax2>
2388
dav_error * (*set_option_head)(request_rec *r);
2391
* An error may be returned. *response will contain multistatus
2392
* responses (if any) suitable for the body of the error. It is also
2393
* possible to return NULL, yet still have multistatus responses.
2394
* In this case, typically the caller should return a 207 (Multistatus)
2395
* and the responses (in the body) as the HTTP response.
2397
dav_error * (*search_resource)(request_rec *r,
2398
dav_response **response);
2401
** If a provider needs a context to associate with this hooks structure,
2402
** then this field may be used. In most cases, it will just be NULL.
2409
/* --------------------------------------------------------------------
2411
** MISCELLANEOUS STUFF
2414
/* fetch the "LimitXMLRequestBody" in force for this resource */
2415
DAV_DECLARE(apr_size_t) dav_get_limit_xml_body(const request_rec *r);
2418
int propid; /* live property ID */
2419
const dav_hooks_liveprop *provider; /* the provider defining this prop */
2426
#endif /* _MOD_DAV_H_ */