libical, expat, and libsieve are now *required*.
[citadel.git] / webcit / serv_func.c
index 2fc570fe4367fe54a31d240e3ade6a55e7fc4206..a5d37199b3fa408471aeb9e3ee74bc3824b284eb 100644 (file)
@@ -1,24 +1,24 @@
 /*
  * $Id$
- *
- * Handles various types of data transfer operations with the Citadel service.
- *
  */
 
 #include "webcit.h"
 #include "webserver.h"
 
-struct serv_info serv_info;
+struct serv_info serv_info; /**< our connection data to the server */
 
 /*
  * get info about the server we've connected to
+ *
+ * browser_host                the citadell we want to connect to
+ * user_agent          which browser uses our client?
  */
 void get_serv_info(char *browser_host, char *user_agent)
 {
        char buf[SIZ];
        int a;
 
-       /* Tell the server what kind of client is connecting */
+       /** Tell the server what kind of client is connecting */
        serv_printf("IDEN %d|%d|%d|%s|%s",
                DEVELOPER_ID,
                CLIENT_ID,
@@ -28,20 +28,19 @@ void get_serv_info(char *browser_host, char *user_agent)
        );
        serv_getln(buf, sizeof buf);
 
-       /* Tell the server what kind of richtext we prefer */
+       /** Tell the server what kind of richtext we prefer */
        serv_puts("MSGP text/html|text/plain");
        serv_getln(buf, sizeof buf);
 
-#ifdef WEBCIT_WITH_CALENDAR_SERVICE
-       /* Tell the server that when we save a calendar event, we
+       /*
+        * Tell the server that when we save a calendar event, we
         * want invitations to be generated by the Citadel server
         * instead of by the client.
         */
        serv_puts("ICAL sgi|1");
        serv_getln(buf, sizeof buf);
-#endif
 
-       /* Now ask the server to tell us a little bit about itself... */
+       /** Now ask the server to tell us a little bit about itself... */
        serv_puts("INFO");
        serv_getln(buf, sizeof buf);
        if (buf[0] != '1')
@@ -81,6 +80,18 @@ void get_serv_info(char *browser_host, char *user_agent)
                case 14:
                        serv_info.serv_supports_ldap = atoi(buf);
                        break;
+               case 15:
+                       serv_info.serv_newuser_disabled = atoi(buf);
+                       break;
+               case 16:
+                       safestrncpy(serv_info.serv_default_cal_zone, buf, sizeof serv_info.serv_default_cal_zone);
+                       break;
+               case 20:
+                       serv_info.serv_supports_sieve = atoi(buf);
+                       break;
+               case 21:
+                       serv_info.serv_fulltext_enabled = atoi(buf);
+                       break;
                }
                ++a;
        }
@@ -88,8 +99,9 @@ void get_serv_info(char *browser_host, char *user_agent)
 
 
 
-/* 
- * Read Citadel variformat text and spit it out as HTML.
+/**
+ * \brief Read Citadel variformat text and spit it out as HTML.
+ * \param align html align string
  */
 void fmout(char *align)
 {
@@ -105,7 +117,8 @@ void fmout(char *align)
                }
                intext = 1;
 
-               /* Quoted text should be displayed in italics and in a
+               /**
+                * Quoted text should be displayed in italics and in a
                 * different colour.  This code understands Citadel-style
                 * " >" quotes and will convert to <BLOCKQUOTE> tags.
                 */
@@ -119,7 +132,7 @@ void fmout(char *align)
                if ((bq == 1) && (!strncmp(buf, " >", 2))) {
                        strcpy(buf, &buf[2]);
                }
-               /* Activate embedded URL's */
+               /** Activate embedded URL's */
                url(buf);
 
                escputs(buf);
@@ -134,8 +147,8 @@ void fmout(char *align)
 
 
 
-/* 
- * Read Citadel variformat text and spit it out as HTML in a form
+/**
+ * \brief Read Citadel variformat text and spit it out as HTML in a form
  * suitable for embedding in another message (forward/quote).
  * (NO LINEBREAKS ALLOWED HERE!)
  */
@@ -151,7 +164,8 @@ void pullquote_fmout(void) {
                }
                intext = 1;
 
-               /* Quoted text should be displayed in italics and in a
+               /**
+                * Quoted text should be displayed in italics and in a
                 * different colour.  This code understands Citadel-style
                 * " >" quotes and will convert to <BLOCKQUOTE> tags.
                 */
@@ -176,16 +190,15 @@ void pullquote_fmout(void) {
 
 
 
-/*
- * Transmit message text (in memory) to the server.
- * If convert_to_html is set to 1, the message is converted into something
- * which kind of resembles HTML.
+/**
+ * \brief Transmit message text (in memory) to the server.
+ *
+ * \param ptr Pointer to the message being transmitted
  */
-void text_to_server(char *ptr, int convert_to_html)
+void text_to_server(char *ptr)
 {
-       char buf[SIZ];
-       char conv[4];
-       int ch, a, pos;
+       char buf[256];
+       int ch, a, pos, len;
 
        pos = 0;
        buf[0] = 0;
@@ -193,20 +206,14 @@ void text_to_server(char *ptr, int convert_to_html)
        while (ptr[pos] != 0) {
                ch = ptr[pos++];
                if (ch == 10) {
-                       while ( (isspace(buf[strlen(buf) - 1]))
-                         && (strlen(buf) > 1) )
-                               buf[strlen(buf) - 1] = 0;
+                       len = strlen(buf);
+                       while ( (isspace(buf[len - 1]))
+                               && (buf[0] !=  '\0') 
+                               && (buf[1] !=  '\0') )
+                               buf[--len] = 0;
                        serv_puts(buf);
                        buf[0] = 0;
-                       if (convert_to_html) {
-                               strcat(buf, "<br />");
-                       }
-                       else {
-                               if (ptr[pos] != 0) strcat(buf, " ");
-                       }
-               } else if ((convert_to_html)&&(strchr("#&;`'|*?-~<>^()[]{}$\\", ch) != NULL)) {
-                       sprintf(conv, "%c", ch);
-                       stresc(&buf[strlen(buf)], conv, 0, 0);
+                       if (ptr[pos] != 0) strcat(buf, " ");
                } else {
                        a = strlen(buf);
                        buf[a + 1] = 0;
@@ -223,13 +230,87 @@ void text_to_server(char *ptr, int convert_to_html)
                }
        }
        serv_puts(buf);
+}
+
+
+/**
+ * \brief Transmit message text (in memory) to the server,
+ *        converting to Quoted-Printable encoding as we go.
+ *
+ * \param ptr Pointer to the message being transmitted
+ */
+void text_to_server_qp(char *ptr)
+{
+       unsigned char ch, buf[256];
+       int pos;
+       int output_len = 0;
+
+       pos = 0;
+       buf[0] = 0;
+       output_len = 0;
+
+       while (ptr[pos] != 0) {
+               ch = (unsigned char)(ptr[pos++]);
+
+               if (ch == 13) {
+                       /* ignore carriage returns */
+               }
+               else if (ch == 10) {
+                       /* hard line break */
+                       if (output_len > 0) {
+                               if (isspace(buf[output_len-1])) {
+                                       sprintf((char *)&buf[output_len-1], "=%02X", buf[output_len-1]);
+                                       output_len += 2;
+                               }
+                       }
+                       buf[output_len++] = 0;
+                       serv_puts((char *)buf);
+                       output_len = 0;
+               }
+               else if (ch == 9) {
+                       buf[output_len++] = ch;
+               }
+               else if ( (ch >= 32) && (ch <= 60) ) {
+                       buf[output_len++] = ch;
+               }
+               else if ( (ch >= 62) && (ch <= 126) ) {
+                       buf[output_len++] = ch;
+               }
+               else {
+                       sprintf((char *)&buf[output_len], "=%02X", ch);
+                       output_len += 3;
+               }
+               
+               if (output_len > 72) {
+                       /* soft line break */
+                       if (isspace(buf[output_len-1])) {
+                               sprintf((char *)&buf[output_len-1], "=%02X", buf[output_len-1]);
+                               output_len += 2;
+                       }
+                       buf[output_len++] = '=';
+                       buf[output_len++] = 0;
+                       serv_puts((char *)buf);
+                       output_len = 0;
+               }
+       }
 
+       /* end of data - transmit anything that's left */
+       if (output_len > 0) {
+               if (isspace(buf[output_len-1])) {
+                       sprintf((char *)&buf[output_len-1], "=%02X", buf[output_len-1]);
+                       output_len += 2;
+               }
+               buf[output_len++] = 0;
+               serv_puts((char *)buf);
+               output_len = 0;
+       }
 }
 
 
 
-/*
- * translate server message output to text
+
+/**
+ * \brief translate server message output to text
  * (used for editing room info files and such)
  */
 void server_to_text()
@@ -249,9 +330,11 @@ void server_to_text()
 
 
 
-/*
+/**
  * Read binary data from server into memory using a series of
  * server READ commands.
+ * \param buffer the output buffer
+ * \param total_len the maximal length of buffer
  */
 void read_server_binary(char *buffer, size_t total_len) {
        char buf[SIZ];
@@ -281,8 +364,8 @@ void read_server_binary(char *buffer, size_t total_len) {
 }
 
 
-/*
- * Read text from server, appending to a string buffer until the
+/**
+ * \brief Read text from server, appending to a string buffer until the
  * usual 000 terminator is found.  Caller is responsible for freeing
  * the returned pointer.
  */
@@ -317,3 +400,7 @@ char *read_server_text(void) {
 
        return(text);
 }
+
+
+
+/*@}*/