From owner-freebsd-doc@FreeBSD.ORG Wed Mar 7 14:24:01 2012 Return-Path: Delivered-To: docs@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BFA69106566C for ; Wed, 7 Mar 2012 14:24:01 +0000 (UTC) (envelope-from maxim.konovalov@gmail.com) Received: from mp2.macomnet.net (ipv6.irc.int.ru [IPv6:2a02:28:1:2::1b:2]) by mx1.freebsd.org (Postfix) with ESMTP id 303198FC0C for ; Wed, 7 Mar 2012 14:24:00 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by mp2.macomnet.net (8.14.5/8.14.5) with ESMTP id q27ENxtM036476 for ; Wed, 7 Mar 2012 18:23:59 +0400 (MSK) (envelope-from maxim.konovalov@gmail.com) Date: Wed, 7 Mar 2012 18:23:59 +0400 (MSK) From: Maxim Konovalov To: docs@freebsd.org Message-ID: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Cc: Subject: 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:24:01 -0000 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 , %%% -- Maxim Konovalov