diff options
Diffstat (limited to 'doc/ref/reqopts.xml')
-rw-r--r-- | doc/ref/reqopts.xml | 60 |
1 files changed, 0 insertions, 60 deletions
diff --git a/doc/ref/reqopts.xml b/doc/ref/reqopts.xml deleted file mode 100644 index bb4ca4a..0000000 --- a/doc/ref/reqopts.xml +++ /dev/null @@ -1,60 +0,0 @@ -<refentry id="refreqopts"> - - <refmeta> - <refentrytitle>ne_set_request_expect100</refentrytitle> - <manvolnum>3</manvolnum> - </refmeta> - - <refnamediv> - <refname id="ne_set_request_expect100">ne_set_request_expect100</refname> - <refpurpose>function to enable Expect: 100-continue support</refpurpose> - </refnamediv> - - <refsynopsisdiv> - - <funcsynopsis> - - <funcsynopsisinfo>#include <ne_request.h></funcsynopsisinfo> - - <funcprototype> - <funcdef>void <function>ne_set_request_expect100</function></funcdef> - <paramdef>ne_request *<parameter>request</parameter></paramdef> - <paramdef>int <parameter>flag</parameter></paramdef> - </funcprototype> - - </funcsynopsis> - - </refsynopsisdiv> - - <refsect1> - <title>Description</title> - - <para>An extension introduced in the HTTP/1.1 specification was - the use of the <literal>Expect: 100-continue</literal> header. - This header allows an HTTP client to be informed of the expected - response status before the request message body is sent: a useful - optimisation for situations where a large message body is to be - sent. The <function>ne_set_request_expect100</function> function - can be used to enable this feature by passing the - <parameter>flag</parameter> parameter as any non-zero - integer.</para> - - <warning><para>Unfortunately, if this header is sent to a server - which is not fully compliant with the HTTP/1.1 specification, a - deadlock occurs resulting in a temporarily "hung" connection. - neon will recover gracefully from this situation, but only after a - 15 second timeout. It is highly recommended that this option is - not enabled unless it is known that the server in use correctly - implements <literal>Expect: 100-continue</literal> - support.</para></warning> - - </refsect1> - - <refsect1> - <title>See also</title> - - <para><xref linkend="ne_request_create"/>.</para> - - </refsect1> - -</refentry> |