bozohttpd.h revision 1.22 1 /* $NetBSD: bozohttpd.h,v 1.22 2012/03/14 23:47:19 joerg Exp $ */
2
3 /* $eterna: bozohttpd.h,v 1.39 2011/11/18 09:21:15 mrg Exp $ */
4
5 /*
6 * Copyright (c) 1997-2011 Matthew R. Green
7 * All rights reserved.
8 *
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
11 * are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer and
16 * dedication in the documentation and/or other materials provided
17 * with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
20 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
21 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
22 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
23 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
24 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
25 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
26 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 * SUCH DAMAGE.
30 *
31 */
32 #ifndef BOZOHTTOPD_H_
33 #define BOZOHTTOPD_H_ 1
34
35 #include <sys/queue.h>
36
37 #include <sys/stat.h>
38
39 #include <stdio.h>
40
41 /* lots of "const" but gets free()'ed etc at times, sigh */
42
43 /* headers */
44 typedef struct bozoheaders {
45 /*const*/ char *h_header;
46 /*const*/ char *h_value; /* this gets free()'ed etc at times */
47 SIMPLEQ_ENTRY(bozoheaders) h_next;
48 } bozoheaders_t;
49
50 typedef struct bozo_content_map_t {
51 const char *name; /* postfix of file */
52 size_t namelen; /* length of postfix */
53 const char *type; /* matching content-type */
54 const char *encoding; /* matching content-encoding */
55 const char *encoding11; /* matching content-encoding (HTTP/1.1) */
56 const char *cgihandler; /* optional CGI handler */
57 } bozo_content_map_t;
58
59 /* this struct holds the bozo constants */
60 typedef struct bozo_consts_t {
61 const char *http_09; /* "HTTP/0.9" */
62 const char *http_10; /* "HTTP/1.0" */
63 const char *http_11; /* "HTTP/1.1" */
64 const char *text_plain; /* "text/plain" */
65 } bozo_consts_t;
66
67 /* this structure encapsulates all the bozo flags and control vars */
68 typedef struct bozohttpd_t {
69 char *rootdir; /* root directory */
70 char *username; /* username to switch to */
71 int numeric; /* avoid gethostby*() */
72 char *virtbase; /* virtual directory base */
73 int unknown_slash; /* unknown vhosts go to normal slashdir */
74 int untrustedref; /* make sure referrer = me unless url = / */
75 int logstderr; /* log to stderr (even if not tty) */
76 int background; /* drop into daemon mode */
77 int foreground; /* keep daemon mode in foreground */
78 char *pidfile; /* path to the pid file, if any */
79 size_t page_size; /* page size */
80 char *slashdir; /* www slash directory */
81 char *bindport; /* bind port; default "http" */
82 char *bindaddress; /* address for binding - INADDR_ANY */
83 int debug; /* debugging level */
84 char *virthostname; /* my name */
85 const char *server_software;/* our brand :-) */
86 const char *index_html; /* our home page */
87 const char *public_html; /* ~user/public_html page */
88 int enable_users; /* enable public_html */
89 int *sock; /* bound sockets */
90 int nsock; /* number of above */
91 struct pollfd *fds; /* current poll fd set */
92 int request_times; /* # times a request was processed */
93 int dir_indexing; /* handle directories */
94 int hide_dots; /* hide .* */
95 int process_cgi; /* use the cgi handler */
96 char *cgibin; /* cgi-bin directory */
97 void *sslinfo; /* pointer to ssl struct */
98 int dynamic_content_map_size;/* size of dyn cont map */
99 bozo_content_map_t *dynamic_content_map;/* dynamic content map */
100 size_t mmapsz; /* size of region to mmap */
101 char *getln_buffer; /* space for getln buffer */
102 ssize_t getln_buflen; /* length of allocated space */
103 char *errorbuf; /* no dynamic allocation allowed */
104 bozo_consts_t consts; /* various constants */
105 } bozohttpd_t;
106
107 /* bozo_httpreq_t */
108 typedef struct bozo_httpreq_t {
109 bozohttpd_t *hr_httpd;
110 int hr_method;
111 #define HTTP_GET 0x01
112 #define HTTP_POST 0x02
113 #define HTTP_HEAD 0x03
114 #define HTTP_OPTIONS 0x04 /* not supported */
115 #define HTTP_PUT 0x05 /* not supported */
116 #define HTTP_DELETE 0x06 /* not supported */
117 #define HTTP_TRACE 0x07 /* not supported */
118 #define HTTP_CONNECT 0x08 /* not supported */
119 const char *hr_methodstr;
120 char *hr_file;
121 char *hr_oldfile; /* if we added an index_html */
122 char *hr_query;
123 const char *hr_proto;
124 const char *hr_content_type;
125 const char *hr_content_length;
126 const char *hr_allow;
127 const char *hr_host; /* HTTP/1.1 Host: */
128 const char *hr_referrer;
129 const char *hr_range;
130 const char *hr_if_modified_since;
131 const char *hr_accept_encoding;
132 int hr_have_range;
133 off_t hr_first_byte_pos;
134 off_t hr_last_byte_pos;
135 /*const*/ char *hr_remotehost;
136 /*const*/ char *hr_remoteaddr;
137 /*const*/ char *hr_serverport;
138 #ifdef DO_HTPASSWD
139 /*const*/ char *hr_authrealm;
140 /*const*/ char *hr_authuser;
141 /*const*/ char *hr_authpass;
142 #endif
143 SIMPLEQ_HEAD(, bozoheaders) hr_headers;
144 int hr_nheaders;
145 } bozo_httpreq_t;
146
147 /* structure to hold string based (name, value) pairs with preferences */
148 typedef struct bozoprefs_t {
149 unsigned size; /* size of the two arrays */
150 unsigned c; /* # of entries in arrays */
151 char **name; /* names of each entry */
152 char **value; /* values for the name entries */
153 } bozoprefs_t;
154
155 /* write in upto 64KiB chunks, and mmap in upto 64MiB chunks */
156 #define BOZO_WRSZ (64 * 1024)
157 #define BOZO_MMAPSZ (BOZO_WRSZ * 1024)
158
159 /* debug flags */
160 #define DEBUG_NORMAL 1
161 #define DEBUG_FAT 2
162 #define DEBUG_OBESE 3
163 #define DEBUG_EXPLODING 4
164
165 #define strornull(x) ((x) ? (x) : "<null>")
166
167 #if defined(__GNUC__) && __GNUC__ >= 3
168 #define BOZO_PRINTFLIKE(x,y) __attribute__((__format__(__printf__, x,y)))
169 #define BOZO_DEAD __attribute__((__noreturn__))
170 #endif
171
172 #ifndef NO_DEBUG
173 void debug__(bozohttpd_t *, int, const char *, ...) BOZO_PRINTFLIKE(3, 4);
174 #define debug(x) debug__ x
175 #else
176 #define debug(x)
177 #endif /* NO_DEBUG */
178
179 void bozo_warn(bozohttpd_t *, const char *, ...)
180 BOZO_PRINTFLIKE(2, 3);
181 void bozo_err(bozohttpd_t *, int, const char *, ...)
182 BOZO_PRINTFLIKE(3, 4)
183 BOZO_DEAD;
184 int bozo_http_error(bozohttpd_t *, int, bozo_httpreq_t *, const char *);
185
186 int bozo_check_special_files(bozo_httpreq_t *, const char *);
187 char *bozo_http_date(char *, size_t);
188 void bozo_print_header(bozo_httpreq_t *, struct stat *, const char *, const char *);
189
190 char *bozodgetln(bozohttpd_t *, int, ssize_t *, ssize_t (*)(bozohttpd_t *, int, void *, size_t));
191 char *bozostrnsep(char **, const char *, ssize_t *);
192
193 void *bozomalloc(bozohttpd_t *, size_t);
194 void *bozorealloc(bozohttpd_t *, void *, size_t);
195 char *bozostrdup(bozohttpd_t *, const char *);
196
197 /* ssl-bozo.c */
198 #ifdef NO_SSL_SUPPORT
199 #define bozo_ssl_set_opts(w, x, y) do { /* nothing */ } while (0)
200 #define bozo_ssl_init(x) do { /* nothing */ } while (0)
201 #define bozo_ssl_accept(x) do { /* nothing */ } while (0)
202 #define bozo_ssl_destroy(x) do { /* nothing */ } while (0)
203 #else
204 void bozo_ssl_set_opts(bozohttpd_t *, const char *, const char *);
205 void bozo_ssl_init(bozohttpd_t *);
206 void bozo_ssl_accept(bozohttpd_t *);
207 void bozo_ssl_destroy(bozohttpd_t *);
208 #endif
209
210
211 /* auth-bozo.c */
212 #ifdef DO_HTPASSWD
213 int bozo_auth_check(bozo_httpreq_t *, const char *);
214 void bozo_auth_cleanup(bozo_httpreq_t *);
215 int bozo_auth_check_headers(bozo_httpreq_t *, char *, char *, ssize_t);
216 int bozo_auth_check_special_files(bozo_httpreq_t *, const char *);
217 void bozo_auth_check_401(bozo_httpreq_t *, int);
218 void bozo_auth_cgi_setenv(bozo_httpreq_t *, char ***);
219 int bozo_auth_cgi_count(bozo_httpreq_t *);
220 #else
221 #define bozo_auth_check(x, y) 0
222 #define bozo_auth_cleanup(x) do { /* nothing */ } while (0)
223 #define bozo_auth_check_headers(y, z, a, b) 0
224 #define bozo_auth_check_special_files(x, y) 0
225 #define bozo_auth_check_401(x, y) do { /* nothing */ } while (0)
226 #define bozo_auth_cgi_setenv(x, y) do { /* nothing */ } while (0)
227 #define bozo_auth_cgi_count(x) 0
228 #endif /* DO_HTPASSWD */
229
230
231 /* cgi-bozo.c */
232 #ifdef NO_CGIBIN_SUPPORT
233 #define bozo_process_cgi(h) 0
234 #else
235 void bozo_cgi_setbin(bozohttpd_t *, const char *);
236 void bozo_setenv(bozohttpd_t *, const char *, const char *, char **);
237 int bozo_process_cgi(bozo_httpreq_t *);
238 void bozo_add_content_map_cgi(bozohttpd_t *, const char *, const char *);
239 #endif /* NO_CGIBIN_SUPPORT */
240
241
242 /* daemon-bozo.c */
243 #ifdef NO_DAEMON_MODE
244 #define bozo_daemon_init(x) do { /* nothing */ } while (0)
245 #define bozo_daemon_fork(x) 0
246 #define bozo_daemon_closefds(x) do { /* nothing */ } while (0)
247 #else
248 void bozo_daemon_init(bozohttpd_t *);
249 int bozo_daemon_fork(bozohttpd_t *);
250 void bozo_daemon_closefds(bozohttpd_t *);
251 #endif /* NO_DAEMON_MODE */
252
253
254 /* tilde-luzah-bozo.c */
255 #ifdef NO_USER_SUPPORT
256 #define bozo_user_transform(a, c) 0
257 #else
258 int bozo_user_transform(bozo_httpreq_t *, int *);
259 #endif /* NO_USER_SUPPORT */
260
261
262 /* dir-index-bozo.c */
263 #ifdef NO_DIRINDEX_SUPPORT
264 #define bozo_dir_index(a, b, c) 0
265 #else
266 int bozo_dir_index(bozo_httpreq_t *, const char *, int);
267 #endif /* NO_DIRINDEX_SUPPORT */
268
269
270 /* content-bozo.c */
271 const char *bozo_content_type(bozo_httpreq_t *, const char *);
272 const char *bozo_content_encoding(bozo_httpreq_t *, const char *);
273 bozo_content_map_t *bozo_match_content_map(bozohttpd_t *, const char *, int);
274 bozo_content_map_t *bozo_get_content_map(bozohttpd_t *, const char *);
275 #ifndef NO_DYNAMIC_CONTENT
276 void bozo_add_content_map_mime(bozohttpd_t *, const char *, const char *, const char *, const char *);
277 #endif
278
279 /* I/O */
280 int bozo_printf(bozohttpd_t *, const char *, ...) BOZO_PRINTFLIKE(2, 3);;
281 ssize_t bozo_read(bozohttpd_t *, int, void *, size_t);
282 ssize_t bozo_write(bozohttpd_t *, int, const void *, size_t);
283 int bozo_flush(bozohttpd_t *, FILE *);
284
285 /* misc */
286 int bozo_init_httpd(bozohttpd_t *);
287 int bozo_init_prefs(bozoprefs_t *);
288 int bozo_set_defaults(bozohttpd_t *, bozoprefs_t *);
289 int bozo_setup(bozohttpd_t *, bozoprefs_t *, const char *, const char *);
290 bozo_httpreq_t *bozo_read_request(bozohttpd_t *);
291 void bozo_process_request(bozo_httpreq_t *);
292 void bozo_clean_request(bozo_httpreq_t *);
293
294 /* variables */
295 int bozo_set_pref(bozoprefs_t *, const char *, const char *);
296 char *bozo_get_pref(bozoprefs_t *, const char *);
297
298 #endif /* BOZOHTTOPD_H_ */
299