[GNUnet-SVN] r28549 - in libmicrohttpd: . doc

[gnunet]

Author: grothoff
Date: 2013-08-12 23:51:47 +0200 (Mon, 12 Aug 2013)
New Revision: 28549

Modified:
   libmicrohttpd/ChangeLog
   libmicrohttpd/README
   libmicrohttpd/doc/libmicrohttpd.texi
Log:
-document select/shutdown issue on W32, move z/os documentation into manual

Modified: libmicrohttpd/ChangeLog
===================================================================
--- libmicrohttpd/ChangeLog     2013-08-12 21:04:24 UTC (rev 28548)
+++ libmicrohttpd/ChangeLog     2013-08-12 21:51:47 UTC (rev 28549)
@@ -1,3 +1,6 @@
+Mon Aug 12 23:51:18 CEST 2013
+       Updated manual, documenting W32 select/shutdown issue. -CG
+
 Sat Aug 10 21:01:18 CEST 2013
        Trying to fix #2983 (untested). -CG
 

Modified: libmicrohttpd/README
===================================================================
--- libmicrohttpd/README        2013-08-12 21:04:24 UTC (rev 28548)
+++ libmicrohttpd/README        2013-08-12 21:51:47 UTC (rev 28549)
@@ -139,26 +139,5 @@
 Missing documentation:
 ======================
 
-- libmicrohttpd manual:
-  * document details on porting MHD (plibc, z/OS)
 - libmicrospdy manual:
   * missing entirely
-
-
-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).

Modified: libmicrohttpd/doc/libmicrohttpd.texi
===================================================================
--- libmicrohttpd/doc/libmicrohttpd.texi        2013-08-12 21:04:24 UTC (rev 
28548)
+++ libmicrohttpd/doc/libmicrohttpd.texi        2013-08-12 21:51:47 UTC (rev 
28549)
@@ -13,7 +13,7 @@
 (version @value{VERSION}, @value{UPDATED}), a library for embedding
 an HTTP(S) server into C applications.
 
-Copyright @copyright{} 2007--2012 Christian Grothoff
+Copyright @copyright{} 2007--2013 Christian Grothoff
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -267,9 +267,9 @@
 specifies path to libgnutls installation
 
 
- 
 @end table
 
+
 @section Including the microhttpd.h header
 @cindex portability
 @cindex microhttpd.h
@@ -358,6 +358,40 @@
 for the specific platform.
 
 
address@hidden Portability to W32
+
+On W32, GNUnet requires PlibC, a lightweight library to provide some
+more POSIX-like calls on W32.  While PlibC takes care of most issues,
+it is unable to make @code{select} (or equivalent alternative socket
+calls) unblock when a socket is @code{shutdown}.  This can be
+problematic if MHD is used in ``one thread per connection'' mode.  In
+this case, an inactive TCP connection may block @code{MHD_stop_daemon}
+until the connection times out.  You may be able to mitigate the issue
+by setting a reasonably low timeout, but in general we of course
+recommend migrating away from Windows.  Using MHD with other types of
+event loops is unaffected by this issue.
+
+
address@hidden Portability to z/OS
+
+To compile MHD on z/OS, extract the archive and run
+
address@hidden
+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
address@hidden verbatim
+to convert all source files to EBCDIC.  Note that you must run
address@hidden from the directory where the configure script is
+located.   Otherwise, configure will fail to find the
address@hidden/xcc} script (which is a wrapper around the z/OS c89
+compiler).
+
+
+
 @c ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
 @c ------------------------------------------------------------