chiark - git - mdw - disorder/blob - lib/mime.h

   1 /*
   2  * This file is part of DisOrder
   3  * Copyright (C) 2005, 2007, 2008 Richard Kettlewell
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful, but
  11  * WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13  * General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
  18  * USA
  19  */
  20 /** @file lib/mime.h
  21  * @brief Support for MIME and allied protocols
  22  */
  23
  24 #ifndef MIME_H
  25 #define MIME_H
  26
  27 struct kvp;
  28
  29 int mime_content_type(const char *s,
  30                       char **typep,
  31                       struct kvp **parametersp);
  32
  33 const char *mime_parse(const char *s,
  34                        int (*callback)(const char *name, const char *value,
  35                                        void *u),
  36                        void *u);
  37 /* Parse a MIME message.  Calls CALLBACK for each header field, then returns a
  38  * pointer to the decoded body (might or might not point back into the original
  39  * string). */
  40
  41 int mime_multipart(const char *s,
  42                    int (*callback)(const char *s, void *u),
  43                    const char *boundary,
  44                    void *u);
  45 /* call CALLBACK with each part of multipart document [s,s+n) */
  46
  47 int mime_rfc2388_content_disposition(const char *s,
  48                                      char **dispositionp,
  49                                      char **parameternamep,
  50                                      char **parametervaluep);
  51 /* Parse an RFC2388-style content-disposition field */
  52
  53 char *mime_qp(const char *s);
  54
  55 /** @brief Parsed form of an HTTP Cookie: header field
  56  *
  57  * See <a href="http://tools.ietf.org/html/rfc2109">RFC 2109</a>.
  58  */
  59 struct cookiedata {
  60   /** @brief @c $Version or NULL if not set */
  61   char *version;
  62
  63   /** @brief List of cookies */
  64   struct cookie *cookies;
  65
  66   /** @brief Number of cookies */
  67   int ncookies;
  68 };
  69
  70 /** @brief A parsed cookie
  71  *
  72  * See <a href="http://tools.ietf.org/html/rfc2109">RFC 2109</a> and @ref
  73  * cookiedata.
  74  */
  75 struct cookie {
  76   /** @brief Cookie name */
  77   char *name;
  78
  79   /** @brief Cookie value */
  80   char *value;
  81
  82   /** @brief Cookie path */
  83   char *path;
  84
  85   /** @brief Cookie domain */
  86   char *domain;
  87
  88 };
  89
  90 int parse_cookie(const char *s,
  91                  struct cookiedata *cd);
  92 const struct cookie *find_cookie(const struct cookiedata *cd,
  93                                  const char *name);
  94 char *quote822(const char *s, int force);
  95 char *mime_to_qp(const char *text);
  96 const char *mime_encode_text(const char *text,
  97                              const char **charsetp,
  98                              const char **encodingp);
  99 const char *mime_parse_word(const char *s, char **valuep,
 100                             int (*special)(int));
 101 int mime_http_separator(int c);
 102 int mime_tspecial(int c);
 103
 104 #endif /* MIME_H */
 105
 106 /*
 107 Local Variables:
 108 c-basic-offset:2
 109 comment-column:40
 110 fill-column:79
 111 End:
 112 */