nca(1)																	    nca(1)

NAME

       nca, snca - the Solaris Network Cache and Accelerator (NCA)

       The  Solaris  Network Cache and Accelerator ("NCA") is a kernel module designed to provide improved web server performance. The kernel mod-
       ule, ncakmod, services HTTP requests. To improve the performance of servicing HTTP requests, the NCA kernel module maintains  an  in-kernel
       cache  of  web pages. If the NCA kernel module cannot service the request itself, it passes the request to the http daemon (httpd). It uses
       either a sockets interface, with family type designated PF_NCA, or a private Solaris doors interface that is based on the Solaris doors RPC
       mechanism, to pass the request.

       To use the sockets interface, the web server must open a socket of family type PF_NCA. The PF_NCA family supports only SOCK_STREAM and pro-
       tocol 0, otherwise an error occurs.

       The following features are not presently supported:

	 o  You cannot initiate a connection from a PF_NCA type socket. The connect(3SOCKET) interface on PF_NCA fails.

	 o  System calls that are associated with type SO_DGRAM, such as send(), sendto(), sendmsg(), recv(), recvfrom(), and recvmsg(), fails.

	 o  You cannot set TCP or IP options on a PF_NCA type socket through setsockopt(3SOCKET).

       The NCA cache consistency is maintained by honoring HTTP headers that deal with a given content type and expiration date, much the same way
       as a proxy cache.

       For configuration information, see

       When  native PF_NCA socket support does not exist in the web server, the ncad_addr(4) interface must be used to provide NCA support in that
       web server.

       NCA is intended to be run on a dedicated web server. Running other large processes while running NCA might cause undesirable behavior.

       NCA supports the logging of in-kernel cache hits. See ncalogd.conf(4). NCA stores logs in a binary format. Use the ncab2clf(1)  utility	to
       convert the log from a binary format to the Common Log File format.

       /etc/nca/ncakmod.conf	       Lists configuration parameters for NCA.

       /etc/nca/ncalogd.conf	       Lists configuration parameters for NCA logging.

       /etc/nca/nca.if		       Lists the physical interfaces on which NCA runs.

       /etc/nca/ncaport.conf	       ncaport configuration file

       /etc/hostname.{}{0-9}	       Lists all physical interfaces configured on the server.

       /etc/hosts		       Lists all host names associated with the server. Entries in this file must match with entries in /etc/host-
				       name.{}{0-9} for NCA to function.

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWncar (32-bit) 	   |
       +-----------------------------+-----------------------------+
       |			     |SUNWncarx (64-bit)	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

       ncab2clf(1), ncakmod(1), close(2), read(2), write(2), sendfilev(3EXT),  accept(3SOCKET),  bind(3SOCKET)connect(3SOCKET),  door_bind(3DOOR),
       door_call(3DOOR),   door_create(3DOOR),	getsockopt(3SOCKET),  listen(3SOCKET),	setsockopt(3SOCKET),  shutdown(3SOCKET),  socket.h(3HEAD),
       socket(3SOCKET), ncad_addr(4), nca.if(4), ncakmod.conf(4), ncaport.conf(4), ncalogd.conf(4), attributes(5)

								    22 Feb 2005 							    nca(1)