unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

nca(1)                           User Commands                          nca(1)



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

DESCRIPTION
       The  Solaris  Network  Cache and Accelerator ("NCA") is a kernel module
       designed to provide improved web server performance. The kernel module,
       ncakmod,  services HTTP requests. To improve the performance of servic-
       ing 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 fam-
       ily type PF_NCA. The PF_NCA family supports only SOCK_STREAM and proto-
       col 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 will fail.

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

         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 System Administration Guide: IP Ser-
       vices

       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 con-
       vert the log from a binary format to the Common Log File format.

FILES
       /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 will run.



       /etc/hostname.{}{0-9}           Lists  all  physical interfaces config-
                                       ured 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.



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


       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE   AvailabilitySUNWncar
       (32-bit)
        SUNWncarx (64-bit) Interface StabilityEvolving


SEE ALSO
       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),   lis-
       ten(3SOCKET), setsockopt(3SOCKET), shutdown(3SOCKET),  socket.h(3HEAD),
       socket(3SOCKET),      ncad_addr(4),     nca.if(4),     ncakmod.conf(4),
       ncalogd.conf(4), attributes(5)

       System Administration Guide: IP Services



SunOS 5.10                        28 Sep 2001                           nca(1)