1nca(1)                           User Commands                          nca(1)
2
3
4

NAME

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

DESCRIPTION

9       The  Solaris  Network  Cache and Accelerator ("NCA") is a kernel module
10       designed to provide improved web server performance. The kernel module,
11       ncakmod,  services HTTP requests. To improve the performance of servic‐
12       ing HTTP requests, the NCA kernel module maintains an  in-kernel  cache
13       of  web  pages.  If  the  NCA  kernel module cannot service the request
14       itself, it passes the request to  the  http  daemon  (httpd).  It  uses
15       either  a  sockets  interface, with family type designated PF_NCA, or a
16       private Solaris doors interface that is based on the Solaris doors  RPC
17       mechanism, to pass the request.
18
19
20       To use the sockets interface, the web server must open a socket of fam‐
21       ily type PF_NCA. The PF_NCA family supports only SOCK_STREAM and proto‐
22       col 0, otherwise an error occurs.
23
24
25       The following features are not presently supported:
26
27           o      You  cannot initiate a connection from a PF_NCA type socket.
28                  The connect(3SOCKET) interface on PF_NCA fails.
29
30           o      System calls that are associated with type SO_DGRAM, such as
31                  send(),   sendto(),   sendmsg(),   recv(),  recvfrom(),  and
32                  recvmsg(), fails.
33
34           o      You cannot set TCP or IP options on  a  PF_NCA  type  socket
35                  through setsockopt(3SOCKET).
36
37
38       The  NCA  cache consistency is maintained by honoring HTTP headers that
39       deal with a given content type and expiration date, much the  same  way
40       as a proxy cache.
41
42
43       For configuration information, see System Administration Guide: IP Ser‐
44       vices
45
46
47       When native PF_NCA socket support does not exist in the web server, the
48       ncad_addr(4)  interface must be used to provide NCA support in that web
49       server.
50
51
52       NCA is intended to be run on a  dedicated  web  server.  Running  other
53       large processes while running NCA might cause undesirable behavior.
54
55
56       NCA  supports the logging of in-kernel cache hits. See ncalogd.conf(4).
57       NCA stores logs in a binary format. Use the ncab2clf(1) utility to con‐
58       vert the log from a binary format to the Common Log File format.
59

FILES

61       /etc/nca/ncakmod.conf    Lists configuration parameters for NCA.
62
63
64       /etc/nca/ncalogd.conf    Lists  configuration  parameters  for NCA log‐
65                                ging.
66
67
68       /etc/nca/nca.if          Lists the physical  interfaces  on  which  NCA
69                                runs.
70
71
72       /etc/nca/ncaport.conf    ncaport configuration file
73
74
75       /etc/hostname.{}{0-9}    Lists  all  physical  interfaces configured on
76                                the server.
77
78
79       /etc/hosts               Lists  all  host  names  associated  with  the
80                                server.  Entries  in this file must match with
81                                entries in /etc/hostname.{}{0-9}  for  NCA  to
82                                function.
83
84

ATTRIBUTES

86       See attributes(5) for descriptions of the following attributes:
87
88
89
90
91       ┌─────────────────────────────┬─────────────────────────────┐
92       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
93       ├─────────────────────────────┼─────────────────────────────┤
94       │Availability                 │SUNWncar (32-bit)            │
95       ├─────────────────────────────┼─────────────────────────────┤
96       │                             │SUNWncarx (64-bit)           │
97       ├─────────────────────────────┼─────────────────────────────┤
98       │Interface Stability          │Committed                    │
99       └─────────────────────────────┴─────────────────────────────┘
100

SEE ALSO

102       ncab2clf(1),  ncakmod(1), close(2), read(2), write(2), sendfilev(3EXT),
103       accept(3SOCKET),   bind(3SOCKET),   connect(3SOCKET),    door_bind(3C),
104       door_call(3C),  door_create(3C),  getsockopt(3SOCKET), listen(3SOCKET),
105       setsockopt(3SOCKET),        shutdown(3SOCKET),         socket.h(3HEAD),
106       socket(3SOCKET),   ncad_addr(4),   nca.if(4),   ncakmod.conf(4),   nca‐
107       port.conf(4), ncalogd.conf(4), attributes(5)
108
109
110       System Administration Guide: IP Services
111
112
113
114SunOS 5.11                        22 Feb 2005                           nca(1)