631c9def80
Add --line option to support showing probable source-code lines.
perf probe --line SRC:LN[-LN|+NUM]
or
perf probe --line FUNC[:LN[-LN|+NUM]]
This option shows source-code with line number if the line can
be probed. Lines without line number (and blue color) means that
the line can not be probed, because debuginfo doesn't have the
information of those lines.
The argument specifies the range of lines, "source.c:100-120"
shows lines between 100th to l20th in source.c file. And
"func:10+20" shows 20 lines from 10th line of func function.
e.g.
# ./perf probe --line kernel/sched.c:1080
<kernel/sched.c:1080>
*
* called with rq->lock held and irqs disabled
*/
static void hrtick_start(struct rq *rq, u64 delay)
{
struct hrtimer *timer = &rq->hrtick_timer;
1086 ktime_t time = ktime_add_ns(timer->base->get_time(), delay);
hrtimer_set_expires(timer, time);
1090 if (rq == this_rq()) {
1091 hrtimer_restart(timer);
1092 } else if (!rq->hrtick_csd_pending) {
1093 __smp_call_function_single(cpu_of(rq), &rq->hrtick_csd,
1094 rq->hrtick_csd_pending = 1;
If you specifying function name, this shows function-relative
line number.
# ./perf probe --line schedule
<schedule:0>
asmlinkage void __sched schedule(void)
1 {
struct task_struct *prev, *next;
unsigned long *switch_count;
struct rq *rq;
int cpu;
need_resched:
preempt_disable();
9 cpu = smp_processor_id();
10 rq = cpu_rq(cpu);
11 rcu_sched_qs(cpu);
12 prev = rq->curr;
13 switch_count = &prev->nivcsw;
Signed-off-by: Masami Hiramatsu <mhiramat@redhat.com>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: systemtap <systemtap@sources.redhat.com>
Cc: DLE <dle-develop@lists.sourceforge.net>
Cc: Frederic Weisbecker <fweisbec@gmail.com>
Cc: Paul Mackerras <paulus@samba.org>
Cc: Arnaldo Carvalho de Melo <acme@redhat.com>
Cc: Peter Zijlstra <peterz@infradead.org>
Cc: Mike Galbraith <efault@gmx.de>
LKML-Reference: <20100106144534.27218.77939.stgit@dhcp-100-2-132.bos.redhat.com>
Signed-off-by: Ingo Molnar <mingo@elte.hu>
81 lines
2.5 KiB
Text
81 lines
2.5 KiB
Text
perf-probe(1)
|
|
=============
|
|
|
|
NAME
|
|
----
|
|
perf-probe - Define new dynamic tracepoints
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf probe' [options] --add='PROBE' [...]
|
|
or
|
|
'perf probe' [options] PROBE
|
|
or
|
|
'perf probe' [options] --del='[GROUP:]EVENT' [...]
|
|
or
|
|
'perf probe' --list
|
|
or
|
|
'perf probe' --line='FUNC[:RLN[+NUM|:RLN2]]|SRC:ALN[+NUM|:ALN2]'
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command defines dynamic tracepoint events, by symbol and registers
|
|
without debuginfo, or by C expressions (C line numbers, C function names,
|
|
and C local variables) with debuginfo.
|
|
|
|
|
|
OPTIONS
|
|
-------
|
|
-k::
|
|
--vmlinux=PATH::
|
|
Specify vmlinux path which has debuginfo (Dwarf binary).
|
|
|
|
-v::
|
|
--verbose::
|
|
Be more verbose (show parsed arguments, etc).
|
|
|
|
-a::
|
|
--add=::
|
|
Define a probe event (see PROBE SYNTAX for detail).
|
|
|
|
-d::
|
|
--del=::
|
|
Delete a probe event.
|
|
|
|
-l::
|
|
--list::
|
|
List up current probe events.
|
|
|
|
-L::
|
|
--line=::
|
|
Show source code lines which can be probed. This needs an argument
|
|
which specifies a range of the source code.
|
|
|
|
PROBE SYNTAX
|
|
------------
|
|
Probe points are defined by following syntax.
|
|
|
|
"[EVENT=]FUNC[+OFFS|:RLN|%return][@SRC]|SRC:ALN [ARG ...]"
|
|
|
|
'EVENT' specifies the name of new event, if omitted, it will be set the name of the probed function. Currently, event group name is set as 'probe'.
|
|
'FUNC' specifies a probed function name, and it may have one of the following options; '+OFFS' is the offset from function entry address in bytes, 'RLN' is the relative-line number from function entry line, and '%return' means that it probes function return. In addition, 'SRC' specifies a source file which has that function.
|
|
It is also possible to specify a probe point by the source line number by using 'SRC:ALN' syntax, where 'SRC' is the source file path and 'ALN' is the line number.
|
|
'ARG' specifies the arguments of this probe point. You can use the name of local variable, or kprobe-tracer argument format (e.g. $retval, %ax, etc).
|
|
|
|
LINE SYNTAX
|
|
-----------
|
|
Line range is descripted by following syntax.
|
|
|
|
"FUNC[:RLN[+NUM|:RLN2]]|SRC:ALN[+NUM|:ALN2]"
|
|
|
|
FUNC specifies the function name of showing lines. 'RLN' is the start line
|
|
number from function entry line, and 'RLN2' is the end line number. As same as
|
|
probe syntax, 'SRC' means the source file path, 'ALN' is start line number,
|
|
and 'ALN2' is end line number in the file. It is also possible to specify how
|
|
many lines to show by using 'NUM'.
|
|
So, "source.c:100-120" shows lines between 100th to l20th in source.c file. And "func:10+20" shows 20 lines from 10th line of func function.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-trace[1], linkperf:perf-record[1]
|