[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] r15755 - libmicrohttpd-docs/WWW
From: |
gnunet |
Subject: |
[GNUnet-SVN] r15755 - libmicrohttpd-docs/WWW |
Date: |
Thu, 23 Jun 2011 11:45:15 +0200 |
Author: grothoff
Date: 2011-06-23 11:45:15 +0200 (Thu, 23 Jun 2011)
New Revision: 15755
Modified:
libmicrohttpd-docs/WWW/microhttpd.html
libmicrohttpd-docs/WWW/microhttpd.pdf
Log:
update
Modified: libmicrohttpd-docs/WWW/microhttpd.html
===================================================================
--- libmicrohttpd-docs/WWW/microhttpd.html 2011-06-22 14:34:28 UTC (rev
15754)
+++ libmicrohttpd-docs/WWW/microhttpd.html 2011-06-23 09:45:15 UTC (rev
15755)
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html401/loose.dtd">
<html>
-<!-- This manual documents GNU libmicrohttpd version 0.9.7, last
-updated 4 March 2011. It is built upon the documentation in the
+<!-- This manual documents GNU libmicrohttpd version 0.9.12, last
+updated 23 June 2011. It is built upon the documentation in the
header file microhttpd.h.
@@ -16,7 +16,7 @@
GNU libmicrohttpd is a GNU package.
-->
-<!-- Created on March 4, 2011 by texi2html 1.82
+<!-- Created on June 23, 2011 by texi2html 1.82
texi2html was written by:
Lionel Cons <address@hidden> (original author)
Karl Berry <address@hidden>
@@ -66,8 +66,8 @@
</tr></table>
<a name="The-GNU-libmicrohttpd-Library"></a>
<h1 class="settitle">The GNU libmicrohttpd Library</h1>
-<p>This manual documents GNU libmicrohttpd version 0.9.7, last
-updated 4 March 2011. It is built upon the documentation in the
+<p>This manual documents GNU libmicrohttpd version 0.9.12, last
+updated 23 June 2011. It is built upon the documentation in the
header file ‘<tt>microhttpd.h</tt>’.
</p>
@@ -123,7 +123,7 @@
<a name="microhttpd_002dintro"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="#Top" title="Previous section
in reading order"> < </a>]</td>
-<td valign="middle" align="left">[<a
href="#Including-the-microhttpd_002eh-header" title="Next section in reading
order"> > </a>]</td>
+<td valign="middle" align="left">[<a href="#Scope" title="Next section in
reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="#Top" title="Beginning of this
chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="#Top" title="Up section"> Up
</a>]</td>
@@ -181,9 +181,38 @@
used per connection to avoid resource exhaustion.
</p>
<hr size="6">
+<a name="Scope"></a>
+<table cellpadding="1" cellspacing="1" border="0">
+<tr><td valign="middle" align="left">[<a href="#microhttpd_002dintro"
title="Previous section in reading order"> < </a>]</td>
+<td valign="middle" align="left">[<a
href="#Including-the-microhttpd_002eh-header" title="Next section in reading
order"> > </a>]</td>
+<td valign="middle" align="left"> </td>
+<td valign="middle" align="left">[<a href="#microhttpd_002dintro"
title="Beginning of this chapter or previous chapter"> << </a>]</td>
+<td valign="middle" align="left">[<a href="#microhttpd_002dintro" title="Up
section"> Up </a>]</td>
+<td valign="middle" align="left">[<a href="#microhttpd_002dconst" title="Next
chapter"> >> </a>]</td>
+<td valign="middle" align="left"> </td>
+<td valign="middle" align="left"> </td>
+<td valign="middle" align="left"> </td>
+<td valign="middle" align="left"> </td>
+<td valign="middle" align="left">[<a href="#Top" title="Cover (top) of
document">Top</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC_Contents" title="Table of
contents">Contents</a>]</td>
+<td valign="middle" align="left">[<a href="#Concept-Index"
title="Index">Index</a>]</td>
+<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ?
</a>]</td>
+</tr></table>
+<h2 class="section">1.1 Scope</h2>
+
+<p><acronym>MHD</acronym> is currently used in a wide range of
implementations.
+Examples based on reports we’ve received from developers include:
+</p><ul>
+<li> Embedded HTTP server on a cortex M3 (128 KB code space)
+</li><li> Large-scale multimedia server (reportedly serving at the
+ simulator limit of 7.5 GB/s)
+</li><li> Administrative console (via HTTP/HTTPS) for network appliances
+</li></ul>
+
+<hr size="6">
<a name="Including-the-microhttpd_002eh-header"></a>
<table cellpadding="1" cellspacing="1" border="0">
-<tr><td valign="middle" align="left">[<a href="#microhttpd_002dintro"
title="Previous section in reading order"> < </a>]</td>
+<tr><td valign="middle" align="left">[<a href="#Scope" title="Previous section
in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="#SIGPIPE" title="Next section in
reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="#microhttpd_002dintro"
title="Beginning of this chapter or previous chapter"> << </a>]</td>
@@ -198,7 +227,7 @@
<td valign="middle" align="left">[<a href="#Concept-Index"
title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ?
</a>]</td>
</tr></table>
-<h2 class="section">1.1 Including the microhttpd.h header</h2>
+<h2 class="section">1.2 Including the microhttpd.h header</h2>
<a name="index-portability"></a>
<a name="index-microhttpd_002eh"></a>
@@ -238,7 +267,7 @@
<td valign="middle" align="left">[<a href="#Concept-Index"
title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ?
</a>]</td>
</tr></table>
-<h2 class="section">1.2 SIGPIPE</h2>
+<h2 class="section">1.3 SIGPIPE</h2>
<a name="index-signals"></a>
<p><acronym>MHD</acronym> does not install a signal handler for SIGPIPE. On
platforms
where this is possible (such as GNU/Linux), it disables SIGPIPE for
@@ -293,7 +322,7 @@
<td valign="middle" align="left">[<a href="#Concept-Index"
title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="#SEC_About" title="About (help)"> ?
</a>]</td>
</tr></table>
-<h2 class="section">1.3 MHD_LONG_LONG</h2>
+<h2 class="section">1.4 MHD_LONG_LONG</h2>
<a name="index-long-long"></a>
<a name="index-IAR"></a>
<a name="index-ARM"></a>
@@ -334,7 +363,7 @@
<dt><a name="index-MHD_005fFLAG"></a><u>Enumeration:</u> <b>MHD_FLAG</b></dt>
<dd><p>Options for the <acronym>MHD</acronym> daemon.
</p>
-<p>Note that if neither <code>MHD_USER_THREAD_PER_CONNECTION</code> nor
+<p>Note that if neither <code>MHD_USE_THREAD_PER_CONNECTION</code> nor
<code>MHD_USE_SELECT_INTERNALLY</code> is used, the client wants control over
the process and will call the appropriate microhttpd callbacks.
</p>
@@ -846,6 +875,11 @@
(HTTPS connections only). Takes no extra arguments.
</p>
</dd>
+<dt> <code>MHD_CONNECTION_INFO_DAEMON</code></dt>
+<dd><p>Returns information about <code>struct MHD_Daemon</code> which manages
+this connection.
+</p>
+</dd>
</dl>
</dd></dl>
@@ -1399,7 +1433,12 @@
<p>Obtain timeout value for select for this daemon (only needed if
connection timeout is used). The returned value is how long
<code>select()</code> should at most block, not the timeout value set for
-connections.
+connections. This function must not be called if the
+<code>MHD_USE_THREAD_PER_CONNECTION</code> mode is in use (since then it
+is not meaningful to ask for a timeout, after all, there is
+concurrenct activity). The function must also not be called by
+user-code if <code>MHD_USE_INTERNAL_SELECT</code> is in use. In the latter
+case, the behavior is undefined.
</p>
<dl compact="compact">
<dd><a name="index-timeout-2"></a>
@@ -1704,7 +1743,7 @@
<dd><p>file descriptor referring to a file on disk with the data; will be
closed when response is destroyed; note that ’fd’ must be an
actual
file descriptor (not a pipe or socket) since MHD might use
’sendfile’
-or ’seek’ on it
+or ’seek’ on it. The descriptor should be in blocking-IO mode.
</p></dd>
</dl>
@@ -1716,7 +1755,27 @@
<dt><a
name="index-MHD_005fcreate_005fresponse_005ffrom_005ffd_005fat_005foffset"></a><u>Function:</u>
struct MHD_Response * <b>MHD_create_response_from_fd_at_offset</b><i>
(uint64_t size, int fd, off_t offset)</i></dt>
<dd><p>Create a response object. The response object can be extended with
header information and then it can be used any number of times.
+Note that you need to be a bit careful about <code>off_t</code> when
+writing this code. Depending on your platform, <acronym>MHD</acronym> is
likely
+to have been compiled with support for 64-bit files. When you
+compile your own application, you must make sure that <code>off_t</code>
+is also a 64-bit value. If not, your compiler may pass a 32-bit
+value as <code>off_t</code>, which will result in 32-bits of garbage.
</p>
+<p>If you use the autotools, use the <code>AC_SYS_LARGEFILE</code> autoconf
+macro and make sure to include the generated ‘<tt>config.h</tt>’
file
+before ‘<tt>microhttpd.h</tt>’ to avoid problems. If you do not
have a
+build system and only want to run on a GNU/Linux system, you could
+also use
+</p><pre class="verbatim">#define _FILE_OFFSET_BITS 64
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <fcntl.h>
+#include <microhttpd.h>
+</pre><p>to ensure 64-bit <code>off_t</code>. Note that if your operating
system
+does not support 64-bit files, <acronym>MHD</acronym> will be compiled with a
32-bit
+<code>off_t</code> (in which case the above would be wrong...).
+</p>
<dl compact="compact">
<dt> <var>size</var></dt>
<dd><p>size of the data portion of the response (number of bytes to transmit
from the
@@ -1727,7 +1786,7 @@
<dd><p>file descriptor referring to a file on disk with the data; will be
closed when response is destroyed; note that ’fd’ must be an
actual
file descriptor (not a pipe or socket) since MHD might use
’sendfile’
-or ’seek’ on it
+or ’seek’ on it. The descriptor should be in blocking-IO mode.
</p>
</dd>
<dt> <var>offset</var></dt>
@@ -4053,7 +4112,7 @@
<tr><td></td><th align="left">Index Entry</th><th align="left">
Section</th></tr>
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-A">A</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-ARM">ARM</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.3 MHD_LONG_LONG</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-ARM">ARM</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.4 MHD_LONG_LONG</a></td></tr>
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-B">B</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-bind_002c-restricting-bind">bind, restricting bind</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
@@ -4062,7 +4121,7 @@
<tr><td></td><td valign="top"><a href="#index-cipher">cipher</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-connection_002c-limiting-number-of-connections">connection,
limiting number of connections</a></td><td valign="top"><a
href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-cookie">cookie</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-cortex-m3">cortex m3</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.3 MHD_LONG_LONG</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cortex-m3">cortex m3</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.4 MHD_LONG_LONG</a></td></tr>
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-D">D</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-debugging">debugging</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
@@ -4082,7 +4141,7 @@
<tr><td></td><td valign="top"><a
href="#index-GPL_002c-GNU-General-Public-License">GPL, GNU General Public
License</a></td><td valign="top"><a href="#GNU-GPL-with-eCos-Extension">GNU GPL
with eCos Extension</a></td></tr>
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-I">I</a></th><td></td><td></td></tr>
-<tr><td></td><td valign="top"><a href="#index-IAR">IAR</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.3 MHD_LONG_LONG</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-IAR">IAR</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.4 MHD_LONG_LONG</a></td></tr>
<tr><td></td><td valign="top"><a
href="#index-internationalization">internationalization</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-IPv6">IPv6</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td colspan="3"> <hr></td></tr>
@@ -4093,11 +4152,11 @@
<tr><td></td><td valign="top"><a href="#index-listen">listen</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-logging">logging</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-logging-1">logging</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-long-long">long long</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.3 MHD_LONG_LONG</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-long-long">long long</a></td><td
valign="top"><a href="#MHD_005fLONG_005fLONG">1.4 MHD_LONG_LONG</a></td></tr>
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-M">M</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-memory_002c-limiting-memory-utilization">memory, limiting memory
utilization</a></td><td valign="top"><a href="#microhttpd_002dconst">2.
Constants</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-microhttpd_002eh">microhttpd.h</a></td><td valign="top"><a
href="#Including-the-microhttpd_002eh-header">1.1 Including the microhttpd.h
header</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-microhttpd_002eh">microhttpd.h</a></td><td valign="top"><a
href="#Including-the-microhttpd_002eh-header">1.2 Including the microhttpd.h
header</a></td></tr>
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-O">O</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-options">options</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
@@ -4105,7 +4164,7 @@
<tr><th><a name="Concept-Index-1_cp_letter-P">P</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a
href="#index-performance">performance</a></td><td valign="top"><a
href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-poll">poll</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
-<tr><td></td><td valign="top"><a
href="#index-portability">portability</a></td><td valign="top"><a
href="#Including-the-microhttpd_002eh-header">1.1 Including the microhttpd.h
header</a></td></tr>
+<tr><td></td><td valign="top"><a
href="#index-portability">portability</a></td><td valign="top"><a
href="#Including-the-microhttpd_002eh-header">1.2 Including the microhttpd.h
header</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-POST-method">POST
method</a></td><td valign="top"><a href="#microhttpd_002dconst">2.
Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-POST-method-1">POST
method</a></td><td valign="top"><a href="#microhttpd_002dstruct">3. Structures
type definition</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-POST-method-2">POST
method</a></td><td valign="top"><a href="#microhttpd_002dcb">4. Callback
functions definition</a></td></tr>
@@ -4122,7 +4181,7 @@
<tr><td colspan="3"> <hr></td></tr>
<tr><th><a name="Concept-Index-1_cp_letter-S">S</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-select">select</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
-<tr><td></td><td valign="top"><a href="#index-signals">signals</a></td><td
valign="top"><a href="#SIGPIPE">1.2 SIGPIPE</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-signals">signals</a></td><td
valign="top"><a href="#SIGPIPE">1.3 SIGPIPE</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SSL">SSL</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SSL-1">SSL</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-SSL-2">SSL</a></td><td
valign="top"><a href="#microhttpd_002dconst">2. Constants</a></td></tr>
@@ -4334,9 +4393,10 @@
<ul class="toc">
<li><a name="toc-Introduction" href="#microhttpd_002dintro">1.
Introduction</a>
<ul class="toc">
- <li><a name="toc-Including-the-microhttpd_002eh-header"
href="#Including-the-microhttpd_002eh-header">1.1 Including the microhttpd.h
header</a></li>
- <li><a name="toc-SIGPIPE" href="#SIGPIPE">1.2 SIGPIPE</a></li>
- <li><a name="toc-MHD_005fLONG_005fLONG" href="#MHD_005fLONG_005fLONG">1.3
MHD_LONG_LONG</a></li>
+ <li><a name="toc-Scope" href="#Scope">1.1 Scope</a></li>
+ <li><a name="toc-Including-the-microhttpd_002eh-header"
href="#Including-the-microhttpd_002eh-header">1.2 Including the microhttpd.h
header</a></li>
+ <li><a name="toc-SIGPIPE" href="#SIGPIPE">1.3 SIGPIPE</a></li>
+ <li><a name="toc-MHD_005fLONG_005fLONG" href="#MHD_005fLONG_005fLONG">1.4
MHD_LONG_LONG</a></li>
</ul></li>
<li><a name="toc-Constants" href="#microhttpd_002dconst">2.
Constants</a></li>
<li><a name="toc-Structures-type-definition"
href="#microhttpd_002dstruct">3. Structures type definition</a></li>
@@ -4416,7 +4476,7 @@
</tr></table>
<h1>About This Document</h1>
<p>
- This document was generated by <em>Christian Grothoff</em> on <em>March 4,
2011</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
1.82</em></a>.
+ This document was generated by <em>Christian Grothoff</em> on <em>June 23,
2011</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
1.82</em></a>.
</p>
<p>
The buttons in the navigation panels have the following meaning:
@@ -4518,7 +4578,7 @@
<hr size="1">
<p>
<font size="-1">
- This document was generated by <em>Christian Grothoff</em> on <em>March 4,
2011</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
1.82</em></a>.
+ This document was generated by <em>Christian Grothoff</em> on <em>June 23,
2011</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html
1.82</em></a>.
</font>
<br>
Modified: libmicrohttpd-docs/WWW/microhttpd.pdf
===================================================================
(Binary files differ)
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [GNUnet-SVN] r15755 - libmicrohttpd-docs/WWW,
gnunet <=