[GNUnet-SVN] r26695 - libmicrohttpd/src/include

[gnunet]

Author: grothoff
Date: 2013-03-31 20:03:39 +0200 (Sun, 31 Mar 2013)
New Revision: 26695

Modified:
   libmicrohttpd/src/include/microhttpd.h
Log:
document sizes better

Modified: libmicrohttpd/src/include/microhttpd.h
===================================================================
--- libmicrohttpd/src/include/microhttpd.h      2013-03-31 18:03:25 UTC (rev 
26694)
+++ libmicrohttpd/src/include/microhttpd.h      2013-03-31 18:03:39 UTC (rev 
26695)
@@ -420,8 +420,11 @@
   MHD_OPTION_END = 0,
 
   /**
-   * Maximum memory size per connection (followed by a
-   * size_t).
+   * Maximum memory size per connection (followed by a size_t).
+   * Default is 32 kb (MHD_POOL_SIZE_DEFAULT).
+   * Values above 128k are unlikely to result in much benefit, as half
+   * of the memory will be typically used for IO, and TCP buffers are
+   * unlikely to support window sizes above 64k on most systems.
    */
   MHD_OPTION_CONNECTION_MEMORY_LIMIT = 1,
 
@@ -1645,7 +1648,8 @@
  *        internal buffering (used only for the parsing,
  *        specifically the parsing of the keys).  A
  *        tiny value (256-1024) should be sufficient.
- *        Do NOT use a value smaller than 256.
+ *        Do NOT use a value smaller than 256.  For good
+ *        performance, use 32 or 64k (i.e. 65536).
  * @param iter iterator to be called with the parsed data,
  *        Must NOT be NULL.
  * @param cls first argument to ikvi