Skip to content

Commit

Permalink
Merge branch 'perf/core' of git://git.kernel.org/pub/scm/linux/kernel…
Browse files Browse the repository at this point in the history
…/git/acme/linux-2.6 into perf/core
  • Loading branch information
Ingo Molnar committed Dec 2, 2010
2 parents b3d006c + d7470b6 commit e4b546a
Show file tree
Hide file tree
Showing 15 changed files with 324 additions and 68 deletions.
37 changes: 36 additions & 1 deletion tools/perf/Documentation/perf-annotate.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,12 +24,47 @@ OPTIONS
--input=::
Input file name. (default: perf.data)

-d::
--dsos=<dso[,dso...]>::
Only consider symbols in these dsos.
-s::
--symbol=<symbol>::
Symbol to annotate.

-f::
--force::
Don't complain, do it.

-v::
--verbose::
Be more verbose. (Show symbol address, etc)

-D::
--dump-raw-trace::
Dump raw trace in ASCII.

-k::
--vmlinux=<file>::
vmlinux pathname.

-m::
--modules::
Load module symbols. WARNING: use only with -k and LIVE kernel.

-l::
--print-line::
Print matching source lines (may be slow).

-P::
--full-paths::
Don't shorten the displayed pathnames.

--stdio:: Use the stdio interface.

--tui:: Use the TUI interface Use of --tui requires a tty, if one is not
present, as when piping to other commands, the stdio interface is
used. This interfaces starts by centering on the line with more
samples, TAB/UNTAB cycles thru the lines with more samples.
samples, TAB/UNTAB cycles through the lines with more samples.

SEE ALSO
--------
Expand Down
3 changes: 3 additions & 0 deletions tools/perf/Documentation/perf-buildid-list.txt
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,9 @@ perf report.

OPTIONS
-------
-H::
--with-hits::
Show only DSOs with hits.
-i::
--input=::
Input file name. (default: perf.data)
Expand Down
19 changes: 18 additions & 1 deletion tools/perf/Documentation/perf-diff.txt
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,18 @@ If no parameters are passed it will assume perf.data.old and perf.data.

OPTIONS
-------
-M::
--displacement::
Show position displacement relative to baseline.

-D::
--dump-raw-trace::
Dump raw trace in ASCII.

-m::
--modules::
Load module symbols. WARNING: use only with -k and LIVE kernel

-d::
--dsos=::
Only consider symbols in these dsos. CSV that understands
Expand All @@ -42,14 +54,19 @@ OPTIONS
--field-separator=::

Use a special separator character and don't pad with spaces, replacing
all occurances of this separator in symbol names (and other output)
all occurrences of this separator in symbol names (and other output)
with a '.' character, that thus it's the only non valid separator.

-v::
--verbose::
Be verbose, for instance, show the raw counts in addition to the
diff.

-f::
--force::
Don't complain, do it.


SEE ALSO
--------
linkperf:perf-record[1]
8 changes: 7 additions & 1 deletion tools/perf/Documentation/perf-kvm.txt
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ There are a couple of variants of perf kvm:
a performance counter profile of guest os in realtime
of an arbitrary workload.

'perf kvm record <command>' to record the performance couinter profile
'perf kvm record <command>' to record the performance counter profile
of an arbitrary workload and save it into a perf data file. If both
--host and --guest are input, the perf data file name is perf.data.kvm.
If there is no --host but --guest, the file name is perf.data.guest.
Expand All @@ -40,6 +40,12 @@ There are a couple of variants of perf kvm:

OPTIONS
-------
-i::
--input=::
Input file name.
-o::
--output::
Output file name.
--host=::
Collect host side performance profile.
--guest=::
Expand Down
15 changes: 15 additions & 0 deletions tools/perf/Documentation/perf-lock.txt
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,21 @@ and statistics with this 'perf lock' command.

'perf lock report' reports statistical data.

OPTIONS
-------

-i::
--input=<file>::
Input file name.

-v::
--verbose::
Be more verbose (show symbol address, etc).

-D::
--dump-raw-trace::
Dump raw trace in ASCII.

SEE ALSO
--------
linkperf:perf[1]
2 changes: 1 addition & 1 deletion tools/perf/Documentation/perf-probe.txt
Original file line number Diff line number Diff line change
Expand Up @@ -115,7 +115,7 @@ Each probe argument follows below syntax.

LINE SYNTAX
-----------
Line range is descripted by following syntax.
Line range is described by following syntax.

"FUNC[:RLN[+NUM|-RLN2]]|SRC:ALN[+NUM|-ALN2]"

Expand Down
17 changes: 13 additions & 4 deletions tools/perf/Documentation/perf-record.txt
Original file line number Diff line number Diff line change
Expand Up @@ -39,15 +39,24 @@ OPTIONS
be passed as follows: '\mem:addr[:[r][w][x]]'.
If you want to profile read-write accesses in 0x1000, just set
'mem:0x1000:rw'.

--filter=<filter>::
Event filter.

-a::
System-wide collection.
--all-cpus::
System-wide collection from all CPUs.

-l::
Scale counter values.

-p::
--pid=::
Record events on existing pid.
Record events on existing process ID.

-t::
--tid=::
Record events on existing thread ID.

-r::
--realtime=::
Expand Down Expand Up @@ -109,8 +118,8 @@ Collect raw sample records from all opened counters (default for tracepoint coun

-C::
--cpu::
Collect samples only on the list of cpus provided. Multiple CPUs can be provided as a
comma-sperated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
Collect samples only on the list of CPUs provided. Multiple CPUs can be provided as a
comma-separated list with no space: 0,1. Ranges of CPUs are specified with -: 0-2.
In per-thread mode with inheritance mode on (default), samples are captured only when
the thread executes on the designated CPUs. Default is to monitor all CPUs.

Expand Down
49 changes: 45 additions & 4 deletions tools/perf/Documentation/perf-report.txt
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,22 @@ OPTIONS
-i::
--input=::
Input file name. (default: perf.data)

-v::
--verbose::
Be more verbose. (show symbol address, etc)

-d::
--dsos=::
Only consider symbols in these dsos. CSV that understands
file://filename entries.
-n::
--show-nr-samples::
Show the number of samples for each symbol

--showcpuutilization::
Show sample percentage for different cpu modes.

-T::
--threads::
Show per-thread event counters
Expand All @@ -39,39 +48,71 @@ OPTIONS
Only consider these symbols. CSV that understands
file://filename entries.

-U::
--hide-unresolved::
Only display entries resolved to a symbol.

-s::
--sort=::
Sort by key(s): pid, comm, dso, symbol, parent.

-p::
--parent=<regex>::
regex filter to identify parent, see: '--sort parent'

-x::
--exclude-other::
Only display entries with parent-match.

-w::
--field-width=::
--column-widths=<width[,width...]>::
Force each column width to the provided list, for large terminal
readability.

-t::
--field-separator=::

Use a special separator character and don't pad with spaces, replacing
all occurances of this separator in symbol names (and other output)
all occurrences of this separator in symbol names (and other output)
with a '.' character, that thus it's the only non valid separator.

-D::
--dump-raw-trace::
Dump raw trace in ASCII.

-g [type,min]::
--call-graph::
Display callchains using type and min percent threshold.
Display call chains using type and min percent threshold.
type can be either:
- flat: single column, linear exposure of callchains.
- flat: single column, linear exposure of call chains.
- graph: use a graph tree, displaying absolute overhead rates.
- fractal: like graph, but displays relative rates. Each branch of
the tree is considered as a new profiled object. +
Default: fractal,0.5.

--pretty=<key>::
Pretty printing style. key: normal, raw

--stdio:: Use the stdio interface.

--tui:: Use the TUI interface, that is integrated with annotate and allows
zooming into DSOs or threads, among other features. Use of --tui
requires a tty, if one is not present, as when piping to other
commands, the stdio interface is used.

-k::
--vmlinux=<file>::
vmlinux pathname

-m::
--modules::
Load module symbols. WARNING: This should only be used with -k and
a LIVE kernel.

-f::
--force::
Don't complain, do it.

SEE ALSO
--------
linkperf:perf-stat[1]
18 changes: 16 additions & 2 deletions tools/perf/Documentation/perf-sched.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ perf-sched - Tool to trace/measure scheduler properties (latencies)
SYNOPSIS
--------
[verse]
'perf sched' {record|latency|replay|trace}
'perf sched' {record|latency|map|replay|trace}

DESCRIPTION
-----------
There are four variants of perf sched:
There are five variants of perf sched:

'perf sched record <command>' to record the scheduling events
of an arbitrary workload.
Expand All @@ -30,8 +30,22 @@ There are four variants of perf sched:
of the workload as it occurred when it was recorded - and can repeat
it a number of times, measuring its performance.)

'perf sched map' to print a textual context-switching outline of
workload captured via perf sched record. Columns stand for
individual CPUs, and the two-letter shortcuts stand for tasks that
are running on a CPU. A '*' denotes the CPU that had the event, and
a dot signals an idle CPU.

OPTIONS
-------
-i::
--input=<file>::
Input file name. (default: perf.data)

-v::
--verbose::
Be more verbose. (show symbol address, etc)

-D::
--dump-raw-trace=::
Display verbose dump of the sched data.
Expand Down
7 changes: 7 additions & 0 deletions tools/perf/Documentation/perf-script.txt
Original file line number Diff line number Diff line change
Expand Up @@ -104,6 +104,13 @@ OPTIONS
normally don't - this option allows the latter to be run in
system-wide mode.

-i::
--input=::
Input file name.

-d::
--debug-mode::
Do various checks like samples ordering and lost events.

SEE ALSO
--------
Expand Down
Loading

0 comments on commit e4b546a

Please sign in to comment.