svn commit: r268995 - in head: . share/man/man9

Tue Jul 22 22:16:24 UTC 2014

Author: pluknet
Date: Tue Jul 22 22:16:23 2014
New Revision: 268995
URL: http://svnweb.freebsd.org/changeset/base/268995

Log:
  s/PCBGROUPS/PCBGROUP/ manpage to match "options PCBGROUP".

Added:
  head/share/man/man9/PCBGROUP.9
     - copied, changed from r268994, head/share/man/man9/PCBGROUPS.9
Deleted:
  head/share/man/man9/PCBGROUPS.9
Modified:
  head/ObsoleteFiles.inc
  head/share/man/man9/Makefile

Modified: head/ObsoleteFiles.inc
==============================================================================

--- head/ObsoleteFiles.inc	Tue Jul 22 20:49:58 2014	(r268994)
+++ head/ObsoleteFiles.inc	Tue Jul 22 22:16:23 2014	(r268995)
@@ -38,6 +38,8 @@
 #   xargs -n1 | sort | uniq -d;
 # done
 
+# 20140723: renamed to PCBGROUP.9
+OLD_FILES+=usr/share/man/man9/PCBGROUPS.9.gz
 # 20140719: libsbuf version bump
 OLD_LIBS+=lib/libsbuf.so.6
 # 20140718: Remove obsolete man pages

Modified: head/share/man/man9/Makefile
==============================================================================
--- head/share/man/man9/Makefile	Tue Jul 22 20:49:58 2014	(r268994)
+++ head/share/man/man9/Makefile	Tue Jul 22 22:16:23 2014	(r268995)
@@ -188,7 +188,7 @@ MAN=	accept_filter.9 \
 	osd.9 \
 	panic.9 \
 	pbuf.9 \
-	PCBGROUPS.9 \
+	PCBGROUP.9 \
 	p_candebug.9 \
 	p_cansee.9 \
 	pci.9 \

Copied and modified: head/share/man/man9/PCBGROUP.9 (from r268994, head/share/man/man9/PCBGROUPS.9)
==============================================================================
--- head/share/man/man9/PCBGROUPS.9	Tue Jul 22 20:49:58 2014	(r268994, copy source)
+++ head/share/man/man9/PCBGROUP.9	Tue Jul 22 22:16:23 2014	(r268995)
@@ -27,10 +27,10 @@
 .\" $FreeBSD$
 .\"
 .Dd July 18, 2014
-.Dt PCBGROUPS 9
+.Dt PCBGROUP 9
 .Os
 .Sh NAME
-.Nm PCBGROUPS
+.Nm PCBGROUP
 .Nd Distributed Protocol Control Block Groups
 .Sh SYNOPSIS
 .Ft void
@@ -58,16 +58,16 @@
 .Fa "struct inpcbinfo *pcbinfo" "u_int hashtype" "uint32_t hash"
 .Fc
 .Pp
-.Cd "options PCBGROUPS"
+.Cd "options PCBGROUP"
 .Sh DESCRIPTION
-PCBGROUPS, or "connection groups", are based on Willman, Rixner, and Cox's
+PCBGROUP, or "connection groups", are based on Willman, Rixner, and Cox's
 2006 USENIX paper,
 .Qo
 An Evaluation of Network Stack Parallelization Strategies in Modern
 Operating Systems
 .Qc .
 .Pp
-The PCBGROUPS paper describes two main kind of connection groups.
+The PCBGROUP paper describes two main kind of connection groups.
 The first, called ConnP-T, uses a pool of worker threads which
 implement the network stack.
 Serialization occurs when queuing work into and completing work from
@@ -102,7 +102,7 @@ Connection establishment and teardown ca
 expensive than without connection groups, but that steady-state
 processing can be significantly faster.
 .Pp
-Enabling PCBGROUPS in the kernel only provides the infrastructure
+Enabling PCBGROUP in the kernel only provides the infrastructure
 required to create and manage multiple PCB groups.
 An implementation needs to fill in a few functions to provide PCB
 group hash information in order for PCBs to be placed in a PCB group.
@@ -133,9 +133,9 @@ wildcard table.
 The PCBGROUP tables operate in conjunction with the normal single PCB list
 in a PCB info block.
 Thus, inserting and removing a PCB will still incur the same costs
-as without PCBGROUPS.
-A protocol which uses PCBGROUPS should fall back to the normal PCB list
-lookup if a call to the PCBGROUPS layer does not yield a lookup hit.
+as without PCBGROUP.
+A protocol which uses PCBGROUP should fall back to the normal PCB list
+lookup if a call to the PCBGROUP layer does not yield a lookup hit.
 .Ss Usage
 Initialize a PCBGROUP in a PCB info block
 .Pq Vt "struct pcbinfo"
@@ -165,7 +165,7 @@ The PCB code in
 .Pa sys/netinet
 and
 .Pa sys/netinet6
-is aware of PCBGROUPS and will call into the PCBGROUPS code to do
+is aware of PCBGROUP and will call into the PCBGROUP code to do
 PCBGROUP assignment and lookup, preferring a PCBGROUP lookup to the
 default global PCB info table.
 .Pp
@@ -201,10 +201,10 @@ receive path in
 .Xr netisr 9 ,
 .Xr RSS 9
 .Sh HISTORY
-PCBGROUPS first appeared in
+PCBGROUP first appeared in
 .Fx 9.0 .
 .Pp
-The PCBGROUPS implementation is inspired by Willman, Rixner, and Cox's
+The PCBGROUP implementation is inspired by Willman, Rixner, and Cox's
 2006 USENIX paper,
 .Qo
 An Evaluation of Network Stack Parallelization Strategies in Modern
@@ -213,7 +213,7 @@ Operating Systems
 .Li http://www.ece.rice.edu/~willmann/pubs/paranet_usenix.pdf
 .Sh AUTHORS
 .An -nosplit
-The PCBGROUPS implementation was written by
+The PCBGROUP implementation was written by
 .An Robert N. M. Watson Aq Mt rwatson at FreeBSD.org
 under contract to Juniper Networks, Inc.
 .Pp
@@ -224,12 +224,12 @@ The
 .Xr RSS 9
 implementation currently uses
 .Ic #ifdef
-blocks to tie into PCBGROUPS.
+blocks to tie into PCBGROUP.
 This is a sign that a more abstract programming API is needed.
 .Pp
-There is currently no support for re-balancing the PCBGROUPS assignment,
+There is currently no support for re-balancing the PCBGROUP assignment,
 nor is there any support for overriding which PCBGROUP a socket/PCB
 should be in.
 .Pp
-No statistics are kept to indicate how often PCBGROUPS lookups
+No statistics are kept to indicate how often PCBGROUP lookups
 succeed or fail.
