Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  im-
       plementation  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  mil-
       liseconds.   Use	the now	function to get	your current point in time.  0
       means immediate timeout,	i.e., perform the operation if possible	or re-
       turn  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	--dis-
       able-sockets 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
       o EBADF:	Invalid	handle.

       o ECANCELED: Current coroutine was canceled.

       o ECONNRESET: Broken connection.

       o EINVAL: Invalid argument.

       o ENOTSUP: The handle does not support this operation.

       o 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_recvfield(3)   http_recvrequest(3)	http_recvstatus(3)  http_send-
       field(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://www.freebsd.org/cgi/man.cgi?query=http_sendstatus&sektion=3&manpath=FreeBSD+13.1-RELEASE+and+Ports>

home | help