Changeset View
Changeset View
Standalone View
Standalone View
share/man/man4/hwpmc.4
Show All 22 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd November 2, 2012 | .Dd Apryl 3, 2021 | ||||
.Dt HWPMC 4 | .Dt HWPMC 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm hwpmc | .Nm hwpmc | ||||
.Nd "Hardware Performance Monitoring Counter support" | .Nd "Hardware Performance Monitoring Counter support" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Cd "options HWPMC_HOOKS" | .Cd "options HWPMC_HOOKS" | ||||
.Cd "device hwpmc" | .Cd "device hwpmc" | ||||
▲ Show 20 Lines • Show All 153 Lines • ▼ Show 20 Lines | |||||
by the | by the | ||||
.Va "kern.hwpmc.callchaindepth" | .Va "kern.hwpmc.callchaindepth" | ||||
kernel tunable. | kernel tunable. | ||||
.It Dv PMC_F_DESCENDANTS | .It Dv PMC_F_DESCENDANTS | ||||
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. | ||||
It signifies that the PMC will track hardware events for its | It signifies that the PMC will track hardware events for its | ||||
target process and the target's current and future descendants. | target process and the target's current and future descendants. | ||||
.It Dv PMC_F_KGMON | |||||
This modifier is valid only for a PMC being allocated in system-wide | |||||
sampling mode. | |||||
It signifies that the PMC's sampling interrupt is to be used to drive | |||||
kernel profiling via | |||||
.Xr kgmon 8 . | |||||
This functionality is currently unimplemented. | |||||
.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 context switch, | When this modifier is present, at every context switch, | ||||
.Nm | .Nm | ||||
will log a record containing the number of hardware events | will log a record containing the number of hardware events | ||||
seen by the target process when it was scheduled on the CPU. | seen by the target process when it was scheduled on the CPU. | ||||
.It Dv PMC_F_LOG_PROCEXIT | .It Dv PMC_F_LOG_PROCEXIT | ||||
▲ Show 20 Lines • Show All 543 Lines • ▼ Show 20 Lines | |||||
.Dv PMC_OP_PMCDETACH | .Dv PMC_OP_PMCDETACH | ||||
operation is not being monitored by | operation is not being monitored by | ||||
.Nm . | .Nm . | ||||
.El | .El | ||||
.Sh SEE ALSO | .Sh SEE ALSO | ||||
.Xr kenv 1 , | .Xr kenv 1 , | ||||
.Xr pmc 3 , | .Xr pmc 3 , | ||||
.Xr pmclog 3 , | .Xr pmclog 3 , | ||||
.Xr kgmon 8 , | |||||
.Xr kldload 8 , | .Xr kldload 8 , | ||||
.Xr pmccontrol 8 , | .Xr pmccontrol 8 , | ||||
.Xr pmcstat 8 , | .Xr pmcstat 8 , | ||||
.Xr sysctl 8 , | .Xr sysctl 8 , | ||||
.Xr kproc_create 9 , | .Xr kproc_create 9 , | ||||
.Xr p_candebug 9 | .Xr p_candebug 9 | ||||
.Sh HISTORY | .Sh HISTORY | ||||
The | The | ||||
▲ Show 20 Lines • Show All 57 Lines • Show Last 20 Lines |