ne_set_request_body_(3)
NAME
ne_set_request_body_buffer, ne_set_request_body_fd,
ne_set_request_body_fd64 - include a message body with a request
SYNOPSIS
#include <ne_request.h> void ne_set_request_body_buffer(ne_request *req, const char *buf, size_t count); int ne_set_request_body_fd(ne_request *req, int fd, off_t begin, off_t length); int ne_set_request_body_fd64(ne_request *req, int fd, off64_t begin, off64_t length);
DESCRIPTION
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.
SEE ALSO
ne_request_create
AUTHOR
- Joe Orton <neon@webdav.org>
- Author.