From owner-svn-src-all@FreeBSD.ORG Mon Nov 24 08:11:33 2008 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 792DB1065672; Mon, 24 Nov 2008 08:11:33 +0000 (UTC) (envelope-from jkoshy@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 648F78FC08; Mon, 24 Nov 2008 08:11:33 +0000 (UTC) (envelope-from jkoshy@FreeBSD.org) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id mAO8BXrO078935; Mon, 24 Nov 2008 08:11:33 GMT (envelope-from jkoshy@svn.freebsd.org) Received: (from jkoshy@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id mAO8BXG6078934; Mon, 24 Nov 2008 08:11:33 GMT (envelope-from jkoshy@svn.freebsd.org) Message-Id: <200811240811.mAO8BXG6078934@svn.freebsd.org> From: Joseph Koshy Date: Mon, 24 Nov 2008 08:11:33 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r185246 - head/lib/libpmc X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 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: Mon, 24 Nov 2008 08:11:33 -0000 Author: jkoshy Date: Mon Nov 24 08:11:33 2008 New Revision: 185246 URL: http://svn.freebsd.org/changeset/base/185246 Log: - Document the rules used to determine when spellings of events are equivalent. - Reorder text to make the manual page more coherent. Modified: head/lib/libpmc/pmc.3 Modified: head/lib/libpmc/pmc.3 ============================================================================== --- head/lib/libpmc/pmc.3 Mon Nov 24 06:47:27 2008 (r185245) +++ head/lib/libpmc/pmc.3 Mon Nov 24 08:11:33 2008 (r185246) @@ -23,7 +23,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 16, 2008 +.Dd November 24, 2008 .Os .Dt PMC 3 .Sh NAME @@ -446,6 +446,29 @@ optional parameters modifying the semant being probed. Event names are PMC architecture dependent, but the PMC library defines machine independent aliases for commonly used events. +.Pp +Event specifiers spellings are case-insensitive and space characters, +periods, underscores and hyphens are considered equivalent to each other. +Thus the event specifiers +.Qq "Example Event" , +.Qq "example-event" , +and +.Qq "EXAMPLE_EVENT" +are equivalent. +.Ss PMC Architecture Dependent Events +PMC architecture dependent event specifiers are described in the +following manual pages: +.Bl -column " PMC_CLASS_TSC " "MANUAL PAGE " +.It Em "PMC Class" Ta Em "Manual Page" +.It Li PMC_CLASS_IAF Ta Xr pmc.iaf 3 +.It Li PMC_CLASS_IAP Ta Xr pmc.atom 3 , Xr pmc.core 3 , Xr pmc.core2 3 +.It Li PMC_CLASS_K7 Ta Xr pmc.k7 3 +.It Li PMC_CLASS_K8 Ta Xr pmc.k8 3 +.It Li PMC_CLASS_P4 Ta Xr pmc.p4 3 +.It Li PMC_CLASS_P5 Ta Xr pmc.p5 3 +.It Li PMC_CLASS_P6 Ta Xr pmc.p6 3 +.It Li PMC_CLASS_TSC Ta Xr pmc.tsc 3 +.El .Ss Event Name Aliases Event name aliases are PMC-independent names for commonly used events. The following aliases are known to this version of the @@ -472,21 +495,6 @@ Measure the number of interrupts seen. Measure the number of cycles the processor is not in a halted or sleep state. .El -.Pp -.Ss PMC Architecture Dependent Events -PMC architecture dependent event specifiers are described in the -following manual pages: -.Bl -column " PMC_CLASS_TSC " "MANUAL PAGE " -.It Em "PMC Class" Ta Em "Manual Page" -.It Li PMC_CLASS_IAF Ta Xr pmc.iaf 3 -.It Li PMC_CLASS_IAP Ta Xr pmc.atom 3 , Xr pmc.core 3 , Xr pmc.core2 3 -.It Li PMC_CLASS_K7 Ta Xr pmc.k7 3 -.It Li PMC_CLASS_K8 Ta Xr pmc.k8 3 -.It Li PMC_CLASS_P4 Ta Xr pmc.p4 3 -.It Li PMC_CLASS_P5 Ta Xr pmc.p5 3 -.It Li PMC_CLASS_P6 Ta Xr pmc.p6 3 -.It Li PMC_CLASS_TSC Ta Xr pmc.tsc 3 -.El .Sh COMPATIBILITY The interface between the .Nm pmc