Lines Matching +full:port +full:- +full:mapping +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
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
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.
142 This option is useful for mapping the performance characteristics of a
146 The default is to not to enable per-process tracking.
153 .Dq Li -
163 .Dq Li -
172 Write the mapping between executable objects encountered in the event
177 If this option is not specified, mapping information is not written.
181 .Dq Li -
182 in which case this mapping information is sent to the output
195 .Ar hostname Ns : Ns Ar port ,
206 on port
207 .Ar port .
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
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
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.