From owner-svn-src-all@FreeBSD.ORG Tue Jul 22 22:16:24 2014 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id CF31B671; Tue, 22 Jul 2014 22:16:24 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id B08502D1D; Tue, 22 Jul 2014 22:16:24 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s6MMGOY8036780; Tue, 22 Jul 2014 22:16:24 GMT (envelope-from pluknet@svn.freebsd.org) Received: (from pluknet@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s6MMGOVA036774; Tue, 22 Jul 2014 22:16:24 GMT (envelope-from pluknet@svn.freebsd.org) Message-Id: <201407222216.s6MMGOVA036774@svn.freebsd.org> From: Sergey Kandaurov Date: Tue, 22 Jul 2014 22:16:24 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r268995 - in head: . share/man/man9 X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 22 Jul 2014 22:16:24 -0000 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@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.