libmicrohttpd

HTTP/1.x server C library (MHD 1.x, stable)
Log | Files | Refs | Submodules | README | LICENSE

README (2418B)

      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.