ns_connclose(3aolserv) [debian man page]

Ns_ConnClose(3aolserver)				   AOLserver Library Procedures 				  Ns_ConnClose(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_ConnClose - Close an open connection

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConnClose(conn)

ARGUMENTS

       Ns_Conn	 conn	(in)	  Pointer to open connection.
_________________________________________________________________

DESCRIPTION

       This function calls the connection's communication driver to close the connection if it is not already closed.  It always returns NS_OK.

       If  the	connection is marked for keep-alive, the underlying connection is not actually closed but instead returned to the driver thread to
       process additional requests, if any.  Connections are automatically marked for keep-alive by setting  the  NS_CONN_KEEPALIVE  flag  if  the
       client  supports  it  by sending an appropriate connection-keepalive header.  Keep alive can be disabled before a call to Ns_ConnClose with
       the Ns_ConnSetKeepAliveFlag routine with a zero value for the flag argument.

SEE ALSO

       Ns_ConnSetKeepAliveFlag(3), Ns_ConnGetKeepAliveFlag(3), Ns_ConnFlush(3)

KEYWORDS

       connection, close, keep-alive

AOLserver								4.0						  Ns_ConnClose(3aolserver)

Ns_ConnStatus(3aolserver)				   AOLserver Library Procedures 				 Ns_ConnStatus(3aolserver)

__________________________________________________________________________________________________________________________________________________

NAME

       Ns_ConnGetStatus, Ns_ConnSetStatus - Routines to manage the HTTP response status

SYNOPSIS

       #include "ns.h"

       int
       Ns_ConnGetStatus(conn)

       void
       Ns_ConnSetStatus(conn, status)

ARGUMENTS

       Ns_Conn	 conn	(in)	  Pointer to open connection.

       int	 status (in)	  Integer HTTP status code.
_________________________________________________________________

DESCRIPTION

       These  routines	manage the HTTP response code sent to the client in a later call to Ns_ConnFlush or Ns_ConnFlushDirect.  Higher level rou-
       tines such as the Ns_ConnReturn functions normally call these routines automatically using standard HTTP status codes and the Ns_ConnQueue-
       Headers routine can be used to set the status code for lower level code which bypasses Ns_ConnFlush.

       int Ns_ConnGetStatus(conn)
	      Return the current HTTP status to be sent.

       int Ns_ConnSetStatus(conn, status)
	      Set the status code to be sent in the response, for example, 200 for a normal "OK" response.  A later call to Ns_ConnFlush will con-
	      struct the appropriate HTTP response including the given status with the cooresponding string status code.

EXAMPLES

       The following example demonstrates setting an odd status code followed by a call to Ns_ConnFlushDirect to send some data:

		Ns_ConnSetStatus(conn, 600);
		Ns_ConnSetType(conn, "text/plain");
		Ns_ConnFlushDirect(conn, "hello", 5, 0);

       The following should provide similar results:

		Ns_ConnSetRequiredHeaders(conn, "text/plain", 5);
		Ns_ConnQueueHeaders(conn, 600);
		Ns_ConnPuts(conn, "hello");
		Ns_ConnClose(conn);

SEE ALSO

       Ns_ConnGetType(3),  Ns_ConnSetType(3),  Ns_ConnFlush(3),   Ns_ConnFlushDirect(3),   Ns_ConnSetRequiredHeaders(3),   Ns_ConnQueueHeaders(3),
       ns_conn(n)

KEYWORDS

       connectionn, response, status

AOLserver								4.0						 Ns_ConnStatus(3aolserver)