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

Document the need for a log file to be configured before a PMC

Browse Source 
configured with logging options can be started.
This commit is contained in:
Joseph Koshy 2005-06-09 20:55:05 +00:00
parent 98b60f9da3
commit 3bc6c67462
1 changed files with 17 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
share/man/man4/hwpmc.4
View File

@ -201,10 +201,10 @@ kernel profiling via
.It Dv PMC_F_LOG_PROCCSW .It Dv PMC_F_LOG_PROCCSW
This modifier is valid only for a PMC being allocated in process-private This modifier is valid only for a PMC being allocated in process-private
mode. mode.
When this modifier is present, at every process context switch time, When this modifier is present, at every context switch,
.Nm .Nm
will append a record containing the count of the hardware events will log a record containing the number of hardware events
seen by the process to the configured log file. seen by the target process when it was scheduled on the CPU.
.It Dv PMC_F_LOG_PROCEXIT .It Dv PMC_F_LOG_PROCEXIT
This modifier is valid only for a PMC being allocated in process-private This modifier is valid only for a PMC being allocated in process-private
mode. mode.
@ -223,6 +223,11 @@ and
may be used in combination with modifier may be used in combination with modifier
.Dv PMC_F_DESCENDANTS .Dv PMC_F_DESCENDANTS
to track the behaviour of complex pipelines of processes. to track the behaviour of complex pipelines of processes.
PMCs with modifiers
.Dv PMC_F_LOG_PROCEXIT
and
.Dv PMC_F_LOG_PROCCSW
cannot be started until their owner process has configured a log file.
.Ss SIGNALS .Ss SIGNALS
The The
.Nm .Nm
@ -524,6 +529,15 @@ PMC using the same hardware resources attached to it.
An An
.Ic PMC_OP_PMCRW .Ic PMC_OP_PMCRW
request writing a new value was issued on a PMC that was active. request writing a new value was issued on a PMC that was active.
.It Bq Er EDOOFUS
A
.Ic PMC_OP_PMCSTART
operation was requested without a log file being configured for a
PMC allocated with
.Dv PMC_F_LOG_PROCCSW
and
.Dv PMC_F_LOG_PROCEXIT
modifiers.
.It Bq Er EBUSY .It Bq Er EBUSY
An An
.Ic PMC_OP_PMCSETCOUNT .Ic PMC_OP_PMCSETCOUNT