pmcstat.8 (193296) | pmcstat.8 (203790) |
---|---|
1.\" Copyright (c) 2003-2008 Joseph Koshy 2.\" Copyright (c) 2007 The FreeBSD Foundation 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" for any direct, indirect, incidental, special, exemplary, or consequential 19.\" damages (including, but not limited to, procurement of substitute goods 20.\" or services; loss of use, data, or profits; or business interruption) 21.\" however caused and on any theory of liability, whether in contract, strict 22.\" liability, or tort (including negligence or otherwise) arising in any way 23.\" out of the use of this software, even if advised of the possibility of 24.\" such damage. 25.\" | 1.\" Copyright (c) 2003-2008 Joseph Koshy 2.\" Copyright (c) 2007 The FreeBSD Foundation 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 9 unchanged lines hidden (view full) --- 18.\" for any direct, indirect, incidental, special, exemplary, or consequential 19.\" damages (including, but not limited to, procurement of substitute goods 20.\" or services; loss of use, data, or profits; or business interruption) 21.\" however caused and on any theory of liability, whether in contract, strict 22.\" liability, or tort (including negligence or otherwise) arising in any way 23.\" out of the use of this software, even if advised of the possibility of 24.\" such damage. 25.\" |
26.\" $FreeBSD: head/usr.sbin/pmcstat/pmcstat.8 193296 2009-06-02 04:45:56Z jkoshy $ | 26.\" $FreeBSD: head/usr.sbin/pmcstat/pmcstat.8 203790 2010-02-11 22:51:44Z fabient $ |
27.\" 28.Dd September 19, 2008 29.Os 30.Dt PMCSTAT 8 31.Sh NAME 32.Nm pmcstat 33.Nd "performance measurement with performance monitoring hardware" 34.Sh SYNOPSIS 35.Nm 36.Op Fl C 37.Op Fl D Ar pathname 38.Op Fl E | 27.\" 28.Dd September 19, 2008 29.Os 30.Dt PMCSTAT 8 31.Sh NAME 32.Nm pmcstat 33.Nd "performance measurement with performance monitoring hardware" 34.Sh SYNOPSIS 35.Nm 36.Op Fl C 37.Op Fl D Ar pathname 38.Op Fl E |
39.Op Fl F Ar pathname |
|
39.Op Fl G Ar pathname 40.Op Fl M Ar mapfilename 41.Op Fl N 42.Op Fl O Ar logfilename 43.Op Fl P Ar event-spec 44.Op Fl R Ar logfilename 45.Op Fl S Ar event-spec | 40.Op Fl G Ar pathname 41.Op Fl M Ar mapfilename 42.Op Fl N 43.Op Fl O Ar logfilename 44.Op Fl P Ar event-spec 45.Op Fl R Ar logfilename 46.Op Fl S Ar event-spec |
47.Op Fl T |
|
46.Op Fl W 47.Op Fl c Ar cpu-spec 48.Op Fl d | 48.Op Fl W 49.Op Fl c Ar cpu-spec 50.Op Fl d |
51.Op Fl f Ar pluginopt |
|
49.Op Fl g 50.Op Fl k Ar kerneldir 51.Op Fl m Ar pathname 52.Op Fl n Ar rate 53.Op Fl o Ar outputfile 54.Op Fl p Ar event-spec 55.Op Fl q 56.Op Fl r Ar fsroot --- 67 unchanged lines hidden (view full) --- 124.It Fl E 125Toggle showing per-process counts at the time a tracked process 126exits for subsequent process-mode PMCs specified on the command line. 127This option is useful for mapping the performance characteristics of a 128complex pipeline of processes when used in conjunction with the 129.Fl d 130option. 131The default is to not to enable per-process tracking. | 52.Op Fl g 53.Op Fl k Ar kerneldir 54.Op Fl m Ar pathname 55.Op Fl n Ar rate 56.Op Fl o Ar outputfile 57.Op Fl p Ar event-spec 58.Op Fl q 59.Op Fl r Ar fsroot --- 67 unchanged lines hidden (view full) --- 127.It Fl E 128Toggle showing per-process counts at the time a tracked process 129exits for subsequent process-mode PMCs specified on the command line. 130This option is useful for mapping the performance characteristics of a 131complex pipeline of processes when used in conjunction with the 132.Fl d 133option. 134The default is to not to enable per-process tracking. |
135.It Fl F Ar pathname 136Print calltree (Kcachegrind) information to file 137.Ar pathname . 138If argument 139.Ar pathname 140is a 141.Dq Li - 142this information is sent to the output file specified by the 143.Fl o 144option. |
|
132.It Fl G Ar pathname 133Print callchain information to file 134.Ar pathname . 135If argument 136.Ar pathname 137is a 138.Dq Li - 139this information is sent to the output file specified by the --- 50 unchanged lines hidden (view full) --- 190.Ar event-spec . 191.It Fl R Ar logfilename 192Perform offline analysis using sampling data in file 193.Ar logfilename . 194.It Fl S Ar event-spec 195Allocate a system mode sampling PMC measuring hardware events 196specified in 197.Ar event-spec . | 145.It Fl G Ar pathname 146Print callchain information to file 147.Ar pathname . 148If argument 149.Ar pathname 150is a 151.Dq Li - 152this information is sent to the output file specified by the --- 50 unchanged lines hidden (view full) --- 203.Ar event-spec . 204.It Fl R Ar logfilename 205Perform offline analysis using sampling data in file 206.Ar logfilename . 207.It Fl S Ar event-spec 208Allocate a system mode sampling PMC measuring hardware events 209specified in 210.Ar event-spec . |
211.It Fl T 212Use a top like mode for sampling PMCs. The following hotkeys 213can be used: 'c+a' switch to accumulative mode, 'c+d' switch 214to delta mode, 'm' merge PMCs, 'n' change view, 'p' show next 215PMC, ' ' pause, 'q' quit. calltree only: 'f' cost under threshold 216is seen as a dot. |
|
198.It Fl W 199Toggle logging the incremental counts seen by the threads of a 200tracked process each time they are scheduled on a CPU. 201This is an experimental feature intended to help analyse the 202dynamic behaviour of processes in the system. 203It may incur substantial overhead if enabled. 204The default is for this feature to be disabled. 205.It Fl c Ar cpu-spec --- 7 unchanged lines hidden (view full) --- 213denoting all unhalted CPUs. 214The default is to allocate system mode PMCs on all unhalted 215CPUs. 216.It Fl d 217Toggle between process mode PMCs measuring events for the target 218process' current and future children or only measuring events for 219the target process. 220The default is to measure events for the target process alone. | 217.It Fl W 218Toggle logging the incremental counts seen by the threads of a 219tracked process each time they are scheduled on a CPU. 220This is an experimental feature intended to help analyse the 221dynamic behaviour of processes in the system. 222It may incur substantial overhead if enabled. 223The default is for this feature to be disabled. 224.It Fl c Ar cpu-spec --- 7 unchanged lines hidden (view full) --- 232denoting all unhalted CPUs. 233The default is to allocate system mode PMCs on all unhalted 234CPUs. 235.It Fl d 236Toggle between process mode PMCs measuring events for the target 237process' current and future children or only measuring events for 238the target process. 239The default is to measure events for the target process alone. |
240.It Fl f Ar pluginopt 241Pass option string to the active plugin. 242.br 243threshold=<float> do not display cost under specified value (Top). 244.br 245skiplink=0|1 replace node with cost under threshold by a dot (Top). |
|
221.It Fl g 222Produce profiles in a format compatible with 223.Xr gprof 1 . 224A separate profile file is generated for each executable object 225encountered. 226Profile files are placed in sub-directories named by their PMC 227event name. 228.It Fl k Ar kerneldir --- 52 unchanged lines hidden (view full) --- 281.Ar process-spec . 282Argument 283.Ar process-spec 284may be a non-negative integer denoting a specific process id, or a 285regular expression for selecting processes based on their command names. 286.It Fl v 287Increase verbosity. 288.It Fl w Ar secs | 246.It Fl g 247Produce profiles in a format compatible with 248.Xr gprof 1 . 249A separate profile file is generated for each executable object 250encountered. 251Profile files are placed in sub-directories named by their PMC 252event name. 253.It Fl k Ar kerneldir --- 52 unchanged lines hidden (view full) --- 306.Ar process-spec . 307Argument 308.Ar process-spec 309may be a non-negative integer denoting a specific process id, or a 310regular expression for selecting processes based on their command names. 311.It Fl v 312Increase verbosity. 313.It Fl w Ar secs |
289Print the values of all counting mode PMCs every | 314Print the values of all counting mode PMCs or sampling mode PMCs 315for top mode every |
290.Ar secs 291seconds. 292The argument 293.Ar secs 294may be a fractional value. 295The default interval is 5 seconds. 296.It Fl z Ar graphdepth 297When printing system-wide callgraphs, limit callgraphs to the depth --- 133 unchanged lines hidden --- | 316.Ar secs 317seconds. 318The argument 319.Ar secs 320may be a fractional value. 321The default interval is 5 seconds. 322.It Fl z Ar graphdepth 323When printing system-wide callgraphs, limit callgraphs to the depth --- 133 unchanged lines hidden --- |