NAME

       ne_set_request_flag, ne_get_request_flag - set and retrieve per-request flags

SYNOPSIS

       #include <ne_request.h>

       void ne_set_request_flag(ne_request *req, ne_request_flag flag, int value);

       int ne_get_request_flag(ne_request *req, ne_request_flag flag);

DESCRIPTION

       The ne_set_request_flag function enables or disables a per-request flag. Passing a non-zero value
       argument enables the flag, and zero disables it.

       The following flags are defined:

       NE_REQFLAG_EXPECT100
           enable this flag to use the "Expect: 100-continue" feature of HTTP/1.1, which allows the server to
           process request headers without reading the entire request body. This saves time and bandwidth if the
           server gives an authentication challenge (requiring the request to be resent), but has
           interoperability problems with some older servers.

       NE_REQFLAG_IDEMPOTENT
           disable this flag if the request uses a non-idempotent method such as POST

       NE_REQFLAG_1XXTIMEOUT (default on)
           disable this flag to disable overall timeout when reading interim (1xx) responses;

RETURN VALUE

       The ne_get_request_flag function returns zero if a flag is disabled, less than zero if the flag is not
       supported, or greater than zero if the flag is enabled.

SEE ALSO

       ne_request_create.

COPYRIGHT

       Copyright © 2001-2024 Joe Orton

neon 0.34.0                                     23 November 2024                          NE_SET_REQUEST_FLAG(3)