a mirror of the embedded httpd http server for c and c++
#embedded #httpd #http-server #lightweight #embeddable #library

Christian Grothoff ba8f88fcb4 fix #10483 vor 4 Monaten
contrib 0489469cd6 make-dist.sh: allowed Debian trixie/sid vor 2 Jahren
doc 8a163c3f73 fix example FTBFS vor 4 Monaten
m4 a1085032dc mhd_sys_extentions.m4: more fixed for older autoconf vor 1 Jahr
po ebe728629c fix double-close() bug reported by MC on the mailinglist vor 7 Monaten
src deae6d4e09 fix indentation vor 4 Monaten
w32 eb9ec7fda1 W32 VS: simplified custom MHD_config.h vor 2 Jahren
.dir-locals.el 8c44c704b9 .dir-locals.el: fixed language for dictionary vor 6 Jahren
.gitattributes 671ad58593 Updated .gitattributes vor 3 Jahren
.gitignore 32d37eb770 Updated .gitignore vor 2 Jahren
.gitlab-ci.yml 7f28cb410d Remove tags from .gitlab-ci.yml vor 1 Jahr
.gitmodules 84216009dd Add build-common submodule. vor 6 Jahren
AUTHORS 916886cdf6 Added Lawrence Sebald to the AUTHORS file vor 4 Jahren
COPYING d0e81c8e0f Updated README and COPYING vor 6 Jahren
ChangeLog ebe728629c fix double-close() bug reported by MC on the mailinglist vor 7 Monaten
Makefile.am dc1973a702 -typos vor 2 Jahren
NEWS ebe728629c fix double-close() bug reported by MC on the mailinglist vor 7 Monaten
README 0db39f453a remove pre-1.0 comment vor 5 Monaten
SECURITY.md 0a112de8ec add SECURITY.md vor 4 Monaten
autogen.sh 50e28fbb90 bootstrap script: improved portability vor 2 Jahren
bootstrap ea51b392d0 bootstrap: better support Gentoo and MinGW vor 1 Jahr
configure.ac ba8f88fcb4 fix #10483 vor 4 Monaten
funding.json 5e40455bea -test vor 1 Jahr
libmicrohttpd.pc.in 80e6a8f3d0 configure.ac: add support for GnuTLS pkg-config vor 11 Jahren

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.


Joining GNU
===========

This is a GNU program, developed by the GNU Project and part of the
GNU Operating System. If you are the author of an awesome program and
want to join us in writing Free Software, please consider making it an
official GNU program and become a GNU maintainer. You can find
instructions on how to do so at http://www.gnu.org/help/evaluation.
We are looking forward to hacking with you!


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

See INSTALL for generic installation instructions.

If you are using Git, run "./bootstrap" 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 stable release for libmicrohttpd.