Lines Matching +full:s +full:- +full:mode

1 .\" Copyright (c) 2003-2008 Joseph Koshy
45 .Op Fl P Ar event-spec
47 .Op Fl S Ar event-spec
52 .Op Fl c Ar cpu-spec
62 .Op Fl p Ar event-spec
65 .Op Fl s Ar event-spec
66 .Op Fl t Ar process-spec
67 .Op Fl u Ar event-spec
82 on the system's CPUs.
85 .Fl t Ar process-spec
91 .Fl t Ar process-spec
97 will perform system-wide measurements till interrupted by the
102 can mix allocations of system-mode and process-mode PMCs, of both
108 .Nm Ns 's
109 human-readable textual output is not stable, and could change
118 .Ar event-spec .
123 A process-mode PMC may be configured to be inheritable by the target
127 .Bl -tag -width indent
132 subsequent counting mode PMCs specified on the command line.
135 Create files with per-program samples in the directory named
140 Toggle showing per-process counts at the time a tracked process
141 exits for subsequent process-mode PMCs specified on the command line.
146 The default is to not to enable per-process tracking.
153 .Dq Li -
163 .Dq Li -
181 .Dq Li -
216 .It Fl P Ar event-spec
217 Allocate a process mode sampling PMC measuring hardware events
219 .Ar event-spec .
223 .It Fl S Ar event-spec
224 Allocate a system mode sampling PMC measuring hardware events
226 .Ar event-spec .
229 .Xr top 1 Ns -like
230 mode for sampling PMCs.
233 .Bl -tag -compact -width "Ctrl+a" -offset 4n
239 Switch to accumulative mode
243 Switch to delta mode
263 Toggle capturing user-space call traces while in kernel mode.
264 The default is for sampling PMCs to capture user-space callchain information
265 while in user-space mode, and kernel callchain information while in kernel mode.
288 .It Fl c Ar cpu-spec
289 Set the cpus for subsequent system mode PMCs specified on the
291 .Ar cpu-spec .
293 .Ar cpu-spec
297 The default is to allocate system mode PMCs on all available
300 Toggle between process mode PMCs measuring events for the target
306 .Fl s ,
309 .Fl S ) .
314 However, other tools that cannot fully parse a BSD-style
327 Profile files are placed in sub-directories named by their PMC
337 Set system-wide performance measurement duration for
352 .Dq Li -
363 Set the default sampling rate for subsequent sampling mode
365 The default is to configure PMCs to sample the CPU's instruction
375 when processing a pre-existing logfile.
376 .It Fl p Ar event-spec
377 Allocate a process mode counting PMC measuring hardware events
379 .Ar event-spec .
388 .It Fl s Ar event-spec
389 Allocate a system mode counting PMC measuring hardware events
391 .Ar event-spec .
392 .It Fl t Ar process-spec
393 Attach process mode PMCs to the processes named by argument
394 .Ar process-spec .
396 .Ar process-spec
397 may be a non-negative integer denoting a specific process id, or a
399 .It Fl u Ar event-spec
404 Print the values of all counting mode PMCs or sampling mode PMCs
405 for top mode every
413 When printing system-wide callgraphs, limit callgraphs to the depth
423 To perform system-wide statistical sampling on an AMD Athlon CPU with
428 .Dl "pmcstat -O sample.stat -n 32768 -S k7-retired-instructions"
434 .Dl "pmcstat -d -w 12 -p k7-dc-misses firefox"
439 .Dl "pmcstat -t '^emacs$' -p instructions"
444 .Dl "pmcstat -t '^emacs$' -p instructions sleep 10"
446 To count instruction tlb-misses on CPUs 0 and 2 on a Intel
448 .Dl "pmcstat -c 0,2 -s p6-itlb-miss"
452 .Dl "pmcstat -P ic-misses -t 1234 -O /tmp/sample.out"
454 To perform system-wide sampling on all configured processors
456 .Dl "pmcstat -S instructions -O /tmp/sample.out"
458 .Dl "pmcstat -N -S instructions -O /tmp/sample.out"
461 .Dl "pmcstat -S instructions -O remotehost:port"
464 .Dl "nc -l remotehost port > /tmp/sample.out"
469 .Dl "pmcstat -R /tmp/sample.out -g"
471 To print a system-wide profile with callgraphs to file
474 .Dl "pmcstat -R /tmp/sample.out -G foo.graph"
481 .Bl -diag
482 .It "#callchain/dubious-frames"
505 .It "#samples/unknown-object"
510 .Ex -std
544 logs generated by non-native architectures.