d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

pmc_allocate(3): document the count argument

Browse Source 
This was added in b2ca2e50b9aa, and serves to provide an initial value
to the PMC, eliminating the need for a second syscall via pmc_set(3).

Reviewed by:	gnn, 0mp (manpages)
MFC after:	1 week
Sponsored by:	The FreeBSD Foundation
Differential Revision:	https://reviews.freebsd.org/D29885
This commit is contained in:
Mitchell Horne 2021-04-21 17:27:49 -03:00
parent 01d74fe1ff
commit 50f6c13997
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
lib/libpmc/pmc_allocate.3
View File

@ -23,7 +23,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd September 22, 2008 .Dd April 21, 2021
.Dt PMC_ALLOCATE 3 .Dt PMC_ALLOCATE 3
.Os .Os
.Sh NAME .Sh NAME
@ -41,6 +41,7 @@
.Fa "uint32_t flags" .Fa "uint32_t flags"
.Fa "int cpu" .Fa "int cpu"
.Fa "pmc_id_t *pmcid" .Fa "pmc_id_t *pmcid"
.Fa "uint64_t count"
.Fc .Fc
.Ft int .Ft int
.Fn pmc_release "pmc_id_t pmc" .Fn pmc_release "pmc_id_t pmc"
@ -111,6 +112,20 @@ Process scope PMC allocations should specify the constant
.Dv PMC_CPU_ANY .Dv PMC_CPU_ANY
for this argument. for this argument.
.Pp .Pp
The
.Fa count
argument behaves identically to the
.Xr pmc_set 3
function's
.Fa value
argument.
For counting PMCs,
.Fa count
specifies the initial value of the allocated PMC.
For sampling PMCs,
.Fa count
specifies the reload count.
.Pp
Function Function
.Fn pmc_release .Fn pmc_release
releases the PMC denoted by argument releases the PMC denoted by argument