chiark / gitweb /
cgi: more graceful error handling in absence of server
[disorder] / lib / mime.h
CommitLineData
460b9539 1/*
2 * This file is part of DisOrder
39d4aa6b 3 * Copyright (C) 2005, 2007 Richard Kettlewell
460b9539 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 */
39d4aa6b
RK
20/** @file lib/mime.h
21 * @brief Support for MIME and allied protocols
22 */
460b9539 23
24#ifndef MIME_H
25#define MIME_H
26
27int mime_content_type(const char *s,
28 char **typep,
29 char **parameternamep,
30 char **parametervaluep);
31/* Parse a content-type value. returns 0 on success, -1 on error.
32 * paramaternamep and parametervaluep are only set if present.
33 * type and parametername are forced to lower case.
34 */
35
36const char *mime_parse(const char *s,
37 int (*callback)(const char *name, const char *value,
38 void *u),
39 void *u);
40/* Parse a MIME message. Calls CALLBACK for each header field, then returns a
41 * pointer to the decoded body (might or might not point back into the original
42 * string). */
43
44int mime_multipart(const char *s,
45 int (*callback)(const char *s, void *u),
46 const char *boundary,
47 void *u);
48/* call CALLBACK with each part of multipart document [s,s+n) */
49
50int mime_rfc2388_content_disposition(const char *s,
51 char **dispositionp,
52 char **parameternamep,
53 char **parametervaluep);
54/* Parse an RFC2388-style content-disposition field */
55
56char *mime_qp(const char *s);
460b9539 57
39d4aa6b
RK
58/** @brief Parsed form of an HTTP Cookie: header field */
59struct 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 */
71struct cookie {
72 /** @brief Cookie name */
73 char *name;
74
75 /** @brief Cookie value */
76 char *value;
77
78 /** @brief Cookie path */
79 char *path;
80
81 /** @brief Cookie domain */
82 char *domain;
83
84};
85
86int parse_cookie(const char *s,
87 struct cookiedata *cd);
88const struct cookie *find_cookie(const struct cookiedata *cd,
89 const char *name);
90
91
460b9539 92#endif /* MIME_H */
93
94/*
95Local Variables:
96c-basic-offset:2
97comment-column:40
98fill-column:79
99End:
100*/