ncaport.conf(4) File Formats ncaport.conf(4)NAME
ncaport.conf - ncaport configuration file
SYNOPSIS
/etc/nca/ncaport.conf
DESCRIPTION
The ncaport.conf file is used to configure the IP addresses and ports that the Solaris Network Cache and Acceleration (NCA) kernel module
services. The file contains two fields, key and value, in the format of ncaport=ipaddress/port. IPv4 addresses must be in the dot notation
d.d.d.d. IPv6 addresses must be in one of the three conventional forms (see inet_pton(3SOCKET)). If an asterisk (*) is used for an IP
address, it is interpreted as INADDR_ANY, which matches any IP address.
A web server uses the environment variable LD_PRELOAD and the ncaport.conf configuration file to convert an AF_INET socket to an AF_NCA
socket. LD_PRELOAD enables the NCA socket utility library to be loaded before libsocket.so.1. See the ncad_addr(4) for details. When a web
server issues the bind(3SOCKET) system call, it is intercepted by the interposition library ncad_addr.so. If the bind address is in the
ncaport.conf file, the AF_INET socket is converted to a AF_NCA socket.
EXAMPLES
Example 1: Sample ncaport.conf File
The following is a sample ncaport.conf file:
#
# NCA Kernel Module Port Configuration File
#
ncaport=1080:0:0:0:8:800:200C:417A/100
ncaport=192.168.84.71/80
ncaport=*/9000
SEE ALSO nca(1), bind(3SOCKET), inet_pton(3SOCKET), ncad_addr(4), attributes(5)NOTES
For those web servers that use AF_NCA sockets, the NCA port configuration described here has no effect.
NCA does not currently support IPv6. Any IPv6 addresses in the file ncaport.conf are ignored.
SunOS 5.10 30 Jul 2001 ncaport.conf(4)
Check Out this Related Man Page
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)