| pmcstat.8 (151433) | pmcstat.8 (157144) |
|---|---|
| 1.\" Copyright (c) 2003 Joseph Koshy. All rights reserved. | 1.\" Copyright (c) 2003-2006 Joseph Koshy. All rights reserved. |
| 2.\" 3.\" Redistribution and use in source and binary forms, with or without 4.\" modification, are permitted provided that the following conditions 5.\" are met: 6.\" 1. Redistributions of source code must retain the above copyright 7.\" notice, this list of conditions and the following disclaimer. 8.\" 2. Redistributions in binary form must reproduce the above copyright 9.\" notice, this list of conditions and the following disclaimer in the --- 6 unchanged lines hidden (view full) --- 16.\" for any direct, indirect, incidental, special, exemplary, or consequential 17.\" damages (including, but not limited to, procurement of substitute goods 18.\" or services; loss of use, data, or profits; or business interruption) 19.\" however caused and on any theory of liability, whether in contract, strict 20.\" liability, or tort (including negligence or otherwise) arising in any way 21.\" out of the use of this software, even if advised of the possibility of 22.\" such damage. 23.\" | 2.\" 3.\" Redistribution and use in source and binary forms, with or without 4.\" modification, are permitted provided that the following conditions 5.\" are met: 6.\" 1. Redistributions of source code must retain the above copyright 7.\" notice, this list of conditions and the following disclaimer. 8.\" 2. Redistributions in binary form must reproduce the above copyright 9.\" notice, this list of conditions and the following disclaimer in the --- 6 unchanged lines hidden (view full) --- 16.\" for any direct, indirect, incidental, special, exemplary, or consequential 17.\" damages (including, but not limited to, procurement of substitute goods 18.\" or services; loss of use, data, or profits; or business interruption) 19.\" however caused and on any theory of liability, whether in contract, strict 20.\" liability, or tort (including negligence or otherwise) arising in any way 21.\" out of the use of this software, even if advised of the possibility of 22.\" such damage. 23.\" |
| 24.\" $FreeBSD: head/usr.sbin/pmcstat/pmcstat.8 151433 2005-10-18 04:40:11Z jkoshy $ | 24.\" $FreeBSD: head/usr.sbin/pmcstat/pmcstat.8 157144 2006-03-26 12:20:54Z jkoshy $ |
| 25.\" | 25.\" |
| 26.Dd July 1, 2005 | 26.Dd March 26, 2006 |
| 27.Os 28.Dt PMCSTAT 8 29.Sh NAME 30.Nm pmcstat 31.Nd "performance measurement with performance monitoring hardware" 32.Sh SYNOPSIS 33.Nm 34.Op Fl C 35.Op Fl D Ar pathname 36.Op Fl E | 27.Os 28.Dt PMCSTAT 8 29.Sh NAME 30.Nm pmcstat 31.Nd "performance measurement with performance monitoring hardware" 32.Sh SYNOPSIS 33.Nm 34.Op Fl C 35.Op Fl D Ar pathname 36.Op Fl E |
| 37.Op Fl M Ar mapfilename |
|
| 37.Op Fl O Ar logfilename 38.Op Fl P Ar event-spec 39.Op Fl R Ar logfilename 40.Op Fl S Ar event-spec 41.Op Fl W 42.Op Fl c Ar cpu 43.Op Fl d 44.Op Fl g | 38.Op Fl O Ar logfilename 39.Op Fl P Ar event-spec 40.Op Fl R Ar logfilename 41.Op Fl S Ar event-spec 42.Op Fl W 43.Op Fl c Ar cpu 44.Op Fl d 45.Op Fl g |
| 45.Op Fl k Ar kernelfile | 46.Op Fl k Ar kerneldir |
| 46.Op Fl n Ar rate 47.Op Fl o Ar outputfile 48.Op Fl p Ar event-spec | 47.Op Fl n Ar rate 48.Op Fl o Ar outputfile 49.Op Fl p Ar event-spec |
| 50.Op Fl q 51.Op Fl r Ar fsroot |
|
| 49.Op Fl s Ar event-spec 50.Op Fl t Ar pid | 52.Op Fl s Ar event-spec 53.Op Fl t Ar pid |
| 54.Op Fl v |
|
| 51.Op Fl w Ar secs 52.Op Ar command Op Ar args 53.Sh DESCRIPTION 54The 55.Nm 56utility measures system performance using the facilities provided by 57.Xr hwpmc 4 . 58.Pp --- 52 unchanged lines hidden (view full) --- 111.It Fl E 112Toggle showing per-process counts at the time a tracked process 113exits for subsequent process-mode PMCs specified on the command line. 114This option is useful for mapping the performance characteristics of a 115complex pipeline of processes when used in conjunction with the 116.Fl d 117option. 118The default is to not to enable per-process tracking. | 55.Op Fl w Ar secs 56.Op Ar command Op Ar args 57.Sh DESCRIPTION 58The 59.Nm 60utility measures system performance using the facilities provided by 61.Xr hwpmc 4 . 62.Pp --- 52 unchanged lines hidden (view full) --- 115.It Fl E 116Toggle showing per-process counts at the time a tracked process 117exits for subsequent process-mode PMCs specified on the command line. 118This option is useful for mapping the performance characteristics of a 119complex pipeline of processes when used in conjunction with the 120.Fl d 121option. 122The default is to not to enable per-process tracking. |
| 123.It Fl M Ar mapfilename 124Write the mapping between executable objects encountered in the event 125log and the abbreviated pathnames used for 126.Xr gprof 1 127profiles to file 128.Ar mapfilename . 129If this option is not specified, mapping information is not written. 130Argument 131.Ar mapfilename 132may be a 133.Dq Li - 134in which case this mapping information is sent to the output 135file configured by the 136.Fl o 137option. |
|
| 119.It Fl O Ar logfilename 120Send logging output to file 121.Ar logfilename . 122If this option is not specified and one of the logging options 123is requested, then 124.Nm 125will print a textual form of the logged events to the configured 126output file. --- 27 unchanged lines hidden (view full) --- 154The default is to measure events for the target process alone. 155.It Fl g 156Produce flat execution profiles in a format compatible with 157.Xr gprof 1 . 158A separate profile file is generated for each executable object 159encountered. 160Profile files are placed in sub-directories named by their PMC 161event name. | 138.It Fl O Ar logfilename 139Send logging output to file 140.Ar logfilename . 141If this option is not specified and one of the logging options 142is requested, then 143.Nm 144will print a textual form of the logged events to the configured 145output file. --- 27 unchanged lines hidden (view full) --- 173The default is to measure events for the target process alone. 174.It Fl g 175Produce flat execution profiles in a format compatible with 176.Xr gprof 1 . 177A separate profile file is generated for each executable object 178encountered. 179Profile files are placed in sub-directories named by their PMC 180event name. |
| 162.It Fl k Ar kernelfile 163Set the pathname of the kernel to argument 164.Ar kernelfile . | 181.It Fl k Ar kerneldir 182Set the pathname of the kernel directory to argument 183.Ar kerneldir . 184This directory specifies where 185.Nm 186should look for the kernel and its modules. |
| 165The default is | 187The default is |
| 166.Pa /boot/kernel/kernel . | 188.Pa /boot/kernel . |
| 167.It Fl n Ar rate 168Set the default sampling rate for subsequent sampling mode 169PMCs specified on the command line. 170The default is to configure PMCs to sample the CPU's instruction 171pointer every 65536 events. 172.It Fl o Ar outputfile 173Send counter readings and textual representations of logged data 174to file 175.Ar outputfile . 176The default is to send output to 177.Pa stderr . 178.It Fl p Ar event-spec 179Allocate a process mode counting PMC measuring hardware events 180specified in 181.Ar event-spec . | 189.It Fl n Ar rate 190Set the default sampling rate for subsequent sampling mode 191PMCs specified on the command line. 192The default is to configure PMCs to sample the CPU's instruction 193pointer every 65536 events. 194.It Fl o Ar outputfile 195Send counter readings and textual representations of logged data 196to file 197.Ar outputfile . 198The default is to send output to 199.Pa stderr . 200.It Fl p Ar event-spec 201Allocate a process mode counting PMC measuring hardware events 202specified in 203.Ar event-spec . |
| 204.It Fl q 205Decrease verbosity. 206.It Fl r Ar fsroot 207Set the top of the filesystem hierarchy under which executables 208are located to argument 209.Ar fsroot . 210The default is 211.Pa / . |
|
| 182.It Fl s Ar event-spec 183Allocate a system mode counting PMC measuring hardware events 184specified in 185.Ar event-spec . 186.It Fl t Ar pid 187Attach all process mode PMCs allocated to the process with PID 188.Ar pid . 189The option is not allowed in conjunction with specifying a 190command using 191.Ar command . | 212.It Fl s Ar event-spec 213Allocate a system mode counting PMC measuring hardware events 214specified in 215.Ar event-spec . 216.It Fl t Ar pid 217Attach all process mode PMCs allocated to the process with PID 218.Ar pid . 219The option is not allowed in conjunction with specifying a 220command using 221.Ar command . |
| 222.It Fl v 223Increase verbosity. |
|
| 192.It Fl w Ar secs 193Print the values of all counting mode PMCs every 194.Ar secs 195seconds. 196The argument 197.Ar secs 198may be a fractional value. 199The default interval is 5 seconds. --- 51 unchanged lines hidden --- | 224.It Fl w Ar secs 225Print the values of all counting mode PMCs every 226.Ar secs 227seconds. 228The argument 229.Ar secs 230may be a fractional value. 231The default interval is 5 seconds. --- 51 unchanged lines hidden --- |