1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
About
=====
libmicrohttpd is a GNU library (part of the GNU project) written in C
that provides a compact API and implementation of an HTTP 1.1 web
server (HTTP 1.0 is also supported). libmicrohttpd only implements
the HTTP 1.1 protocol. The main application must still provide the
content.
Installation
============
If you are using Subversion, run "autoreconf -fi" to create configure.
In order to run the testcases, you need a recent version of libcurl.
libcurl is not required if you just want to install the library.
Configure options
=================
Especially for development, use "--enable-messages" to enable error
reporting (and use MHD_USE_DEBUG). Error reporting is not enabled by
default to reduce the size of the library (error messages take
space!). If you are concerned about space, you should set "CFLAGS" to
"-Os -fomit-frame-pointer" to have gcc generate tight code. The
resulting binary should be about 30k (without SSL support) depending
on the platform.
Portability
===========
The latest version of libmicrohttpd will try to avoid SIGPIPE on its
sockets. This should work on OS X, Linux and recent BSD systems (at
least). On other systems that may trigger a SIGPIPE on send/recv, the
main application should install a signal handler to handle SIGPIPE.
libmicrohttpd should work well on GNU/Linux, BSD, OS X, W32 and z/OS.
Note that HTTPS is not supported on z/OS (yet). We also have reports
of users using it on vxWorks and Symbian. Note that on platforms
where the compiler does not support the "constructor" attribute, you
must call "MHD_init" before using any MHD functions and "MHD_fini"
after you are done using MHD.
Notes on compiling on z/OS:
---------------------------
After extracting the archive, run
iconv -f UTF-8 -t IBM-1047 contrib/ascebc > /tmp/ascebc.sh
chmod +x /tmp/ascebc.sh
for n in `find * -type f`
do
/tmp/ascebc.sh $n
done
to convert all source files to EBCDIC. Note that you must run
"configure" from the directory where the configure script is
located. Otherwise, configure will fail to find the
"contrib/xcc" script (which is a wrapper around the z/OS c89
compiler).
Development Status
==================
This is a beta release. Below we list things that should be
implemented (in order of importance) before we can claim to be
reasonably complete.
Missing features:
=================
- MHD_get_daemon_info options for SSL are not implemented (always return NULL)
- SSL support does not work with SELECT-based threading modes
(issue is that the gnutls state machine does not like EAGAIN/EINTR
return values from send/recv, despite having tons of
branches on those values).
- SSL code is still too large:
* libgcrypt is used, and is also bloated
=> integrate required portions of libgcrypt into our tree
instead of linking against it
* still some bloat in the SSL code;
consider removing "client" functionality
* most likely some headers declare functions, constants
and types that are no longer present or used
* possibly other dead code
- Make sure SSL works on non-GNU/Linux platforms
Untested features:
==================
- add testcases for http/1.1 pipelining (need
to figure out how to ensure curl pipelines
-- and it seems libcurl has issues with pipelining,
see http://curl.haxx.se/mail/lib-2007-12/0248.html)
- add testcases for resource limit enforcement
- add testcases for client queuing early response,
suppressing 100 CONTINUE
- extend testcase for chunked encoding to validate
handling of footers
- more testing for SSL support
Functions not covered by "make check":
======================================
- MHD_get_connection_values
- MHD_set_connection_value
- parse_cookie_header
- parse_arguments
- MHD_del_response_header
- MHD_get_response_headers
- MHD_tls_connection_close
Missing documentation:
======================
- manual:
* document configuration options
* document SSL/TLS support
* document details on porting MHD (plibc, z/OS)
- tutorial:
* clean up English
* make sure everything is accurate
|
