chiark / gitweb /
cookie header parser
[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);
57char *mime_base64(const char *s);
58/* convert quoted-printable or base64 data */
59
39d4aa6b
RK
60/** @brief Parsed form of an HTTP Cookie: header field */
61struct cookiedata {
62 /** @brief @c $Version or NULL if not set */
63 char *version;
64
65 /** @brief List of cookies */
66 struct cookie *cookies;
67
68 /** @brief Number of cookies */
69 int ncookies;
70};
71
72/** @brief A parsed cookie */
73struct cookie {
74 /** @brief Cookie name */
75 char *name;
76
77 /** @brief Cookie value */
78 char *value;
79
80 /** @brief Cookie path */
81 char *path;
82
83 /** @brief Cookie domain */
84 char *domain;
85
86};
87
88int parse_cookie(const char *s,
89 struct cookiedata *cd);
90const struct cookie *find_cookie(const struct cookiedata *cd,
91 const char *name);
92
93
460b9539 94#endif /* MIME_H */
95
96/*
97Local Variables:
98c-basic-offset:2
99comment-column:40
100fill-column:79
101End:
102*/