User Commands                                              nca(1)

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

DESCRIPTION
     The Solaris Network Cache and Accelerator ("NCA") is a  ker-
     nel  module  designed to provide improved web server perfor-
     mance. The kernel module, 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 protocol 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 Services

     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 undesir-
     able 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.


FILES
     /etc/nca/ncakmod.conf           Lists configuration  parame-
                                     ters for NCA.



     /etc/nca/ncalogd.conf           Lists configuration  parame-
                                     ters for NCA logging.



     /etc/nca/nca.if                 Lists  the  physical  inter-
                                     faces on which NCA will run.



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



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



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

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


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),
     listen(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