2 * Entry point for GroupDAV functions
4 * Copyright (c) 2005-2012 by the citadel.org team
6 * This program is open source software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License, version 3.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
16 #include "webserver.h"
19 CtxType CTX_DAVNS = CTX_NONE;
20 extern HashList *HandlerHash;
22 HashList *DavNamespaces = NULL;
25 * Output HTTP headers which are common to all requests.
27 * Please observe that we don't use the usual output_headers()
28 * and wDumpContent() functions in the GroupDAV subsystem, so we
29 * do our own header stuff here.
32 void dav_common_headers(void) {
35 "Connection: close\r\n",
36 PACKAGE_STRING, ChrPtr(WC->serv_info->serv_software)
43 * string conversion function
45 void euid_escapize(char *target, const char *source) {
47 int target_length = 0;
51 for (i=0; i<len; ++i) {
52 if ( (isalnum(source[i])) || (source[i]=='-') || (source[i]=='_') ) {
53 target[target_length] = source[i];
54 target[++target_length] = 0;
57 sprintf(&target[target_length], "=%02X", (0xFF & source[i]));
64 * string conversion function
66 void euid_unescapize(char *target, const char *source) {
69 int target_length = 0;
74 for (a = 0; a < len; ++a) {
75 if (source[a] == '=') {
76 hex[0] = source[a + 1];
77 hex[1] = source[a + 2];
81 target[target_length] = b;
82 target[++target_length] = 0;
86 target[target_length] = source[a];
87 target[++target_length] = 0;
96 * Main entry point for GroupDAV requests
103 syslog(LOG_DEBUG, "dav_main() called, logged_in=%d", WCC->logged_in );
105 StrBufUnescape(WCC->Hdr->HR.ReqLine, 0);
106 StrBufStripSlashes(WCC->Hdr->HR.ReqLine, 0);
109 * If there's an If-Match: header, strip out the quotes if present, and
110 * then if all that's left is an asterisk, make it go away entirely.
112 len = StrLength(WCC->Hdr->HR.dav_ifmatch);
114 StrBufTrim(WCC->Hdr->HR.dav_ifmatch);
115 if (ChrPtr(WCC->Hdr->HR.dav_ifmatch)[0] == '\"') {
116 StrBufCutLeft(WCC->Hdr->HR.dav_ifmatch, 1);
118 for (i=0; i<len; ++i) {
119 if (ChrPtr(WCC->Hdr->HR.dav_ifmatch)[i] == '\"') {
120 StrBufCutAt(WCC->Hdr->HR.dav_ifmatch, i, NULL);
121 len = StrLength(WCC->Hdr->HR.dav_ifmatch);
125 if (!strcmp(ChrPtr(WCC->Hdr->HR.dav_ifmatch), "*")) {
126 FlushStrBuf(WCC->Hdr->HR.dav_ifmatch);
130 switch (WCC->Hdr->HR.eReqType)
133 * The OPTIONS method is not required by GroupDAV but it will be
134 * needed for future implementations of other DAV-based protocols.
141 * The PROPFIND method is basically used to list all objects in a
142 * room, or to list all relevant rooms on the server.
149 * The GET method is used for fetching individual items.
156 * The PUT method is used to add or modify items.
163 * The DELETE method kills, maims, and destroys.
170 * The REPORT method tells us that Mike Shaver is a self-righteous asshole.
178 * Couldn't find what we were looking for. Die in a car fire.
180 hprintf("HTTP/1.1 501 Method not implemented\r\n");
181 dav_common_headers();
182 hprintf("Content-Type: text/plain\r\n");
183 wc_printf("GroupDAV method \"%s\" is not implemented.\r\n",
184 ReqStrs[WCC->Hdr->HR.eReqType]);
191 * Output our host prefix for globally absolute URL's.
193 void dav_identify_host(void) {
194 wc_printf("%s", ChrPtr(site_prefix));
198 void tmplput_dav_HOSTNAME(StrBuf *Target, WCTemplputParams *TP)
200 StrBufAppendPrintf(Target, "%s", ChrPtr(site_prefix));
204 * Output our host prefix for globally absolute URL's.
206 void dav_identify_hosthdr(void) {
207 hprintf("%s", ChrPtr(site_prefix));
211 void Header_HandleIfMatch(StrBuf *Line, ParsedHttpHdrs *hdr)
213 hdr->HR.dav_ifmatch = Line;
217 void Header_HandleDepth(StrBuf *Line, ParsedHttpHdrs *hdr)
219 if (!strcasecmp(ChrPtr(Line), "infinity")) {
220 hdr->HR.dav_depth = 32767;
222 else if (strcmp(ChrPtr(Line), "0") == 0) {
223 hdr->HR.dav_depth = 0;
225 else if (strcmp(ChrPtr(Line), "1") == 0) {
226 hdr->HR.dav_depth = 1;
231 int Conditional_DAV_DEPTH(StrBuf *Target, WCTemplputParams *TP)
233 return WC->Hdr->HR.dav_depth == GetTemplateTokenNumber(Target, TP, 2, 0);
237 void RegisterDAVNamespace(const char * UrlString,
239 const char *DisplayName,
242 WebcitRESTDispatchID RID,
247 /* first put it in... */
248 WebcitAddUrlHandler(UrlString, UrlSLen, DisplayName, dslen, F, Flags|PARSE_REST_URL);
249 /* get it out again... */
250 GetHash(HandlerHash, UrlString, UrlSLen, &vHandler);
251 ((WebcitHandler*)vHandler)->RID = RID;
252 /* and keep a copy of it, so we can compare it later */
253 Put(DavNamespaces, UrlString, UrlSLen, vHandler, reference_free_handler);
257 int Conditional_DAV_NS(StrBuf *Target, WCTemplputParams *TP)
264 GetTemplateTokenString(NULL, TP, 2, &NS, &NSLen);
265 GetHash(HandlerHash, NS, NSLen, &vHandler);
266 return WCC->Hdr->HR.Handler == vHandler;
270 int Conditional_DAV_NSCURRENT(StrBuf *Target, WCTemplputParams *TP)
275 vHandler = CTX(CTX_NONE);
276 return WCC->Hdr->HR.Handler == vHandler;
280 void tmplput_DAV_NAMESPACE(StrBuf *Target, WCTemplputParams *TP)
284 if (TP->Filter.ContextType == CTX_DAVNS) {
286 H = (WebcitHandler*) CTX(CTX_DAVNS);
288 StrBufAppendTemplate(Target, TP, H->Name, 0);
290 else if (WCC->Hdr->HR.Handler != NULL) {
291 StrBufAppendTemplate(Target, TP, WCC->Hdr->HR.Handler->Name, 0);
296 int GroupdavDispatchREST(RESTDispatchID WhichAction, int IgnoreFloor)
303 GetHash(WCC->Directory, IKEY(WCC->ThisRoom->nRoomNameParts + 1), &vDir);
304 return locate_message_by_uid(ChrPtr((StrBuf*)vDir)) != -1;
305 /* TODO: remember euid */
317 ServerStartModule_DAV
321 DavNamespaces = NewHash(1, NULL);
326 ServerShutdownModule_DAV
329 DeleteHash(&DavNamespaces);
337 RegisterCTX(CTX_DAVNS);
338 RegisterDAVNamespace(HKEY("groupdav"), HKEY("GroupDAV"),
339 dav_main, GroupdavDispatchREST,
340 XHTTP_COMMANDS|COOKIEUNNEEDED|FORCE_SESSIONCLOSE
343 RegisterNamespace("DAV:HOSTNAME", 0, 0, tmplput_dav_HOSTNAME, NULL, CTX_NONE);
345 RegisterConditional(HKEY("COND:DAV:NS"), 0, Conditional_DAV_NS, CTX_NONE);
347 RegisterIterator("DAV:NS", 0, DavNamespaces, NULL,
348 NULL, NULL, CTX_DAVNS, CTX_NONE, IT_NOFLAG
351 RegisterConditional(HKEY("COND:DAV:NSCURRENT"), 0, Conditional_DAV_NSCURRENT, CTX_DAVNS);
352 RegisterNamespace("DAV:NAMESPACE", 0, 1, tmplput_DAV_NAMESPACE, NULL, CTX_NONE);
354 RegisterHeaderHandler(HKEY("IF-MATCH"), Header_HandleIfMatch);
355 RegisterHeaderHandler(HKEY("DEPTH"), Header_HandleDepth);
356 RegisterConditional(HKEY("COND:DAV:DEPTH"), 1, Conditional_DAV_DEPTH, CTX_NONE);