HTTP_SENDSTATUS(3) libdill Library Functions HTTP_SENDSTATUS(3) NAME http_sendstatus - sends HTTP status to the peer SYNOPSIS #include <libdill.h> int http_sendstatus( int s, int status, const char* reason, int64_t deadline); DESCRIPTION WARNING: This is experimental functionality and the API may change in the future. HTTP is an application-level protocol described in RFC 7230. This imple- mentation handles only the request/response exchange. Whatever comes after that must be handled by a different protocol. This function sends an HTTP status line to the peer. It is meant to be done at the beginning of the HTTP response. For example, if status is 404 and reason is 'Not found' the line sent will look like this: HTTP/1.1 404 Not found s: HTTP socket handle. status: HTTP status such as 200 or 404. reason: Reason string such as 'OK' or 'Not found'. deadline: A point in time when the operation should time out, in millisec- onds. Use the now function to get your current point in time. 0 means im- mediate timeout, i.e., perform the operation if possible or return without blocking if not. -1 means no deadline, i.e., the call will block forever if the operation cannot be performed. This function is not available if libdill is compiled with --disable-sock- ets option. RETURN VALUE In case of success the function returns 0. In case of error it returns -1 and sets errno to one of the values below. ERRORS * EBADF: Invalid handle. * ECANCELED: Current coroutine was canceled. * ECONNRESET: Broken connection. * EINVAL: Invalid argument. * ENOTSUP: The handle does not support this operation. * ETIMEDOUT: Deadline was reached. EXAMPLE int s = tcp_accept(listener, NULL, -1); s = http_attach(s, -1); char command[256]; char resource[256]; http_recvrequest(s, command, sizeof(command), resource, sizeof(resource), -1); while(1) { char name[256]; char value[256]; int rc = http_recvfield(s, name, sizeof(name), value, sizeof(value), -1); if(rc == -1 && errno == EPIPE) break; } http_sendstatus(s, 200, "OK", -1); s = http_detach(s, -1); tcp_close(s); SEE ALSO http_attach(3) http_attach_mem(3) http_detach(3) http_done(3) http_recv- field(3) http_recvrequest(3) http_recvstatus(3) http_sendfield(3) http_sendrequest(3) now(3) libdill HTTP_SENDSTATUS(3)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=http_sendstatus&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>