| 1 |
About |
| 2 |
===== |
| 3 |
|
| 4 |
GNU libmicrohttpd is a GNU package offering a C library that provides |
| 5 |
a compact API and implementation of an HTTP 1.1 web server (HTTP 1.0 |
| 6 |
is also supported). GNU libmicrohttpd only implements the HTTP 1.1 |
| 7 |
protocol. The main application must still provide the application |
| 8 |
logic to generate the content. |
| 9 |
|
| 10 |
GNU libmicrohttpd is dual-licensed under the GNU Lesser General Public |
| 11 |
License (LGPLv2.1+) and the eCos License. See COPYING for details. |
| 12 |
|
| 13 |
|
| 14 |
Joining GNU |
| 15 |
=========== |
| 16 |
|
| 17 |
This is a GNU program, developed by the GNU Project and part of the |
| 18 |
GNU Operating System. If you are the author of an awesome program and |
| 19 |
want to join us in writing Free Software, please consider making it an |
| 20 |
official GNU program and become a GNU maintainer. You can find |
| 21 |
instructions on how to do so at http://www.gnu.org/help/evaluation. |
| 22 |
We are looking forward to hacking with you! |
| 23 |
|
| 24 |
|
| 25 |
Installation |
| 26 |
============ |
| 27 |
|
| 28 |
See INSTALL for generic installation instructions. |
| 29 |
|
| 30 |
If you are using Git, run "./bootstrap" to create configure. |
| 31 |
|
| 32 |
In order to run the testcases, you need a recent version of libcurl. |
| 33 |
libcurl is not required if you just want to install the library. |
| 34 |
|
| 35 |
Especially for development, do use the MHD_USE_ERROR_LOG option to get |
| 36 |
error messages. |
| 37 |
|
| 38 |
|
| 39 |
Configure options |
| 40 |
================= |
| 41 |
|
| 42 |
|
| 43 |
If you are concerned about space, you should set "CFLAGS" to "-Os |
| 44 |
-fomit-frame-pointer" to have gcc generate tight code. |
| 45 |
|
| 46 |
You can use the following options to disable certain MHD features: |
| 47 |
|
| 48 |
--disable-https: no HTTPS / TLS / SSL support (significant reduction) |
| 49 |
--disable-messages: no error messages (they take space!) |
| 50 |
--disable-postprocessor: no MHD_PostProcessor API |
| 51 |
--disable-dauth: no digest authentication API |
| 52 |
--disable-epoll: no support for epoll, even on Linux |
| 53 |
|
| 54 |
The resulting binary should be about 30-40k depending on the platform. |
| 55 |
|
| 56 |
|
| 57 |
Portability |
| 58 |
=========== |
| 59 |
|
| 60 |
The latest version of libmicrohttpd will try to avoid SIGPIPE on its |
| 61 |
sockets. This should work on OS X, Linux and recent BSD systems (at |
| 62 |
least). On other systems that may trigger a SIGPIPE on send/recv, the |
| 63 |
main application should install a signal handler to handle SIGPIPE. |
| 64 |
|
| 65 |
libmicrohttpd should work well on GNU/Linux, W32, FreeBSD, Darwin, |
| 66 |
NetBSD, OpenBSD, Solaris/OpenIndiana, and z/OS. |
| 67 |
Note that HTTPS is not supported on z/OS (yet). We also have reports |
| 68 |
of users using it on vxWorks. |
| 69 |
|
| 70 |
|
| 71 |
Development Status |
| 72 |
================== |
| 73 |
|
| 74 |
This is a stable release for libmicrohttpd. |