more doxygen doku.
[citadel.git] / webcit / groupdav_propfind.c
index b3f2d3b816885c038486ed6fe74c12e301ab3b40..266bd1430f1d572e80b6e2dd72b68aba57f0271d 100644 (file)
@@ -1,7 +1,8 @@
 /*
  * $Id$
- *
- * Handles GroupDAV PROPFIND requests.
+ */
+/**
+ * \defgroup GroupdavPropfind Handles GroupDAV PROPFIND requests.
  *
  * A few notes about our XML output:
  *
  *
  */
 
-#include <ctype.h>
-#include <stdlib.h>
-#include <unistd.h>
-#include <stdio.h>
-#include <fcntl.h>
-#include <signal.h>
-#include <sys/types.h>
-#include <sys/wait.h>
-#include <sys/socket.h>
-#include <limits.h>
-#include <string.h>
-#include <pwd.h>
-#include <errno.h>
-#include <stdarg.h>
-#include <time.h>
-#include <pthread.h>
 #include "webcit.h"
 #include "webserver.h"
 #include "groupdav.h"
 
 
-/*
+/**
+ * \brief get all messages of this user
  * Given an encoded UID, translate that to an unencoded Citadel EUID and
  * then search for it in the current room.  Return a message number or -1
  * if not found.
  *
  * NOTE: this function relies on the Citadel server's brute-force search.
  * There's got to be a way to optimize this better.
+ * \param uid the user to get the data for...
  */
 long locate_message_by_uid(char *uid) {
        char buf[SIZ];
@@ -52,21 +39,17 @@ long locate_message_by_uid(char *uid) {
        /* Decode the uid */
        euid_unescapize(decoded_uid, uid);
 
-       serv_puts("MSGS ALL|0|1");
-       serv_gets(buf);
-       if (buf[0] == '8') {
-               serv_printf("exti|%s", decoded_uid);
-               serv_puts("000");
-               while (serv_gets(buf), strcmp(buf, "000")) {
-                       retval = atol(buf);
-               }
+       serv_printf("EUID %s", decoded_uid);
+       serv_getln(buf, sizeof buf);
+       if (buf[0] == '2') {
+               retval = extract_long(&buf[4], 0);
        }
        return(retval);
 }
 
 
-/*
- * List folders containing interesting groupware objects
+/**
+ * \brief List folders containing interesting groupware objects
  */
 void groupdav_folder_list(void) {
        char buf[SIZ];
@@ -78,11 +61,11 @@ void groupdav_folder_list(void) {
        now = time(NULL);
        http_datestring(datestring, sizeof datestring, now);
 
-       /*
+       /**
         * Be rude.  Completely ignore the XML request and simply send them
         * everything we know about.  Let the client sort it out.
         */
-       wprintf("HTTP/1.0 207 Multi-Status\r\n");
+       wprintf("HTTP/1.1 207 Multi-Status\r\n");
        groupdav_common_headers();
        wprintf("Date: %s\r\n", datestring);
        wprintf("Content-type: text/xml\r\n");
@@ -91,17 +74,17 @@ void groupdav_folder_list(void) {
        begin_burst();
 
        wprintf("<?xml version=\"1.0\" encoding=\"utf-8\"?>"
-               "<D:multistatus xmlns:D=\"DAV:\">"
+               "<D:multistatus xmlns:D=\"DAV:\" xmlns:G=\"http://groupdav.org/\">"
        );
 
        serv_puts("LKRA");
-       serv_gets(buf);
-       if (buf[0] == '1') while (serv_gets(buf), strcmp(buf, "000")) {
+       serv_getln(buf, sizeof buf);
+       if (buf[0] == '1') while (serv_getln(buf, sizeof buf), strcmp(buf, "000")) {
 
-               extract(roomname, buf, 0);
+               extract_token(roomname, buf, 0, '|', sizeof roomname);
                view = extract_int(buf, 6);
 
-               /*
+               /**
                 * For now, only list rooms that we know a GroupDAV client
                 * might be interested in.  In the future we may add
                 * the rest.
@@ -125,9 +108,9 @@ void groupdav_folder_list(void) {
                        wprintf("<D:propstat>");
                        wprintf("<D:status>HTTP/1.1 200 OK</D:status>");
                        wprintf("<D:prop>");
-                       wprintf("<D:displayname>");
+                       wprintf("<D:fullname>");
                        escputs(roomname);
-                       wprintf("</D:displayname>");
+                       wprintf("</D:fullname>");
                        wprintf("<D:resourcetype><D:collection/>");
 
                        switch(view) {
@@ -155,37 +138,37 @@ void groupdav_folder_list(void) {
 
 
 
-/*
- * The pathname is always going to be /groupdav/room_name/msg_num
+/**
+ * \brief Search though a davname
+ * \param dav_pathname The pathname is always going to be /groupdav/room_name/msg_num
  */
 void groupdav_propfind(char *dav_pathname) {
-       char dav_roomname[SIZ];
-       char msgnum[SIZ];
-       char buf[SIZ];
-       char uid[SIZ];
-       char encoded_uid[SIZ];
+       char dav_roomname[256];
+       char dav_uid[256];
+       char msgnum[256];
+       long dav_msgnum = (-1);
+       char buf[256];
+       char uid[256];
+       char encoded_uid[256];
        long *msgs = NULL;
        int num_msgs = 0;
        int i;
-       char datestring[SIZ];
+       char datestring[256];
        time_t now;
 
        now = time(NULL);
        http_datestring(datestring, sizeof datestring, now);
 
-
-       /* First, break off the "/groupdav/" prefix */
-       remove_token(dav_pathname, 0, '/');
-       remove_token(dav_pathname, 0, '/');
-
-       /* What's left is the room name.  Remove trailing slashes. */
-       if (dav_pathname[strlen(dav_pathname)-1] == '/') {
-               dav_pathname[strlen(dav_pathname)-1] = 0;
-       }
-       strcpy(dav_roomname, dav_pathname);
-
+       extract_token(dav_roomname, dav_pathname, 2, '/', sizeof dav_roomname);
+       extract_token(dav_uid, dav_pathname, 3, '/', sizeof dav_uid);
 
        /*
+       lprintf(9, "dav_pathname: %s\n", dav_pathname);
+       lprintf(9, "dav_roomname: %s\n", dav_roomname);
+       lprintf(9, "     dav_uid: %s\n", dav_uid);
+       */
+
+       /**
         * If the room name is blank, the client is requesting a
         * folder list.
         */
@@ -211,12 +194,79 @@ void groupdav_propfind(char *dav_pathname) {
                return;
        }
 
-       /*
+       /**
+        * If dav_uid is non-empty, client is requesting a PROPFIND on
+        * a specific item in the room.  This is not valid GroupDAV, but
+        * we try to honor it anyway because some clients are expecting
+        * it to work...
+        */
+       if (strlen(dav_uid) > 0) {
+
+               dav_msgnum = locate_message_by_uid(dav_uid);
+               if (dav_msgnum < 0) {
+                       wprintf("HTTP/1.1 404 not found\r\n");
+                       groupdav_common_headers();
+                       wprintf(
+                               "Content-Type: text/plain\r\n"
+                               "\r\n"
+                               "Object \"%s\" was not found in the \"%s\" folder.\r\n",
+                               dav_uid,
+                               dav_roomname
+                       );
+                       return;
+               }
+
+               /**
+                * Be rude.  Completely ignore the XML request and simply send them
+                * everything we know about (which is going to simply be the ETag and
+                * nothing else).  Let the client-side parser sort it out.
+                */
+               wprintf("HTTP/1.1 207 Multi-Status\r\n");
+               groupdav_common_headers();
+               wprintf("Date: %s\r\n", datestring);
+               wprintf("Content-type: text/xml\r\n");
+               wprintf("Content-encoding: identity\r\n");
+       
+               begin_burst();
+       
+               wprintf("<?xml version=\"1.0\" encoding=\"utf-8\"?>"
+                       "<D:multistatus xmlns:D=\"DAV:\" xmlns:G=\"http://groupdav.org/\">"
+               );
+
+               wprintf("<D:response>");
+
+               wprintf("<D:href>");
+               if (strlen(WC->http_host) > 0) {
+                       wprintf("%s://%s",
+                               (is_https ? "https" : "http"),
+                               WC->http_host);
+               }
+               wprintf("/groupdav/");
+               urlescputs(WC->wc_roomname);
+               euid_escapize(encoded_uid, dav_uid);
+               wprintf("/%s", encoded_uid);
+               wprintf("</D:href>");
+               wprintf("<D:propstat>");
+               wprintf("<D:status>HTTP/1.1 200 OK</D:status>");
+               wprintf("<D:prop><D:getetag>\"%ld\"</D:getetag></D:prop>", dav_msgnum);
+               wprintf("</D:propstat>");
+
+               wprintf("</D:response>\n");
+               wprintf("</D:multistatus>\n");
+               end_burst();
+               return;
+       }
+
+
+       /**
+        * We got to this point, which means that the client is requesting
+        * a 'collection' (i.e. a list of all items in the room).
+        *
         * Be rude.  Completely ignore the XML request and simply send them
         * everything we know about (which is going to simply be the ETag and
         * nothing else).  Let the client-side parser sort it out.
         */
-       wprintf("HTTP/1.0 207 Multi-Status\r\n");
+       wprintf("HTTP/1.1 207 Multi-Status\r\n");
        groupdav_common_headers();
        wprintf("Date: %s\r\n", datestring);
        wprintf("Content-type: text/xml\r\n");
@@ -225,12 +275,12 @@ void groupdav_propfind(char *dav_pathname) {
        begin_burst();
 
        wprintf("<?xml version=\"1.0\" encoding=\"utf-8\"?>"
-               "<D:multistatus xmlns:D=\"DAV:\">"
+               "<D:multistatus xmlns:D=\"DAV:\" xmlns:G=\"http://groupdav.org/\">"
        );
 
        serv_puts("MSGS ALL");
-       serv_gets(buf);
-       if (buf[0] == '1') while (serv_gets(msgnum), strcmp(msgnum, "000")) {
+       serv_getln(buf, sizeof buf);
+       if (buf[0] == '1') while (serv_getln(msgnum, sizeof msgnum), strcmp(msgnum, "000")) {
                msgs = realloc(msgs, ++num_msgs * sizeof(long));
                msgs[num_msgs-1] = atol(msgnum);
        }
@@ -239,8 +289,8 @@ void groupdav_propfind(char *dav_pathname) {
 
                strcpy(uid, "");
                serv_printf("MSG0 %ld|3", msgs[i]);
-               serv_gets(buf);
-               if (buf[0] == '1') while (serv_gets(buf), strcmp(buf, "000")) {
+               serv_getln(buf, sizeof buf);
+               if (buf[0] == '1') while (serv_getln(buf, sizeof buf), strcmp(buf, "000")) {
                        if (!strncasecmp(buf, "exti=", 5)) {
                                strcpy(uid, &buf[5]);
                        }
@@ -274,3 +324,5 @@ void groupdav_propfind(char *dav_pathname) {
                free(msgs);
        }
 }
+
+/*@}*/