ne_set_request_body_buffer

ne_set_request_body_buffer, ne_set_request_body_fd, ne_set_request_body_fd64 - include a message body with a request

The ne_set_request_body_buffer function specifies that a message body should be included with the body, which is stored in the count bytes buffer buf.

The ne_set_request_body_fd function can be used to include a message body with a request which is read from a file descriptor. The body is read from the file descriptor fd, which must be a associated with a seekable file (not a pipe, socket, or FIFO). count bytes are read, beginning at offset begin (hence, passing begin as zero means the body is read from the beginning of the file).

If the NE_LFS macro is defined, then the ne_set_request_body_fd64 function is also available, to provide large file support. This function can be used on 32-bit platforms supporting the LFS standard; the offset and length parameters can then be passed as 64-bit values. When using large files, fd must be opened using open64 or by passing the O_LARGEFILE flag to open.

For all the above functions, the source of the request body must survive until the request has been dispatched; neither the memory buffer passed to ne_set_request_body_buffer nor the file descriptor passed to ne_set_request_body_fd or ne_set_request_body_fd64 are copied internally.

ne_request_create