PMC.SOFT(3)            FreeBSD 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-STABLE-HBSD      September 23, 2021                   PMC.SOFT(3)