Page MenuHomeFreeBSD

pmc, pmcstat: document PMU event grouping
Needs ReviewPublic

Authored by afscoelho_gmail.com on Sep 3 2026, 9:32 PM.
Referenced Files
Unknown Object (File)
Sun, Oct 4, 12:55 AM
Unknown Object (File)
Sun, Oct 4, 12:49 AM
Unknown Object (File)
Sat, Oct 3, 5:19 AM
Unknown Object (File)
Sat, Oct 3, 1:43 AM
Unknown Object (File)
Fri, Oct 2, 9:54 PM
Unknown Object (File)
Fri, Oct 2, 7:58 AM
Unknown Object (File)
Fri, Oct 2, 6:54 AM
Unknown Object (File)
Thu, Oct 1, 6:48 AM
Subscribers

Details

Summary

Document the group API in pmc(3): pmc_allocate_group, pmc_group_create,
pmc_group_add, pmc_group_commit, pmc_group_read, and pmc_read_pair.
Explain what a group guarantees, when a commit fails with ENOSPC, and
how to scale a multiplexed count from the enabled and running times.

Document the -b flag and the brace-list syntax in pmcstat(8), including
how a modifier inside the list differs from one after it, and what the
residency column means.

Document the PMCGROUPINHERITMISS record in pmclog(3).

Sponsored by: AMD

Signed-off-by: Andre Silva <andasilv@amd.com>

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 76459
Build 73342: arc lint + arc unit

Event Timeline

Rebase on main (D60141 and D60185 are committed). No change.