From owner-freebsd-doc@FreeBSD.ORG Wed Mar 7 14:45:07 2012 Return-Path: Delivered-To: freebsd-docs@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 21D87106566C for ; Wed, 7 Mar 2012 14:45:07 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from glenbarber.us (onyx.glenbarber.us [199.48.134.227]) by mx1.freebsd.org (Postfix) with SMTP id D5B088FC16 for ; Wed, 7 Mar 2012 14:45:06 +0000 (UTC) Received: (qmail 84675 invoked by uid 0); 7 Mar 2012 09:27:30 -0500 Received: from unknown (HELO glenbarber.us) (75.146.225.65) by 0 with SMTP; 7 Mar 2012 09:27:30 -0500 Date: Wed, 7 Mar 2012 09:27:25 -0500 From: Glen Barber To: Maxim Konovalov Message-ID: <20120307142724.GA1842@glenbarber.us> References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) Cc: freebsd-docs@freebsd.org Subject: Re: LOCK_PROFILING.9 man page update X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 07 Mar 2012 14:45:07 -0000 Hi Maxim, On Wed, Mar 07, 2012 at 06:23:59PM +0400, Maxim Konovalov wrote: > Hello, > > I've just noticed that LOCK_PROFILING(9) is out of date. Below is a > diff that removes unexistent sysctls and adds a couple of new ones. > > I'll appreciate if someone reviews it (especially my English). > > Thanks, > > -- maxim > > Index: LOCK_PROFILING.9 > =================================================================== > --- LOCK_PROFILING.9 (revision 232650) > +++ LOCK_PROFILING.9 (working copy) > @@ -29,7 +29,7 @@ > .\" > .\" $FreeBSD$ > .\" > -.Dd November 11, 2006 > +.Dd March 7, 2012 > .Dt LOCK_PROFILING 9 > .Os > .Sh NAME > @@ -82,32 +82,6 @@ > This defaults to 0 (off). > .It Va debug.lock.prof.reset > Reset the current lock profiling buffers. > -.It Va debug.lock.prof.acquisitions > -The total number of lock acquisitions recorded. > -.It Va debug.lock.prof.records > -The total number of acquisition points recorded. > -Note that only active acquisition points (i.e., points that have been > -reached at least once) are counted. > -.It Va debug.lock.prof.maxrecords > -The maximum number of acquisition points the profiling code is capable > -of monitoring. > -Since it would not be possible to call > -.Xr malloc 9 > -from within the lock profiling code, this is a static limit. > -The number of records can be changed with the > -.Dv LPROF_BUFFERS > -kernel option. > -.It Va debug.lock.prof.rejected > -The number of acquisition points that were ignored after the table > -filled up. > -.It Va debug.lock.prof.hashsize > -The size of the hash table used to map acquisition points to > -statistics records. > -The hash size can be changed with the > -.Dv LPROF_HASH_SIZE > -kernel option. > -.It Va debug.lock.prof.collisions > -The number of hash collisions in the acquisition point hash table. > .It Va debug.lock.prof.stats > The actual profiling statistics in plain text. > The columns are as follows, from left to right: > @@ -138,6 +112,14 @@ > The name of the acquisition point, derived from the source file name > and line number, followed by the name of the lock in parentheses. > .El > +.It Va debug.lock.prof.rejected > +The number of acquisition points that were ignored after the table > +filled up. > +.It Va debug.lock.prof.skipspin > +Disable or enable the lock profiling code for the spin locks. > +This defaults to 0 (do profiling for the spin locks). > +.It Va debug.lock.prof.skipcount > +Do sampling approximately every N lock acquisitions. > .El > .Sh SEE ALSO > .Xr sysctl 8 , > %%% > Looks fine to me. Glen