Unofficial mirror of GNU libmicrohttpd repository https://gnu.org/s/libmicrohttpd

ng0 e82de7505f Revert "connection.c: remove dead code." 5 tahun lalu
contrib e5f188a4cb contrib: implemented script for importing HTTP status codes 5 tahun lalu
doc 0359c0bbdd Document MHD_UPGRADE_ACTION_CORK_ON and HD_UPGRADE_ACTION_CORK_OFF. 5 tahun lalu
m4 2c93aa35f7 Added .gitattributes, fixed line endings in ac_define_dir.m4, 5 tahun lalu
po 91826f5001 releasing v0.9.66 5 tahun lalu
src e82de7505f Revert "connection.c: remove dead code." 5 tahun lalu
w32 436bf9cdf9 MSVC projects: Explicitly specified target machines 5 tahun lalu
.dir-locals.el 8c44c704b9 .dir-locals.el: fixed language for dictionary 5 tahun lalu
.gitattributes 63fdb091c8 Updated .gitattributes, normalized line ending in source file 5 tahun lalu
.gitignore f17794b5f5 gitignore build-aux. 5 tahun lalu
.gitlab-ci.yml e1cdae6b96 CI: fixed double checking 5 tahun lalu
ABOUT-NLS acd39ed23d releasing libmicrohttpd 0.9.60 6 tahun lalu
AUTHORS 58552e93ac applying patch from Tim 5 tahun lalu
COPYING d0e81c8e0f Updated README and COPYING 5 tahun lalu
ChangeLog 86832243cf Merge remote-tracking branch 'origin/master' into dev/ng0/gsoc2019 5 tahun lalu
Makefile.am d7ad8607e9 tarball: add missing MSVS 2019 project files 5 tahun lalu
NEWS 1eecc125a9 more 18 tahun lalu
README d0e81c8e0f Updated README and COPYING 5 tahun lalu
acinclude.m4 070cbae02d Check for pthread support with autoconf archive macro 10 tahun lalu
autogen.sh 8b8c300312 bootstrap: improved shell compatibility, 5 tahun lalu
bootstrap 8b8c300312 bootstrap: improved shell compatibility, 5 tahun lalu
config.rpath 85913afa11 move to canonical gettext 6 tahun lalu
configure.ac 86832243cf Merge remote-tracking branch 'origin/master' into dev/ng0/gsoc2019 5 tahun lalu
libmicrohttpd.pc.in 80e6a8f3d0 configure.ac: add support for GnuTLS pkg-config 9 tahun lalu

README

About
=====

GNU libmicrohttpd is a GNU package offering a C library that provides
a compact API and implementation of an HTTP 1.1 web server (HTTP 1.0
is also supported). GNU libmicrohttpd only implements the HTTP 1.1
protocol. The main application must still provide the application
logic to generate the content.

GNU libmicrohttpd is dual-licensed under the GNU Lesser General Public
License (LGPLv2.1+) and the eCos License. See COPYING for details.


Installation
============

See INSTALL for generic installation instructions.

If you are using Git, 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.

Especially for development, do use the MHD_USE_ERROR_LOG option to get
error messages.


Configure options
=================


If you are concerned about space, you should set "CFLAGS" to "-Os
-fomit-frame-pointer" to have gcc generate tight code.

You can use the following options to disable certain MHD features:

--disable-https: no HTTPS / TLS / SSL support (significant reduction)
--disable-messages: no error messages (they take space!)
--disable-postprocessor: no MHD_PostProcessor API
--disable-dauth: no digest authentication API
--disable-epoll: no support for epoll, even on Linux

The resulting binary should be about 30-40k 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, W32, FreeBSD, Darwin,
NetBSD, OpenBSD, Solaris/OpenIndiana, and z/OS.
Note that HTTPS is not supported on z/OS (yet). We also have reports
of users using it on vxWorks.


Development Status
==================

This is a beta release for libmicrohttpd. Before declaring the
library stable, we should have testcases for the following features:

- 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)
- resource limit enforcement
- client queuing early response, suppressing 100 CONTINUE
- chunked encoding to validate handling of footers
- more testing for SSL support
- MHD basic and digest authentication

In particular, the following functions are not covered by 'make check':
- mhd_panic_std (daemon.c); special case (abort)
- parse_options (daemon.c)
- MHD_set_panic_func (daemon.c)
- MHD_get_version (daemon.c)


Note that the working library is in src/microhttpd/ with the API in
src/include/microhttpd.h. An *experimental* (read: not yet working
at all) newer implementation is in src/lib/, with the new API in
src/include/microhttpd2.h. The experimental code will need MUCH
more testing and development, you are strongly advised to stick
to microhttpd.h unless you are a MHD developer!