diff options
author | Garrett D'Amore <garrett@damore.org> | 2022-07-03 19:05:50 -0700 |
---|---|---|
committer | Garrett D'Amore <garrett@damore.org> | 2022-07-11 18:59:59 -0400 |
commit | 15f90b02bdacbf0ae47fa105944f15b6596f9748 (patch) | |
tree | 998c2fb60e1c6a117e55985b8d94631e5cc95ea8 /usr/src/man | |
parent | 174513368dec739adb93c76e5d47aed84797d1ad (diff) | |
download | illumos-joyent-15f90b02bdacbf0ae47fa105944f15b6596f9748.tar.gz |
14768 retire nca
Reviewed by: Peter Tribble <peter.tribble@gmail.com>
Reviewed by: Andy Fiddaman <andy@omnios.org>
Reviewed by: Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org>
Approved by: Robert Mustacchi <rm@fingolfin.org>
Diffstat (limited to 'usr/src/man')
-rw-r--r-- | usr/src/man/man1/Makefile | 8 | ||||
-rw-r--r-- | usr/src/man/man1/digest.1 | 11 | ||||
-rw-r--r-- | usr/src/man/man1/nca.1 | 176 | ||||
-rw-r--r-- | usr/src/man/man1/ncab2clf.1 | 212 | ||||
-rw-r--r-- | usr/src/man/man1/ncakmod.1 | 119 | ||||
-rw-r--r-- | usr/src/man/man3ext/sendfilev.3ext | 16 | ||||
-rw-r--r-- | usr/src/man/man3socket/socket.3socket | 27 | ||||
-rw-r--r-- | usr/src/man/man5/Makefile | 6 | ||||
-rw-r--r-- | usr/src/man/man5/nca.if.5 | 142 | ||||
-rw-r--r-- | usr/src/man/man5/ncad_addr.5 | 76 | ||||
-rw-r--r-- | usr/src/man/man5/ncakmod.conf.5 | 110 | ||||
-rw-r--r-- | usr/src/man/man5/ncalogd.conf.5 | 118 | ||||
-rw-r--r-- | usr/src/man/man5/ncaport.conf.5 | 69 | ||||
-rw-r--r-- | usr/src/man/man8/Makefile | 3 | ||||
-rw-r--r-- | usr/src/man/man8/ncaconfd.8 | 84 |
15 files changed, 10 insertions, 1167 deletions
diff --git a/usr/src/man/man1/Makefile b/usr/src/man/man1/Makefile index 60cc6a6ecf..e98c187773 100644 --- a/usr/src/man/man1/Makefile +++ b/usr/src/man/man1/Makefile @@ -12,7 +12,7 @@ # # Copyright 2011, Richard Lowe # Copyright 2018 Nexenta Systems, Inc. -# Copyright 2014 Garrett D'Amore <garrett@damore.org> +# Copyright 2022 Garrett D'Amore # Copyright 2019 OmniOS Community Edition (OmniOSce) Association. # Copyright 2020 Joyent, Inc. # @@ -248,9 +248,6 @@ MANFILES= acctcom.1 \ mt.1 \ mv.1 \ nc.1 \ - nca.1 \ - ncab2clf.1 \ - ncakmod.1 \ newform.1 \ newgrp.1 \ news.1 \ @@ -519,7 +516,6 @@ MANLINKS= batch.1 \ setenv.1 \ settime.1 \ sh.1 \ - snca.1 \ source.1 \ spellin.1 \ stop.1 \ @@ -666,8 +662,6 @@ rmail.1 := LINKSRC = mail.1 page.1 := LINKSRC = more.1 -snca.1 := LINKSRC = nca.1 - pcat.1 := LINKSRC = pack.1 unpack.1 := LINKSRC = pack.1 diff --git a/usr/src/man/man1/digest.1 b/usr/src/man/man1/digest.1 index 82a9566df2..dc4cb0c3d8 100644 --- a/usr/src/man/man1/digest.1 +++ b/usr/src/man/man1/digest.1 @@ -4,22 +4,19 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DIGEST 1 "Feb 07, 2018" +.TH DIGEST 1 "July 3, 2022" .SH NAME digest \- calculate a message digest .SH SYNOPSIS -.LP .nf \fB/usr/bin/digest\fR \fB-l\fR | [\fB-v\fR] \fB-a\fR \fIalgorithm\fR [\fIfile\fR]... .fi .SH DESCRIPTION -.LP The \fBdigest\fR utility calculates the message digest of the given files or \fBstdin\fR using the algorithm specified. If more than one file is given, each line of output is the digest of a single file. .SH OPTIONS -.LP The following options are supported: .sp .ne 2 @@ -52,7 +49,6 @@ Verbose output. Includes the algorithm name and filename in the output. .SH USAGE .SS "Algorithms" -.LP These algorithms are provided by the Cryptographic Framework. Each algorithm supported by the command is an alias of the PKCS #11 mechanism for easier access. For example, \fBsha1\fR is an alias to \fBCKM_SHA_1\fR. @@ -60,7 +56,6 @@ access. For example, \fBsha1\fR is an alias to \fBCKM_SHA_1\fR. .LP These aliases are used with the \fB-a\fR option and are case-sensitive. .SH EXAMPLES -.LP \fBExample 1 \fRSimulating Output .sp .LP @@ -111,7 +106,6 @@ sha1 (/usr/lib/inet/in.iked) = be6061fad725d37256e773dc85f8bd5248649463 sha1 (/usr/lib/inet/in.mpathd) = 5bd6bf0340fd5c4cc0c53f2df158302a0e85f9d0 sha1 (/usr/lib/inet/in.ndpd) = fdb768aebe7e5eb4465e1c1bb5e679b496f5c5c6 sha1 (/usr/lib/inet/in.ripngd) = 4f56a0df2d4a252f581a73c2e84143b920d0b66b -sha1 (/usr/lib/inet/ncaconfd) = 7219542b5585a8d1104d7ce4a2ced07d8a260ea3 sha1 (/usr/lib/inet/ppp) = c96ee458549871a6ffdf2674a888b01d0c9e9740 sha1 (/usr/lib/inet/pppoec) = 5f022498d79dacacd947cddadc64f171822e3dee sha1 (/usr/lib/inet/pppoed) = 252bd2f0863dbc1b05fffae72821a2a95609b8ad @@ -141,7 +135,6 @@ sha512 .sp .SH EXIT STATUS -.LP The following exit values are returned: .sp .ne 2 @@ -162,7 +155,6 @@ An error occurred. .RE .SH ATTRIBUTES -.LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp @@ -177,7 +169,6 @@ Interface Stability Committed .TE .SH SEE ALSO -.LP .BR cksum (1), .BR encrypt (1), .BR mac (1), diff --git a/usr/src/man/man1/nca.1 b/usr/src/man/man1/nca.1 deleted file mode 100644 index 4760571da2..0000000000 --- a/usr/src/man/man1/nca.1 +++ /dev/null @@ -1,176 +0,0 @@ -'\" te -.\" Copyright (C) 2005, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. -.\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with -.\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCA 1 "Feb 22, 2005" -.SH NAME -nca, snca \- the Solaris Network Cache and Accelerator (NCA) -.SH DESCRIPTION -.sp -.LP -The Solaris Network Cache and Accelerator ("\fBNCA\fR") is a kernel module -designed to provide improved web server performance. The kernel module, -\fBncakmod\fR, services \fBHTTP\fR requests. To improve the performance of -servicing \fBHTTP\fR requests, the \fBNCA\fR kernel module maintains an -in-kernel cache of web pages. If the \fBNCA\fR kernel module cannot service the -request itself, it passes the request to the \fBhttp\fR daemon (\fBhttpd\fR). -It uses either a sockets interface, with family type designated \fBPF_NCA\fR, -or a private Solaris doors interface that is based on the Solaris doors RPC -mechanism, to pass the request. -.sp -.LP -To use the sockets interface, the web server must open a socket of family type -\fBPF_NCA\fR. The \fBPF_NCA\fR family supports only \fBSOCK_STREAM\fR and -protocol 0, otherwise an error occurs. -.sp -.LP -The following features are not presently supported: -.RS +4 -.TP -.ie t \(bu -.el o -You cannot initiate a connection from a \fBPF_NCA\fR type socket. The -\fBconnect\fR(3SOCKET) interface on \fBPF_NCA\fR fails. -.RE -.RS +4 -.TP -.ie t \(bu -.el o -System calls that are associated with type \fBSO_DGRAM\fR, such as -\fBsend()\fR, \fBsendto()\fR, \fBsendmsg()\fR, \fBrecv()\fR, \fBrecvfrom()\fR, -and \fBrecvmsg()\fR, fails. -.RE -.RS +4 -.TP -.ie t \(bu -.el o -You cannot set TCP or IP options on a \fBPF_NCA\fR type socket through -\fBsetsockopt\fR(3SOCKET). -.RE -.sp -.LP -The \fBNCA\fR cache consistency is maintained by honoring \fBHTTP\fR headers -that deal with a given content type and expiration date, much the same way as a -proxy cache. -.sp -.LP -For configuration information, see \fISystem Administration Guide: IP -Services\fR -.sp -.LP -When native \fBPF_NCA\fR socket support does not exist in the web server, the -\fBncad_addr\fR(5) interface must be used to provide NCA support in that web -server. -.sp -.LP -\fBNCA\fR is intended to be run on a dedicated web server. Running other large -processes while running \fBNCA\fR might cause undesirable behavior. -.sp -.LP -\fBNCA\fR supports the logging of in-kernel cache hits. See -\fBncalogd.conf\fR(5). \fBNCA\fR stores logs in a binary format. Use the -\fBncab2clf\fR(1) utility to convert the log from a binary format to the Common -Log File format. -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncakmod.conf\fR\fR -.ad -.RS 25n -Lists configuration parameters for \fBNCA\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncalogd.conf\fR\fR -.ad -.RS 25n -Lists configuration parameters for \fBNCA\fR logging. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/nca/nca.if\fR\fR -.ad -.RS 25n -Lists the physical interfaces on which \fBNCA\fR runs. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncaport.conf\fR\fR -.ad -.RS 25n -\fBncaport\fR configuration file -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/hostname.{}{0-9}\fR\fR -.ad -.RS 25n -Lists all physical interfaces configured on the server. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/hosts\fR\fR -.ad -.RS 25n -Lists all host names associated with the server. Entries in this file must -match with entries in \fB/etc/hostname.{}{0-9}\fR for \fBNCA\fR to function. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Committed -.TE - -.SH SEE ALSO -.sp -.LP -.BR ncab2clf (1), -.BR ncakmod (1), -.BR close (2), -.BR read (2), -.BR write (2), -.BR door_bind (3C), -.BR door_call (3C), -.BR door_create (3C), -.BR sendfilev (3EXT), -.BR socket.h (3HEAD), -.BR accept (3SOCKET), -.BR bind (3SOCKET), -.BR connect (3SOCKET), -.BR getsockopt (3SOCKET), -.BR listen (3SOCKET), -.BR setsockopt (3SOCKET), -.BR shutdown (3SOCKET), -.BR socket (3SOCKET), -.BR nca.if (5), -.BR ncad_addr (5), -.BR ncakmod.conf (5), -.BR ncalogd.conf (5), -.BR ncaport.conf (5), -.BR attributes (7) -.sp -.LP -\fISystem Administration Guide: IP Services\fR diff --git a/usr/src/man/man1/ncab2clf.1 b/usr/src/man/man1/ncab2clf.1 deleted file mode 100644 index 6e4fcd2855..0000000000 --- a/usr/src/man/man1/ncab2clf.1 +++ /dev/null @@ -1,212 +0,0 @@ -'\" te -.\" Copyright (C) 2001, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCAB2CLF 1 "Sep 28, 2001" -.SH NAME -ncab2clf \- convert binary log file to Common Log File format -.SH SYNOPSIS -.LP -.nf -\fB/usr/bin/ncab2clf\fR [\fB-Dhv\fR] [\fB-i\fR \fIinput-file\fR] [\fB-o\fR \fIoutput-file\fR] - [\fB-b\fR \fIsize\fR] [\fB-n\fR \fInumber\fR] [\fB-s\fR \fIdatetime\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBncab2clf\fR command is used to convert the log file generated by the -Solaris Network Cache and Accelerator ("\fBNCA\fR") from binary format, to -Common Log File ("\fBCLF\fR") format. If no \fIinput-file\fR is specified, -\fBncab2clf\fR uses \fBstdin\fR. If no \fIoutput-file\fR is specified, the -output goes to \fBstdout\fR. -.SH OPTIONS -.sp -.ne 2 -.na -\fB\fB-b\fR\fR -.ad -.RS 18n -Specifies the binary-log-file blocking in kilobytes; the default is 64 Kbyte. -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR\fR -.ad -.RS 18n -Specifies that direct \fBI/O\fR be disabled. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.RS 18n -Prints usage message. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR \fIinput-file\fR\fR -.ad -.RS 18n -Specifies the input file. -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR \fInumber\fR\fR -.ad -.RS 18n -Output \fInumber\fR CLF records. -.RE - -.sp -.ne 2 -.na -\fB\fB-o\fR \fIoutput-file\fR\fR -.ad -.RS 18n -Specifies the output file. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR \fIdatetime\fR\fR -.ad -.RS 18n -Skip any records before the date and time specified in \fIdatetime\fR. You can -specify the date and time in CLF format or in the format specified by the -\fBtouch\fR(1) utility. CLF format is the dominant format, so \fBncab2clf\fR -first analyzes \fIdatetime\fR assuming CLF. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.RS 18n -Provides verbose output. -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRConverting a Binary File to a Common Log File Format -.sp -.LP -The following example converts the binary file \fB/var/nca/logs/nca.blf\fR to a -file \fB/var/nca/logs/nca.clf\fR, which is in Common Log File format. - -.sp -.in +2 -.nf -example% \fBncab2clf -D -i /var/nca/logs/nca.blf -o /var/nca/logs/nca.clf\fR -.fi -.in -2 -.sp - -.LP -\fBExample 2 \fRConverting Multiple Log Files -.sp -.LP -The following script may be used to convert multiple log files. The directory -designated by "\fB*\fR" must only contain log files. - -.sp -.in +2 -.nf -!/bin/ksh -for filename in * -do - ncab2clf -D < $filename > $filename.clf -done -.fi -.in -2 - -.LP -\fBExample 3 \fRUsing \fB-s\fR and \fB-n\fR on a Raw Device -.sp -.LP -The following example shows how \fBncab2clf\fR can be used on a raw device. If -not using the \fB-n\fR option, the default is to convert all records from the -starting location to the end of the file. The date and time specified with -\fB-s\fR, below, is in CLF format. - -.sp -.in +2 -.nf -example% ncab2clf -s '10/Apr/2001:09:23:13' -n 100 < /dev/dsk/c2t1d0s6 -.fi -.in -2 -.sp - -.SH EXIT STATUS -.sp -.LP -The following exit values are returned: -.sp -.ne 2 -.na -\fB\fB0\fR \fR -.ad -.RS 6n -The file converted successfully -.RE - -.sp -.ne 2 -.na -\fB>\fB0\fR\fR -.ad -.RS 6n -An error occurred. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -.BR nca (1), -.BR ncakmod (1), -.BR nca.if (5), -.BR ncakmod.conf (5), -.BR ncalogd.conf (5), -.BR attributes (7) -.sp -.LP -\fISystem Administration Guide: IP Services\fR -.SH NOTES -.sp -.LP -The binary log files generated by \fBNCA\fR can become very large. When -converting these large binary files, use the \fB-b\fR option to the -\fBncab2clf\fR command to help performance. -.sp -.LP -Direct \fBI/O\fR is a benefit to the user if the data being written does not -come in as large chunks. However, if the user wishes to convert the log file in -large chunks using the \fB-b\fR option, then direct \fBI/O\fR should be -disabled by using the \fB-D\fR option. diff --git a/usr/src/man/man1/ncakmod.1 b/usr/src/man/man1/ncakmod.1 deleted file mode 100644 index bf36c1977e..0000000000 --- a/usr/src/man/man1/ncakmod.1 +++ /dev/null @@ -1,119 +0,0 @@ -'\" te -.\" Copyright (C) 2001, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCAKMOD 1 "Sep 28, 2001" -.SH NAME -ncakmod \- start or stop the NCA kernel module -.SH SYNOPSIS -.LP -.nf -\fB/etc/init.d/ncakmod\fR \fBstart\fR | \fBstop\fR -.fi - -.SH DESCRIPTION -.sp -.LP -\fBncakmod\fR is used to start or stop the Solaris Network Cache and -Accelerator ("NCA") kernel module. -.sp -.LP -When the \fBstart\fR option is specified at the command-line, the \fBNCA\fR -kernel module will be activated for all physical interfaces listed in the -\fBnca.if\fR file. When the \fBncakmod\fR command is invoked with the -\fBstop\fR option, the NCA kernel module will print the following message: -.sp -.in +2 -.nf -To stop NCA, please set the status configuration parameter -to disable in ncakmod.conf and then reboot your system. See -the ncakmod.conf(5) manual page for more information. -.fi -.in -2 -.sp - -.sp -.LP -Note that in order to properly stop \fBNCA\fR on your system, you must first -edit the \fBncakmod.conf\fR(5) file and set the status field to "disable," then -reboot your system. -.SH OPTIONS -.sp -.ne 2 -.na -\fB\fBstart\fR\fR -.ad -.RS 9n -Starts the \fBNCA\fR kernel module. -.RE - -.sp -.ne 2 -.na -\fB\fBstop\fR\fR -.ad -.RS 9n -Describes the current method for stopping the \fBNCA\fR feature. -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRStarting and Stopping the NCA Feature -.sp -.LP -The following command is used to start the NCA feature: - -.sp -.in +2 -.nf -example% \fB/etc/init.d/ncakmod start\fR -.fi -.in -2 -.sp - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/init.d/ncakmod\fR\fR -.ad -.RS 25n -The NCA kernel module startup script. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncakmod.conf\fR\fR -.ad -.RS 25n -Specifies configuration options for the NCA kernel module. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -.BR nca (1), -.BR ncab2clf (1), -.BR nca.if (5), -.BR ncad_addr (5), -.BR ncakmod.conf (5), -.BR ncalogd.conf (5), -.BR attributes (7) diff --git a/usr/src/man/man3ext/sendfilev.3ext b/usr/src/man/man3ext/sendfilev.3ext index 6679356d05..568fe10d33 100644 --- a/usr/src/man/man3ext/sendfilev.3ext +++ b/usr/src/man/man3ext/sendfilev.3ext @@ -3,11 +3,11 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SENDFILEV 3EXT "Nov 26, 2017" +.\" Copyright 2022 Garrett D'Amore +.TH SENDFILEV 3EXT "July 3, 2022" .SH NAME sendfilev \- send a file .SH SYNOPSIS -.LP .nf \fBcc\fR [ \fIflag\fR\&.\|.\|. ] \fIfile\fR\&.\|.\|. \fB-lsendfile\fR [ \fIlibrary\fR... ] #include <sys/sendfile.h> @@ -17,7 +17,6 @@ sendfilev \- send a file .fi .SH PARAMETERS -.LP The \fBsendfilev()\fR function supports the following parameters: .sp .ne 2 @@ -25,9 +24,8 @@ The \fBsendfilev()\fR function supports the following parameters: \fB\fIfildes\fR\fR .ad .RS 11n -A file descriptor to a regular file or to a \fBAF_NCA\fR, \fBAF_INET\fR, or +A file descriptor to a regular file or to a \fBAF_INET\fR or \fBAF_INET6\fR family type \fBSOCK_STREAM\fR socket that is open for writing. -For \fBAF_NCA\fR, the protocol type should be zero. .RE .sp @@ -59,11 +57,10 @@ The total number of bytes written to \fBout_fd\fR. .RE .SH DESCRIPTION -.LP The \fBsendfilev()\fR function attempts to write data from the \fIsfvcnt\fR buffers specified by the members of \fIvec\fR array: \fBvec[0], vec[1], ... , vec[sfvcnt-1]\fR. The \fIfildes\fR argument is a file descriptor to a regular -file or to an \fBAF_NCA\fR, \fBAF_INET\fR, or \fBAF_INET6\fR family type +file or to an \fBAF_INET\fR or \fBAF_INET6\fR family type \fBSOCK_STREAM\fR socket that is open for writing. .sp .LP @@ -108,7 +105,6 @@ To send data directly from the address space of the process, set \fBsfv_fd\fR to \fBSFV_FD_SELF\fR. \fBsfv_off\fR should point to the data, with \fBsfv_len\fR containing the length of the buffer. .SH RETURN VALUES -.LP Upon successful completion, the \fBsendfilev()\fR function returns total number of bytes written to \fBout_fd\fR. Otherwise, it returns \fB-1\fR, and \fBerrno\fR is set to indicate the error. The \fIxferred\fR argument contains @@ -220,11 +216,9 @@ The socket type is not supported. .RE .SH USAGE -.LP The \fBsendfilev()\fR function has a transitional interface for 64-bit file offsets. See \fBlf64\fR(7). .SH EXAMPLES -.LP The following example sends 2 vectors, one of HEADER data and a file of length 100 over \fBsockfd\fR. \fBsockfd\fR is in a connected state, that is, \fBsocket()\fR, \fBaccept()\fR, and \fBbind()\fR operation are complete. @@ -262,7 +256,6 @@ main (int argc, char *argv[]){ .in -2 .SH ATTRIBUTES -.LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp @@ -279,7 +272,6 @@ MT-Level MT-Safe .TE .SH SEE ALSO -.LP .BR open (2), .BR writev (2), .BR sendfile (3EXT), diff --git a/usr/src/man/man3socket/socket.3socket b/usr/src/man/man3socket/socket.3socket index 1ceceb1098..cfb72c2646 100644 --- a/usr/src/man/man3socket/socket.3socket +++ b/usr/src/man/man3socket/socket.3socket @@ -5,11 +5,11 @@ .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SOCKET 3SOCKET "Jan 28, 2009" +.\" Copyright 2022 Garrett D'Amore +.TH SOCKET 3SOCKET "July 6, 2022" .SH NAME socket \- create an endpoint for communication .SH SYNOPSIS -.LP .nf \fBcc\fR [ \fIflag\fR ... ] \fIfile\fR ... \fB-lsocket\fR \fB -lnsl \fR [ \fIlibrary\fR ... ] #include <sys/types.h> @@ -19,11 +19,8 @@ socket \- create an endpoint for communication .fi .SH DESCRIPTION -.sp -.LP The \fBsocket()\fR function creates an endpoint for communication and returns a descriptor. -.sp .LP The \fIdomain\fR argument specifies the protocol family within which communication takes place. The protocol family is generally the same as the @@ -60,15 +57,6 @@ Internet Protocol Version 6 (IPv6) .RE .sp -.ne 2 -.na -\fB\fBPF_NCA\fR\fR -.ad -.RS 12n -Network Cache and Accelerator (NCA) protocols -.RE - -.sp .LP The socket has the indicated \fItype\fR, which specifies the communication semantics. Currently defined types are: @@ -197,13 +185,9 @@ The operation of sockets is controlled by socket level \fIoptions\fR. These options are defined in the file <\fBsys/socket.h\fR>. \fBsetsockopt\fR(3SOCKET) and \fBgetsockopt\fR(3SOCKET) are used to set and get options, respectively. .SH RETURN VALUES -.sp -.LP Upon successful completion, a descriptor referencing the socket is returned. Otherwise, -1 is returned and \fBerrno\fR is set to indicate the error. .SH ERRORS -.sp -.LP The \fBsocket()\fR function will fail if: .sp .ne 2 @@ -296,8 +280,6 @@ One or more of the specified flags is not supported. .RE .SH ATTRIBUTES -.sp -.LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp @@ -312,9 +294,6 @@ MT-Level Safe .TE .SH SEE ALSO -.sp -.LP -.BR nca (1), .BR close (2), .BR exec (2), .BR fcntl (2), @@ -337,7 +316,5 @@ MT-Level Safe .BR socketpair (3SOCKET), .BR attributes (7) .SH NOTES -.sp -.LP Historically, \fBAF_\fR* was commonly used in places where \fBPF_\fR* was meant. New code should be careful to use \fBPF_\fR* as necessary. diff --git a/usr/src/man/man5/Makefile b/usr/src/man/man5/Makefile index d7718eedec..ead3d03a48 100644 --- a/usr/src/man/man5/Makefile +++ b/usr/src/man/man5/Makefile @@ -15,6 +15,7 @@ # Copyright 2018 Nexenta Systems, Inc. # Copyright 2018 Gary Mills # Copyright 2021 OmniOS Community Edition (OmniOSce) Association. +# Copyright 2022 Garrett D'Amore <garrett@dmaore.org> # include $(SRC)/Makefile.master @@ -109,11 +110,6 @@ _MANFILES= Intro.5 \ mech.5 \ mnttab.5 \ mpapi.conf.5 \ - nca.if.5 \ - ncad_addr.5 \ - ncakmod.conf.5 \ - ncalogd.conf.5 \ - ncaport.conf.5 \ ndmp.5 \ ndpd.conf.5 \ netconfig.5 \ diff --git a/usr/src/man/man5/nca.if.5 b/usr/src/man/man5/nca.if.5 deleted file mode 100644 index 2ce8956464..0000000000 --- a/usr/src/man/man5/nca.if.5 +++ /dev/null @@ -1,142 +0,0 @@ -'\" te -.\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCA.IF 5 "Feb 18, 2003" -.SH NAME -nca.if \- the NCA configuration file that specifies physical interfaces -.SH SYNOPSIS -.LP -.nf -\fB/etc/nca/nca.if\fR -.fi - -.SH DESCRIPTION -.sp -.LP -Specify the physical interfaces for which the Solaris Network Cache and -Accelerator ("\fBNCA\fR") feature will be configured in the \fBnca.if\fR -configuration file. List the physical interfaces in the file, one per line. To -configure \fBNCA\fR to listen on all physical interfaces present on the system -backed by a \fBhostname.{interface_name}\fR, then list only an asterik -("\fB*\fR") in \fBnca.if\fR. -.sp -.LP -When the \fBncakmod\fR(1) initialization script is invoked during system boot, -it will attempt to configure each physical interface specified in the -\fBnca.if\fR file by using \fBncaconfd\fR(8). Note that there must be an -accompanying \fBhostname.{interface_name}\fR file and an entry in -\fB/etc/hosts\fR for the contents of \fBhostname.{interface_name}\fR. -.sp -.LP -You must reboot in order to implement changes to the \fBnca.if\fR file. -.SH EXAMPLES -.SS "x86" -.LP -\fBExample 1 \fR\fBnca.if\fR on x86 -.sp -.LP -The following is an example of an \fBnca.if\fR file that would be used on an -x86 system: - -.sp -.in +2 -.nf -iprb1 -iprb6 -iprb8 -.fi -.in -2 - -.SS "SPARC" -.LP -\fBExample 2 \fR\fBnca.if\fR on SPARC -.sp -.LP -The following is an example of an \fBnca.if\fR file that would be used on a -SPARC system: - -.sp -.in +2 -.nf -hme2 -hme3 -hme4 -.fi -.in -2 - -.SS "All Platforms" -.LP -\fBExample 3 \fRConfiguring NCA to Listen on All Physical Interfaces -.sp -.LP -The following example shows the contents of an \fBnca.if\fR file that would be -used to configure either platform to listen on all physical interfaces present -on the system: - -.sp -.in +2 -.nf -* -.fi -.in -2 - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/nca/nca.if\fR\fR -.ad -.RS 25n -Lists the physical interfaces on which \fBNCA\fR will run. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/hostname.{}{0-9}\fR\fR -.ad -.RS 25n -Lists all physical interfaces configured on the server. -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/hosts\fR\fR -.ad -.RS 25n -Lists all host names associated with the server. Entries in this file must -match with entries in \fB/etc/hostname.{}{0-9}\fR for \fBNCA\fR to function. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -.BR nca (1), -.BR ncab2clf (1), -.BR ncakmod (1), -.BR ncakmod.conf (5), -.BR ncalogd.conf (5), -.BR attributes (7), -.BR ifconfig (8) -.sp -.LP -\fISystem Administration Guide: IP Services\fR diff --git a/usr/src/man/man5/ncad_addr.5 b/usr/src/man/man5/ncad_addr.5 deleted file mode 100644 index f7d356a886..0000000000 --- a/usr/src/man/man5/ncad_addr.5 +++ /dev/null @@ -1,76 +0,0 @@ -'\" te -.\" Copyright (C) 2003, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCAD_ADDR 5 "April 9, 2016" -.SH NAME -ncad_addr \- name of the Solaris Network Cache and Accelerator (NCA) socket -utility library -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/ncad_addr.so\fR -.fi - -.SH DESCRIPTION -.LP -\fBncad_addr.so\fR is the Solaris Network Cache and Accelerator (\fBNCA\fR) -socket utility library. Use this library with a web server to avoid support for -the \fBPF_NCA\fR family type socket. The web server can take advantage of NCA -functionality. -.sp -.LP -Interpose the \fBncad_addr\fR interfaces before the interfaces in -\fBlibsocket\fR by setting the environment variable \fBLD_PRELOAD\fR to -\fBncad_addr.so\fR so that it is preloaded before \fBlibsocket.so.1\fR. The -\fBncad_addr.so\fR interfaces will be interposed only if NCA is enabled. See -\fBncakmod\fR(1). -.SH EXAMPLES -.LP -\fBExample 1 \fRInterposing \fBncad_addr\fR -.sp -.LP -Using Bourne shell syntax as an example, set \fBLD_PRELOAD\fR as shown below to -interpose the \fBncad_addr\fR socket utility library: - -.sp -.in +2 -.nf -LD_PRELOAD=/usr/lib/ncad_addr.so /usr/bin/httpd -.fi -.in -2 - -.SH FILES -.ne 2 -.na -\fB\fB/usr/lib/ncad_addr.so\fR\fR -.ad -.RS 25n -\fBncad_addr\fR socket utility library shared object -.RE - -.SH ATTRIBUTES -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Unstable -.TE - -.SH SEE ALSO -.LP -\fBnca\fR(1), \fBncab2clf\fR(1), \fBncakmod\fR(1), \fBsocket\fR(3SOCKET), -\fBnca.if\fR(5), \fBncakmod.conf\fR(5), -.BR attributes (7) -.SH NOTES -.LP -Only applications that use the \fBNCA\fR feature, for example, web servers, -should interpose this library. diff --git a/usr/src/man/man5/ncakmod.conf.5 b/usr/src/man/man5/ncakmod.conf.5 deleted file mode 100644 index ab8f74af2c..0000000000 --- a/usr/src/man/man5/ncakmod.conf.5 +++ /dev/null @@ -1,110 +0,0 @@ -'\" te -.\" Copyright (C) 2001, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCAKMOD.CONF 5 "Sep 28, 2001" -.SH NAME -ncakmod.conf \- ncakmod configuration file -.SH SYNOPSIS -.LP -.nf -\fB/etc/nca/ncakmod.conf\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBncakmod.conf\fR file is used to configure the Solaris Network Cache and -Accelerator ("\fBNCA\fR") kernel module. The file contains two fields, -\fBkey\fR and \fBvalue\fR. -.sp -.LP -The \fBstatus\fR key is used to indicate if the user wants to have \fBNCA\fR -turned on as a feature. If the value of \fBstatus\fR key is \fBenabled\fR, -then the \fBNCA\fR kernel module will be pushed on to the specified interfaces. -If the value of the \fBstatus\fR key is \fBdisabled\fR, then the \fBNCA\fR -kernel module will not be pushed on to any interfaces . The default is -\fBdisabled\fR. -.sp -.LP -The \fBhttpd_door_path\fR key specifies the path name of the Solaris Door -\fBRPC\fR mechanism that will be used to communicate with the \fBhttp\fR -daemon. The default value is \fB/var/run/nca_httpd_1.door\fR. -.sp -.LP -Use the \fBnca_active\fR key to indicate whether to allow NCA to actively open -outgoing TCP connections. The default value for \fBnca_active\fR is -\fBdisabled\fR. If set to \fBenabled\fR, \fBncaconfd\fR sets up NCA for each -interface and then operates as a daemon, allowing NCA to make outgoing TCP -connections. This functionality is possible only by using the doors interface -to NCA. A web server that uses the sockets interface with \fBPF_NCA\fR or -\fBncad_addr.so\fR cannot connect by means of \fBnca_active\fR. -.sp -.LP -NCA supports the logging of in-kernel cache hits. See \fBncalogd.conf\fR(5). -NCA stores logs in a binary format. Use the \fBncab2clf\fR(1) utility to -convert the log from a binary format to the Common Log File format. -.sp -.LP -In order to implement changes to the \fBncakmod.conf\fR file, you will need to -reboot. -.SH EXAMPLES -.LP -\fBExample 1 \fRA Sample \fBncakmod.conf\fR File -.sp -.LP -The following is a sample \fBncakmod.conf\fR file: - -.sp -.in +2 -.nf -# -# NCA Kernel Module Configuration File -# -status=disabled -httpd_door_path=/var/run/nca_httpd_1.door -nca_active=disabled -.fi -.in -2 - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncakmod.conf\fR\fR -.ad -.RS 25n -The NCA kernel module configuration file. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -.BR nca (1), -.BR ncab2clf (1), -.BR ncakmod (1), -.BR door_create (3C), -.BR nca.if (5), -.BR ncad_addr (5), -.BR ncalogd.conf (5), -.BR attributes (7) -.sp -.LP -\fISystem Administration Guide: IP Services\fR diff --git a/usr/src/man/man5/ncalogd.conf.5 b/usr/src/man/man5/ncalogd.conf.5 deleted file mode 100644 index 8ef091eaa2..0000000000 --- a/usr/src/man/man5/ncalogd.conf.5 +++ /dev/null @@ -1,118 +0,0 @@ -'\" te -.\" Copyright (C) 2002, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCALOGD.CONF 5 "Jan 22, 2002" -.SH NAME -ncalogd.conf \- NCA logging configuration file -.SH SYNOPSIS -.LP -.nf -\fB/etc/nca/ncalogd.conf\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBncalogd.conf\fR is used to configure Solaris Network Cache and -Accelerator ("\fBNCA\fR") logging. The file contains two fields, \fBkey\fR and -\fBvalue\fR. -.sp -.LP -The \fBstatus\fR key is used to indicate if the user wants to have \fBNCA\fR -logging turned on. If the value of \fBstatus\fR key is \fBenabled\fR, then -\fBNCA\fR logging will be turned on. If the value of the \fBstatus\fR key is -\fBdisabled\fR, then \fBNCA\fR logging will not be invoked. The default value -is \fBdisabled\fR. -.sp -.LP -The \fBlogd_path_name\fR key specifies the absolute pathname of the log file. -The log file must be a raw device without a filesystem or a file on a local -file system. The default value is \fB/var/nca/log\fR. \fBlogd_path_name\fR can -also contain a whitespace-delimited list of values for multiple log files to a -maximum of 16. If you specify multiple log files, you must enclose the list in -quotation marks ("). With multiple files, \fBNCA\fR logging moves to the next -file on the list once the file size specified by \fBlogd_file_size\fR has been -reached. When the last file is full, \fBNCA\fR logging rotates back to the -first file in the list. A pointer to the current log file is stored in -\fB/var/nca/current\fR. -.sp -.LP -The \fBlogd_file_size\fR key specifies the value of the file size, in bytes, -allowed for each log file specified in by the \fBlogd_path_name\fR key. The -default value is 1000000 bytes. -.sp -.LP -In order to implement changes to the \fBncalogd.conf\fR file, you will need to -stop and start NCA logging or reboot. -.sp -.LP -NCA stores logs in a binary format. Use the \fBncab2clf\fR(1) utility to -convert the log from a binary format to the Common Log File format. -.SH EXAMPLES -.LP -\fBExample 1 \fRA Sample \fBncalogd.conf\fR File -.sp -.LP -The following is a sample \fBncalogd.conf\fR file that specifies three log -files: - -.sp -.in +2 -.nf -# -# NCA Log Daemon Configuration File -# - -status=enabled -logd_path_name="/var/nca/log1 /var/nca/log2 /var/nca/log3" -logd_file_size=1000000 -.fi -.in -2 - -.sp -.LP -Note that there is no NCA logging daemon. Logging is performed as one of the -functions of the NCA software. - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncalogd.conf\fR\fR -.ad -.RS 25n -Lists configuration parameters for \fBNCA\fRlogging. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -.BR nca (1), -.BR ncab2clf (1), -.BR ncakmod (1), -.BR door_create (3C), -.BR nca.if (5), -.BR ncakmod.conf (5), -.BR attributes (7), -.BR dd (8) -.sp -.LP -\fISystem Administration Guide: IP Services\fR diff --git a/usr/src/man/man5/ncaport.conf.5 b/usr/src/man/man5/ncaport.conf.5 deleted file mode 100644 index 7c3f50804e..0000000000 --- a/usr/src/man/man5/ncaport.conf.5 +++ /dev/null @@ -1,69 +0,0 @@ -'\" te -.\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCAPORT.CONF 5 "Jul 30, 2001" -.SH NAME -ncaport.conf \- ncaport configuration file -.SH SYNOPSIS -.LP -.nf -\fB/etc/nca/ncaport.conf\fR -.fi - -.SH DESCRIPTION -.LP -The \fBncaport.conf\fR 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 -\fBncaport=\fIipaddress\fR/\fIport\fR\fR. IPv4 addresses must be in the dot -notation \fId\fR.\fId\fR.\fId\fR.\fId\fR. IPv6 addresses must be in one of the -three conventional forms (see \fBinet_pton\fR(3C)). If an asterisk -(\fB*\fR) is used for an IP address, it is interpreted as \fBINADDR_ANY\fR, -which matches any IP address. -.sp -.LP -A web server uses the environment variable \fBLD_PRELOAD\fR and the -\fBncaport.conf\fR configuration file to convert an \fBAF_INET\fR socket to an -\fBAF_NCA\fR socket. \fBLD_PRELOAD\fR enables the NCA socket utility library to -be loaded before \fBlibsocket.so.1\fR. See the \fBncad_addr\fR(5) for details. -When a web server issues the \fBbind\fR(3SOCKET) system call, it is intercepted -by the interposition library \fBncad_addr.so\fR. If the bind address is in the -\fBncaport.conf\fR file, the \fBAF_INET\fR socket is converted to a -\fBAF_NCA\fR socket. -.SH EXAMPLES -.LP -\fBExample 1 \fRSample \fBncaport.conf\fR File -.sp -.LP -The following is a sample \fBncaport.conf\fR file: - -.sp -.in +2 -.nf -# -# NCA Kernel Module Port Configuration File -# -ncaport=1080:0:0:0:8:800:200C:417A/100 -ncaport=192.168.84.71/80 -ncaport=*/9000 -.fi -.in -2 -.sp - -.SH SEE ALSO -.LP -.BR nca (1), -.BR inet_pton (3C), -.BR bind (3SOCKET), -.BR ncad_addr (5), -.BR attributes (7) -.SH NOTES -.LP -For those web servers that use \fBAF_NCA\fR sockets, the NCA port configuration -described here has no effect. -.sp -.LP -NCA does not currently support IPv6. Any IPv6 addresses in the file -\fBncaport.conf\fR are ignored. diff --git a/usr/src/man/man8/Makefile b/usr/src/man/man8/Makefile index ab33d3c4c8..e978668679 100644 --- a/usr/src/man/man8/Makefile +++ b/usr/src/man/man8/Makefile @@ -19,7 +19,7 @@ # Copyright 2020 Joyent, Inc. # Copyright 2020 Peter Tribble # Copyright 2021 OmniOS Community Edition (OmniOSce) Association. -# Copryight 2022 Garrett D'Amore <garrett@damore.org> +# Copyright 2022 Garrett D'Amore # include $(SRC)/Makefile.master @@ -312,7 +312,6 @@ _MANFILES= 6to4relay.8 \ mpstat.8 \ msgid.8 \ mvdir.8 \ - ncaconfd.8 \ ncheck.8 \ ncheck_ufs.8 \ ndd.8 \ diff --git a/usr/src/man/man8/ncaconfd.8 b/usr/src/man/man8/ncaconfd.8 deleted file mode 100644 index bf2bdf6872..0000000000 --- a/usr/src/man/man8/ncaconfd.8 +++ /dev/null @@ -1,84 +0,0 @@ -'\" te -.\" Copyright (C) 2001, Sun Microsystems, Inc. -.\" All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NCACONFD 8 "Oct 12, 2004" -.SH NAME -ncaconfd \- Solaris Network Cache and Accelerator (NCA) configuration daemon -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/inet/ncaconfd\fR [\fB-al\fR ] \fIinterface1 \fR [\fIinterface2 ...\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -Use the \fBncaconfd\fR utility to set up NCA on a system. At boot time, the -\fBncakmod\fR initialization script reads in \fBnca.if\fR(5) to determine on -which interface(s) NCA should run. \fBncaconfd\fR then sets up the interface. -.sp -.LP -\fBncaconfd\fR also operates as a daemon if the \fBnca_active\fR key is set to -enabled in \fBncakmod.conf\fR(5) file. In this case, \fBncaconfd\fR will -continue as a daemon after all the NCA interfaces have been set up, listening -for routing changes. The changes are then passed to NCA to control which -interface NCA should use to make active outgoing TCP connnections. -.SH OPTIONS -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-a\fR\fR -.ad -.RS 6n -Enable active connections. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR\fR -.ad -.RS 6n -Enable logging. -.RE - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/nca/ncakmod.conf\fR\fR -.ad -.RS 25n - -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(7) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -.BR nca (1), -.BR ncakmod (1), -.BR nca.if (5), -.BR ncakmod.conf (5), -.BR attributes (7) |