1NE_SET_REQUEST_E(3)           neon API reference           NE_SET_REQUEST_E(3)
2
3
4

NAME

6       ne_set_request_expect100 - function to enable Expect: 100-continue sup‐
7       port
8

SYNOPSIS

10       #include <ne_request.h>
11
12
13       void ne_set_request_expect100 (ne_request *request, int flag);
14
15

DESCRIPTION

17       An extension introduced in the HTTP/1.1 specification was  the  use  of
18       the  Expect:  100-continue header. This header allows an HTTP client to
19       be informed of the expected response status before the request  message
20       body  is  sent: a useful optimisation for situations where a large mes‐
21       sage body is to be sent. The ne_set_request_expect100 function  can  be
22       used  to  enable  this  feature  by  passing  the flag parameter as any
23       non-zero integer.
24
25
26              Warning
27
28              Unfortunately, if this header is sent to a server which  is  not
29              fully  compliant with the HTTP/1.1 specification, a deadlock oc‐
30              curs resulting in a temporarily "hung" connection. neon will re‐
31              cover gracefully from this situation, but only after a 15 second
32              timeout. It is highly recommended that this option  is  not  en‐
33              abled unless it is known that the server in use correctly imple‐
34              ments Expect: 100-continue support.
35
36
37

SEE ALSO

39       ne_request_create(3).
40
41

AUTHOR

43       Joe Orton <neon@webdav.org>.
44
45
46
47neon 0.25.5                     20 January 2006            NE_SET_REQUEST_E(3)