bozohttpd.h revision 1.70 1 /* $NetBSD: bozohttpd.h,v 1.70 2021/08/24 09:47:36 mrg Exp $ */
2
3 /* $eterna: bozohttpd.h,v 1.39 2011/11/18 09:21:15 mrg Exp $ */
4
5 /*
6 * Copyright (c) 1997-2021 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 BOZOHTTPD_H_
33 #define BOZOHTTPD_H_ 1
34
35 #include "netbsd_queue.h"
36
37 #include <stdbool.h>
38 #include <stdio.h>
39 #include <signal.h>
40
41 #include <sys/stat.h>
42
43 #ifndef NO_LUA_SUPPORT
44 #include <lua.h>
45 #endif
46
47 #ifndef NO_BLOCKLIST_SUPPORT
48 #include <blocklist.h>
49 void pfilter_notify(const int, const int);
50 #endif
51
52 /* QNX provides a lot of NetBSD things in nbutil.h */
53 #ifdef HAVE_NBUTIL_H
54 #include <nbutil.h>
55 #endif
56
57 /* lots of "const" but gets free()'ed etc at times, sigh */
58
59 /* headers */
60 typedef struct bozoheaders {
61 /*const*/ char *h_header;
62 /*const*/ char *h_value; /* this gets free()'ed etc at times */
63 SIMPLEQ_ENTRY(bozoheaders) h_next;
64 } bozoheaders_t;
65 SIMPLEQ_HEAD(qheaders, bozoheaders);
66
67 #ifndef NO_LUA_SUPPORT
68 typedef struct lua_handler {
69 const char *name;
70 int ref;
71 SIMPLEQ_ENTRY(lua_handler) h_next;
72 } lua_handler_t;
73
74 typedef struct lua_state_map {
75 const char *script;
76 const char *prefix;
77 lua_State *L;
78 SIMPLEQ_HEAD(, lua_handler) handlers;
79 SIMPLEQ_ENTRY(lua_state_map) s_next;
80 } lua_state_map_t;
81 #endif
82
83 typedef struct bozo_content_map_t {
84 const char *name; /* postfix of file */
85 const char *type; /* matching content-type */
86 const char *encoding; /* matching content-encoding */
87 const char *encoding11; /* matching content-encoding (HTTP/1.1) */
88 const char *cgihandler; /* optional CGI handler */
89 } bozo_content_map_t;
90
91 /* this struct holds the bozo constants */
92 typedef struct bozo_consts_t {
93 const char *http_09; /* "HTTP/0.9" */
94 const char *http_10; /* "HTTP/1.0" */
95 const char *http_11; /* "HTTP/1.1" */
96 const char *text_plain; /* "text/plain" */
97 } bozo_consts_t;
98
99 /* this structure encapsulates all the bozo flags and control vars */
100 typedef struct bozohttpd_t {
101 char *rootdir; /* root directory */
102 int numeric; /* avoid gethostby*() */
103 char *virtbase; /* virtual directory base */
104 int unknown_slash; /* unknown vhosts go to normal slashdir */
105 int logstderr; /* log to stderr (even if not tty) */
106 int background; /* drop into daemon mode */
107 int foreground; /* keep daemon mode in foreground */
108 char *pidfile; /* path to the pid file, if any */
109 size_t page_size; /* page size */
110 char *slashdir; /* www slash directory */
111 char *bindport; /* bind port; default "http" */
112 char *bindaddress; /* address for binding - INADDR_ANY */
113 int debug; /* debugging level */
114 char *virthostname; /* my name */
115 const char *server_software;/* our brand :-) */
116 const char *index_html; /* our home page */
117 const char *public_html; /* ~user/public_html page */
118 int enable_users; /* enable public_html */
119 int enable_cgi_users; /* use the cgi handler */
120 int *sock; /* bound sockets */
121 int nsock; /* number of above */
122 struct pollfd *fds; /* current poll fd set */
123 int request_times; /* # times a request was processed */
124 int dir_indexing; /* handle directories */
125 const char *dir_readme; /* include README footer in indexes */
126 int hide_dots; /* hide .* */
127 int process_cgi; /* use the cgi handler */
128 char *cgibin; /* cgi-bin directory */
129 unsigned ssl_timeout; /* ssl timeout */
130 unsigned initial_timeout;/* first line timeout */
131 unsigned header_timeout; /* header lines timeout */
132 unsigned request_timeout;/* total session timeout */
133 char *ssl_min_proto; /* minimum ssl protocol level */
134 #ifndef NO_LUA_SUPPORT
135 int process_lua; /* use the Lua handler */
136 SIMPLEQ_HEAD(, lua_state_map) lua_states;
137 #endif
138 void *sslinfo; /* pointer to ssl struct */
139 int dynamic_content_map_size;/* size of dyn cont map */
140 bozo_content_map_t *dynamic_content_map;/* dynamic content map */
141 size_t mmapsz; /* size of region to mmap */
142 char *getln_buffer; /* space for getln buffer */
143 ssize_t getln_buflen; /* length of allocated space */
144 char *errorbuf; /* no dynamic allocation allowed */
145 bozo_consts_t consts; /* various constants */
146 } bozohttpd_t;
147
148 /* bozo_httpreq_t */
149 typedef struct bozo_httpreq_t {
150 bozohttpd_t *hr_httpd;
151 int hr_method;
152 #define HTTP_GET 0x01
153 #define HTTP_POST 0x02
154 #define HTTP_HEAD 0x03
155 #define HTTP_OPTIONS 0x04 /* not supported */
156 #define HTTP_PUT 0x05 /* not supported */
157 #define HTTP_DELETE 0x06 /* not supported */
158 #define HTTP_TRACE 0x07 /* not supported */
159 #define HTTP_CONNECT 0x08 /* not supported */
160 const char *hr_methodstr;
161 char *hr_virthostname; /* server name (if not identical
162 to hr_httpd->virthostname) */
163 char *hr_file_free; /* pointer to file buffer to free() */
164 char *hr_file; /* pointer into file buffer */
165 char *hr_oldfile; /* if we added an index_html */
166 char *hr_query;
167 char *hr_host; /* HTTP/1.1 Host: or virtual hostname,
168 possibly including a port number */
169 #ifndef NO_USER_SUPPORT
170 char *hr_user; /* username if we hit userdir request */
171 #endif /* !NO_USER_SUPPORT */
172 const char *hr_proto;
173 const char *hr_content_type;
174 const char *hr_content_length;
175 const char *hr_allow;
176 const char *hr_referrer;
177 const char *hr_range;
178 const char *hr_if_modified_since;
179 const char *hr_accept_encoding;
180 int hr_have_range;
181 off_t hr_first_byte_pos;
182 off_t hr_last_byte_pos;
183 /*const*/ char *hr_remotehost;
184 /*const*/ char *hr_remoteaddr;
185 /*const*/ char *hr_serverport;
186 #ifdef DO_HTPASSWD
187 /*const*/ char *hr_authrealm;
188 /*const*/ char *hr_authuser;
189 /*const*/ char *hr_authpass;
190 #endif
191 struct qheaders hr_headers;
192 struct qheaders hr_replheaders;
193 unsigned hr_nheaders;
194 size_t hr_header_bytes;
195 } bozo_httpreq_t;
196
197 /* helper to access the "active" host name from a httpd/request pair */
198 #define BOZOHOST(HTTPD,REQUEST) ((REQUEST)->hr_virthostname ? \
199 (REQUEST)->hr_virthostname : \
200 (HTTPD)->virthostname)
201
202 /* structure to hold string based (name, value) pairs with preferences */
203 typedef struct bozoprefs_t {
204 size_t size; /* size of the two arrays */
205 size_t count; /* # of entries in arrays */
206 char **name; /* names of each entry */
207 char **value; /* values for the name entries */
208 } bozoprefs_t;
209
210 /* sun2 has a tiny VA range */
211 #ifdef __mc68010__
212 #ifndef BOZO_WRSZ
213 #define BOZO_WRSZ (16 * 1024)
214 #endif
215 #ifndef BOZO_MMAPSZ
216 #define BOZO_MMAPSZ (BOZO_WRSZ * 4)
217 #endif
218 #endif
219
220 /* by default write in upto 64KiB chunks, and mmap in upto 64MiB chunks */
221 #ifndef BOZO_WRSZ
222 #define BOZO_WRSZ (64 * 1024)
223 #endif
224 #ifndef BOZO_MMAPSZ
225 #define BOZO_MMAPSZ (BOZO_WRSZ * 1024)
226 #endif
227
228 /* only allow this many total headers bytes */
229 #define BOZO_HEADERS_MAX_SIZE (16 * 1024)
230
231 #define BOZO_MINBUFSIZE (4 * 1024)
232
233 /* debug flags */
234 #define DEBUG_NORMAL 1
235 #define DEBUG_FAT 2
236 #define DEBUG_OBESE 3
237 #define DEBUG_EXPLODING 4
238
239 #define strornull(x) ((x) ? (x) : "<null>")
240
241 #if (defined(__GNUC__) && __GNUC__ >= 3) || defined(__lint__)
242 #define BOZO_PRINTFLIKE(x,y) __attribute__((__format__(__printf__, x,y)))
243 #define BOZO_DEAD __attribute__((__noreturn__))
244 #define BOZO_CHECKRET __attribute__((__warn_unused_result__))
245 #else
246 #define BOZO_PRINTFLIKE(x,y)
247 #define BOZO_DEAD
248 #define BOZO_CHECKRET
249 #endif
250
251 #ifdef NO_DEBUG
252 #define debug(x)
253 #define have_debug (0)
254 #else
255 void debug__(bozohttpd_t *, int, const char *, ...) BOZO_PRINTFLIKE(3, 4);
256 #define debug(x) debug__ x
257 #define have_debug (1)
258 #endif /* NO_DEBUG */
259
260 #define BOZO_HTTP_PORT "80"
261 #define BOZO_HTTPS_PORT "443"
262
263 /*
264 * bozohttpd special files. avoid serving these out.
265 *
266 * When you add some .bz* file, make sure to also check it in
267 * bozo_check_special_files()
268 */
269
270 #ifndef DIRECT_ACCESS_FILE
271 #define DIRECT_ACCESS_FILE ".bzdirect"
272 #endif
273 #ifndef REDIRECT_FILE
274 #define REDIRECT_FILE ".bzredirect"
275 #endif
276 #ifndef ABSREDIRECT_FILE
277 #define ABSREDIRECT_FILE ".bzabsredirect"
278 #endif
279 #ifndef REMAP_FILE
280 #define REMAP_FILE ".bzremap"
281 #endif
282 #ifndef AUTH_FILE
283 #define AUTH_FILE ".htpasswd"
284 #endif
285
286 /* be sure to always return this error up */
287 int bozo_http_error(bozohttpd_t *, int, bozo_httpreq_t *, const char *);
288
289 int bozo_check_special_files(bozo_httpreq_t *, const char *, bool) BOZO_CHECKRET;
290 char *bozo_http_date(char *, size_t);
291 void bozo_print_header(bozo_httpreq_t *, struct stat *, const char *,
292 const char *);
293 char *bozo_escape_rfc3986(bozohttpd_t *httpd, const char *url, int absolute);
294 char *bozo_escape_html(bozohttpd_t *httpd, const char *url);
295 int bozo_decode_url_percent(bozo_httpreq_t *, char *);
296
297 /* these are similar to libc functions, no underscore here */
298 void bozowarn(bozohttpd_t *, const char *, ...)
299 BOZO_PRINTFLIKE(2, 3);
300 void bozoerr(bozohttpd_t *, int, const char *, ...)
301 BOZO_PRINTFLIKE(3, 4)
302 BOZO_DEAD;
303 void bozoasprintf(bozohttpd_t *, char **, const char *, ...)
304 BOZO_PRINTFLIKE(3, 4);
305 char *bozodgetln(bozohttpd_t *, int, ssize_t *, ssize_t (*)(bozohttpd_t *,
306 int, void *, size_t));
307 char *bozostrnsep(char **, const char *, ssize_t *);
308 void *bozomalloc(bozohttpd_t *, size_t);
309 void *bozorealloc(bozohttpd_t *, void *, size_t);
310 char *bozostrdup(bozohttpd_t *, bozo_httpreq_t *, const char *);
311
312 #define bozo_noop do { /* nothing */ } while (/*CONSTCOND*/0)
313
314 #define have_core (1)
315
316 /* ssl-bozo.c */
317 #ifdef NO_SSL_SUPPORT
318 #define bozo_ssl_set_opts(w, x, y) bozo_noop
319 #define bozo_ssl_set_ciphers(w, x) bozo_noop
320 #define bozo_ssl_init(x) bozo_noop
321 #define bozo_ssl_accept(x) (0)
322 #define bozo_ssl_shutdown(x) bozo_noop
323 #define bozo_ssl_destroy(x) bozo_noop
324 #define have_ssl (0)
325 #else
326 void bozo_ssl_set_opts(bozohttpd_t *, const char *, const char *);
327 void bozo_ssl_set_ciphers(bozohttpd_t *, const char *);
328 void bozo_ssl_init(bozohttpd_t *);
329 int bozo_ssl_accept(bozohttpd_t *);
330 void bozo_ssl_shutdown(bozohttpd_t *);
331 void bozo_ssl_destroy(bozohttpd_t *);
332 #define have_ssl (1)
333 #endif
334
335
336 /* auth-bozo.c */
337 #ifdef DO_HTPASSWD
338 void bozo_auth_init(bozo_httpreq_t *);
339 int bozo_auth_check(bozo_httpreq_t *, const char *);
340 void bozo_auth_cleanup(bozo_httpreq_t *);
341 int bozo_auth_check_headers(bozo_httpreq_t *, char *, char *, ssize_t);
342 void bozo_auth_check_401(bozo_httpreq_t *, int);
343 void bozo_auth_cgi_setenv(bozo_httpreq_t *, char ***);
344 int bozo_auth_cgi_count(bozo_httpreq_t *);
345 #else
346 #define bozo_auth_init(x) bozo_noop
347 #define bozo_auth_check(x, y) (0)
348 #define bozo_auth_cleanup(x) bozo_noop
349 #define bozo_auth_check_headers(y, z, a, b) (0)
350 #define bozo_auth_check_401(x, y) bozo_noop
351 #define bozo_auth_cgi_setenv(x, y) bozo_noop
352 #define bozo_auth_cgi_count(x) (0)
353 #endif /* DO_HTPASSWD */
354
355
356 /* cgi-bozo.c */
357 #ifdef NO_CGIBIN_SUPPORT
358 #define bozo_cgi_setbin(h,s) bozo_noop
359 #define bozo_process_cgi(h) (0)
360 #define have_cgibin (0)
361 #else
362 void bozo_cgi_setbin(bozohttpd_t *, const char *);
363 void bozo_setenv(bozohttpd_t *, const char *, const char *, char **);
364 int bozo_process_cgi(bozo_httpreq_t *);
365 #define have_cgibin (1)
366 #endif /* NO_CGIBIN_SUPPORT */
367
368
369 /* lua-bozo.c */
370 #ifdef NO_LUA_SUPPORT
371 #define bozo_process_lua(h) (0)
372 #define bozo_add_lua_map(h,s,t) bozo_noop
373 #define have_lua (0)
374 #else
375 void bozo_add_lua_map(bozohttpd_t *, const char *, const char *);
376 int bozo_process_lua(bozo_httpreq_t *);
377 #define have_lua (1)
378 #endif /* NO_LUA_SUPPORT */
379
380
381 /* daemon-bozo.c */
382 #ifdef NO_DAEMON_MODE
383 #define bozo_daemon_init(x) bozo_noop
384 #define bozo_daemon_fork(x) (0)
385 #define bozo_daemon_closefds(x) bozo_noop
386 #define have_daemon_mode (0)
387 #else
388 void bozo_daemon_init(bozohttpd_t *);
389 int bozo_daemon_fork(bozohttpd_t *);
390 void bozo_daemon_closefds(bozohttpd_t *);
391 #define have_daemon_mode (1)
392 #endif /* NO_DAEMON_MODE */
393
394
395 /* tilde-luzah-bozo.c */
396 #ifdef NO_USER_SUPPORT
397 #define bozo_user_transform(x) (0)
398 #define bozo_user_free(x) /* nothing */
399 #define have_user (0)
400 #else
401 int bozo_user_transform(bozo_httpreq_t *);
402 #define bozo_user_free(x) free(x)
403 #define have_user (1)
404 #endif /* NO_USER_SUPPORT */
405
406
407 /* dir-index-bozo.c */
408 #ifdef NO_DIRINDEX_SUPPORT
409 #define bozo_dir_index(a, b, c) (0)
410 #define have_dirindex (0)
411 #else
412 int bozo_dir_index(bozo_httpreq_t *, const char *, int);
413 #define have_dirindex (1)
414 #endif /* NO_DIRINDEX_SUPPORT */
415
416
417 /* content-bozo.c */
418 const char *bozo_content_type(bozo_httpreq_t *, const char *);
419 const char *bozo_content_encoding(bozo_httpreq_t *, const char *);
420 bozo_content_map_t *bozo_match_content_map(bozohttpd_t *, const char *, int);
421 bozo_content_map_t *bozo_get_content_map(bozohttpd_t *, const char *);
422 #ifdef NO_DYNAMIC_CONTENT
423 #define bozo_add_content_map_mime(h,s,t,u,v) bozo_noop
424 #define have_dynamic_content (0)
425 #else
426 void bozo_add_content_map_mime(bozohttpd_t *, const char *, const char *,
427 const char *, const char *);
428 #define have_dynamic_content (1)
429 #endif
430
431 /* additional cgi-bozo.c */
432 #if have_cgibin && have_dynamic_content
433 void bozo_add_content_map_cgi(bozohttpd_t *, const char *, const char *);
434 #else
435 #define bozo_add_content_map_cgi(h,s,t)
436 #endif
437
438 /* I/O */
439 int bozo_printf(bozohttpd_t *, const char *, ...) BOZO_PRINTFLIKE(2, 3);
440 ssize_t bozo_read(bozohttpd_t *, int, void *, size_t);
441 ssize_t bozo_write(bozohttpd_t *, int, const void *, size_t);
442 int bozo_flush(bozohttpd_t *, FILE *);
443
444 /* misc */
445 int bozo_init_httpd(bozohttpd_t *);
446 int bozo_init_prefs(bozohttpd_t *, bozoprefs_t *);
447 int bozo_set_defaults(bozohttpd_t *, bozoprefs_t *);
448 int bozo_setup(bozohttpd_t *, bozoprefs_t *, const char *, const char *);
449 void bozo_cleanup(bozohttpd_t *, bozoprefs_t *);
450 bozo_httpreq_t *bozo_read_request(bozohttpd_t *);
451 void bozo_process_request(bozo_httpreq_t *);
452 void bozo_clean_request(bozo_httpreq_t *);
453 int bozo_set_timeout(bozohttpd_t *, bozoprefs_t *, const char *, const char *);
454 bozoheaders_t *addmerge_reqheader(bozo_httpreq_t *, const char *,
455 const char *, ssize_t);
456 bozoheaders_t *addmerge_replheader(bozo_httpreq_t *, const char *,
457 const char *, ssize_t);
458
459 /* variables */
460 int bozo_set_pref(bozohttpd_t *, bozoprefs_t *, const char *, const char *);
461 char *bozo_get_pref(bozoprefs_t *, const char *);
462
463 int bozo_get_version(char */*buf*/, size_t /*size*/);
464
465 extern volatile sig_atomic_t bozo_timeout_hit;
466
467 #endif /* BOZOHTTPD_H_ */
468