home | help
PMC.SOFT(3)		     Library Functions Manual		     PMC.SOFT(3)

NAME
     pmc.soft -- measurements using software based events

LIBRARY
     Performance Counters Library (libpmc, -lpmc)

SYNOPSIS
     #include <pmc.h>

DESCRIPTION
     Software events are used to collect various source of software events.

   PMC Features
     16 sampling counters using software events based on various sources.  These
     PMCs support the following capabilities:

     Capability 	  Support
     PMC_CAP_CASCADE	  No
     PMC_CAP_EDGE	  No
     PMC_CAP_INTERRUPT	  Yes
     PMC_CAP_INVERT	  No
     PMC_CAP_READ	  Yes
     PMC_CAP_PRECISE	  No
     PMC_CAP_SYSTEM	  Yes
     PMC_CAP_TAGGING	  No
     PMC_CAP_THRESHOLD	  No
     PMC_CAP_USER	  Yes
     PMC_CAP_WRITE	  Yes

   Event Qualifiers
     There is no supported event qualifier.

     The event specifiers supported by software are:

     CLOCK.HARD
	     Hard clock ticks.

     CLOCK.STAT
	     Stat clock ticks.

     CLOCK.PROF
	     Profiling clock ticks.

     INTR.ALL
	     Interrupt filter executed

     INTR.FILTER
	     Interrupt filter returned FILTER_HANDLED.

     INTR.ITHREAD
	     Interrupt filter returned FILTER_SCHEDULE_ITHREAD.

     INTR.SCHEDULE
	     Ithread scheduled.

     INTR.STRAY
	     Interrupt filter returned FILTER_STRAY.

     INTR.WAITING
	     Ithread not scheduled, already active.

     LOCK.FAILED
	     Lock acquisition failed.

     PAGE_FAULT.ALL
	     All page fault type.

     PAGE_FAULT.READ
	     Read page fault.

     PAGE_FAULT.WRITE
	     Write page fault.

SEE ALSO
     pmc(3),	 pmc.amd(3),	 pmc.atom(3),	  pmc.core(3),	  pmc.corei7(3),
     pmc.corei7uc(3),  pmc.iaf(3),  pmc.tsc(3),  pmc.ucf(3),  pmc.westmereuc(3),
     pmc_cpuinfo(3), pmclog(3), hwpmc(4)

HISTORY
     The pmc library first appeared in FreeBSD 6.0.

AUTHORS
     The  Performance  Counters  Library  (libpmc, -lpmc) library was written by
     Joseph Koshy <jkoshy@FreeBSD.org>.  Software  PMC	was  written  by  Fabien
     Thomas <fabient@FreeBSD.org>.

FreeBSD 15.1		       September 23, 2021		     PMC.SOFT(3)

home | help