From owner-svn-src-all@FreeBSD.ORG Wed Jul 23 18:54:19 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 6BA58550; Wed, 23 Jul 2014 18:54:19 +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 4C8A12DCC; Wed, 23 Jul 2014 18:54:19 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s6NIsJuF015610; Wed, 23 Jul 2014 18:54:19 GMT (envelope-from pluknet@svn.freebsd.org) Received: (from pluknet@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s6NIsJfp015609; Wed, 23 Jul 2014 18:54:19 GMT (envelope-from pluknet@svn.freebsd.org) Message-Id: <201407231854.s6NIsJfp015609@svn.freebsd.org> From: Sergey Kandaurov Date: Wed, 23 Jul 2014 18:54:19 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r269022 - 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: Wed, 23 Jul 2014 18:54:19 -0000 Author: pluknet Date: Wed Jul 23 18:54:18 2014 New Revision: 269022 URL: http://svnweb.freebsd.org/changeset/base/269022 Log: - Use Rs/Re mdoc macros. - Remove duplicate and/or redundant content. Modified: head/share/man/man9/PCBGROUP.9 Modified: head/share/man/man9/PCBGROUP.9 ============================================================================== --- head/share/man/man9/PCBGROUP.9 Wed Jul 23 18:05:39 2014 (r269021) +++ head/share/man/man9/PCBGROUP.9 Wed Jul 23 18:54:18 2014 (r269022) @@ -64,28 +64,9 @@ .Fa "struct inpcbinfo *pcbinfo" "u_int hashtype" "uint32_t hash" .Fc .Sh DESCRIPTION -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 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 -the network stack. -No locking is required inside each worker thread. -.Pp -The second type of connection group, called ConnP-L, uses an array -of PCB groups rather than a single list. -Each PCB group is protected by its own lock. -.Pp -This implementation differs significantly from that described in the -paper, in that it attempts to introduce not just notions of affinity +This implementation introduces notions of affinity for connections and distribute work so as to reduce lock contention, -but also align those notions with hardware work distribution strategies +with hardware work distribution strategies such as RSS. In this construction, connection groups supplement, rather than replace, existing reservation tables for protocol 4-tuples, offering CPU-affine @@ -99,7 +80,7 @@ This indicates to the connection group c a particular group. This must be aligned with any hardware-offloaded distribution model, such as RSS or similar approaches taken in embedded network boards. -Wildcard sockets require special handling, as in Willman 2006, and +Wildcard sockets require special handling, as in Willmann 2006, and are shared between connection groups while being protected by group-local locks. Connection establishment and teardown can be signficantly more @@ -204,17 +185,18 @@ receive path in .Xr mbuf 9 , .Xr netisr 9 , .Xr RSS 9 +.Rs +.%A Paul Willmann +.%A Scott Rixner +.%A Alan L. Cox +.%T "An Evaluation of Network Stack Parallelization Strategies in Modern Operating Systems" +.%J "2006 USENIX Annual Technical Conference" +.%D 2006 +.%U http://www.ece.rice.edu/~willmann/pubs/paranet_usenix.pdf +.Re .Sh HISTORY PCBGROUP first appeared in .Fx 9.0 . -.Pp -The PCBGROUP implementation is inspired by Willman, Rixner, and Cox's -2006 USENIX paper, -.Qo -An Evaluation of Network Stack Parallelization Strategies in Modern -Operating Systems -.Qc : -.Li http://www.ece.rice.edu/~willmann/pubs/paranet_usenix.pdf .Sh AUTHORS .An -nosplit The PCBGROUP implementation was written by