summaryrefslogtreecommitdiff
path: root/share
diff options
context:
space:
mode:
authorJoseph Koshy <jkoshy@FreeBSD.org>2005-05-01 14:11:49 +0000
committerJoseph Koshy <jkoshy@FreeBSD.org>2005-05-01 14:11:49 +0000
commitc5153e190bd2410c60a50e108a7a60cde9a3c4bc (patch)
tree1e7573a97fa735d4770310305b9ec83d8767f4a7 /share
parentb60d26c9b930c7b267cd7f7b4b73d4b44d744124 (diff)
Notes
Diffstat (limited to 'share')
-rw-r--r--share/man/man4/hwpmc.421
1 files changed, 18 insertions, 3 deletions
diff --git a/share/man/man4/hwpmc.4 b/share/man/man4/hwpmc.4
index 4a6c8cf5a488..d2f7309da2a3 100644
--- a/share/man/man4/hwpmc.4
+++ b/share/man/man4/hwpmc.4
@@ -287,7 +287,10 @@ system call.
Retrieve the MSR (machine specific register) number associated with
the given PMC handle.
.Pp
-This operation is only valid for PMCs allocated in process-private modes.
+The PMC needs to be in process-private mode and allocated without the
+.Va PMC_F_DESCENDANTS
+modifier flag, and should be attached only to its owner process at the
+time of the call.
.El
.Ss amd64 SPECIFIC API
AMD64 cpus support the RDPMC instruction which allows a
@@ -303,7 +306,10 @@ system call.
Retrieve the MSR (machine specific register) number associated with
the given PMC handle.
.Pp
-This operation is only valid for PMCs allocated in process-private modes.
+The PMC needs to be in process-private mode and allocated without the
+.Va PMC_F_DESCENDANTS
+modifier flag, and should be attached only to its owner process at the
+time of the call.
.El
.Sh SYSCTL TUNABLES
The behavior of
@@ -515,7 +521,10 @@ request contained illegal flags.
.It Bq Er EINVAL
A
.Ic PMC_OP_PMCX86GETMSR
-operation was requested for a PMC not in process-virtual mode.
+operation was requested for a PMC not in process-virtual mode, or
+for a PMC that is not solely attached to its owner process, or for
+a PMC that was allocated with flag
+.Va PMC_F_DESCENDANTS .
.It Bq Er EINVAL
(On Intel Pentium 4 CPUs with HTT support) An allocation request for
a process-private PMC was issued for an event that does not support
@@ -551,6 +560,12 @@ An
.Ic PMC_OP_PMCATTACH
operation was issued for a target process that the current process
does not have permission to attach to.
+.It Bq Er EPERM
+.Pq "i386 and amd64 architectures"
+An
+.Ic PMC_OP_PMCATTACH
+operation was issued on a PMC whose MSR has been retrieved using
+.Ic PMC_OP_PMCX86GETMSR .
.It Bq Er ESRCH
A process issued a PMC operation request without having allocated any PMCs.
.It Bq Er ESRCH