From mboxrd@z Thu Jan  1 00:00:00 1970
From: Frederic Weisbecker <fweisbec@gmail.com>
Subject: Re: [PATCH -tip v14 08/12] tracing: add kprobe-based event tracer
Date: Wed, 19 Aug 2009 03:23:08 +0200
Message-ID: <20090819012306.GJ5231@nowhere>
References: <20090813203403.31965.20973.stgit@localhost.localdomain> <20090813203510.31965.29123.stgit@localhost.localdomain>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: QUOTED-PRINTABLE
Cc: Ingo Molnar <mingo@elte.hu>, Steven Rostedt <rostedt@goodmis.org>,
	lkml <linux-kernel@vger.kernel.org>,
	systemtap <systemtap@sources.redhat.com>,
	kvm <kvm@vger.kernel.org>,
	DLE <dle-develop@lists.sourceforge.net>,
	Ananth N Mavinakayanahalli <ananth@in.ibm.com>,
	Avi Kivity <avi@redhat.com>, Andi Kleen <ak@linux.intel.com>,
	Christoph Hellwig <hch@infradead.org>,
	"Frank Ch. Eigler" <fche@redhat.com>,
	"H. Peter Anvin" <hpa@zytor.com>, Jason Baron <jbaron@redhat.com>,
	Jim Keniston <jkenisto@us.ibm.com>,
	"K.Prasad" <prasad@linux.vnet.ibm.com>,
	Lai Jiangshan <laijs@cn.fujitsu.com>,
	Li Zefan <lizf@cn.fujitsu.com>,
	=?utf-8?B?UHJ6ZW15c8WCYXdQYXdlxYJjenlr?= <przemyslaw@pawelczyk.it>,
	Roland McGrath <roland@redhat.com>,
	Sam Ravnborg <sam@ravnborg.org>,
	Srikar Dronamraju <srikar@linux.vnet.ibm.com>,
	Tom Zanussi <tzanussi@gmail.com>,
	Vegard Nossum <vegard.nossum@gmail.com>
To: Masami Hiramatsu <mhiramat@redhat.com>
Return-path: <kvm-owner@vger.kernel.org>
Received: from ey-out-2122.google.com ([74.125.78.25]:5821 "EHLO
	ey-out-2122.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org
	with ESMTP id S1751409AbZHSBXM (ORCPT <rfc822;kvm@vger.kernel.org>);
	Tue, 18 Aug 2009 21:23:12 -0400
Content-Disposition: inline
In-Reply-To: <20090813203510.31965.29123.stgit@localhost.localdomain>
Sender: kvm-owner@vger.kernel.org
List-ID: <kvm.vger.kernel.org>

On Thu, Aug 13, 2009 at 04:35:11PM -0400, Masami Hiramatsu wrote:
> Add kprobes-based event tracer on ftrace.
>=20
> This tracer is similar to the events tracer which is based on Tracepo=
int
> infrastructure. Instead of Tracepoint, this tracer is based on kprobe=
s
> (kprobe and kretprobe). It probes anywhere where kprobes can probe(th=
is
>  means, all functions body except for __kprobes functions).
>=20
> Similar to the events tracer, this tracer doesn't need to be activate=
d via
> current_tracer, instead of that, just set probe points via
> /sys/kernel/debug/tracing/kprobe_events. And you can set filters on e=
ach
> probe events via /sys/kernel/debug/tracing/events/kprobes/<EVENT>/fil=
ter.
>=20
> This tracer supports following probe arguments for each probe.
>=20
>   %REG  : Fetch register REG
>   sN    : Fetch Nth entry of stack (N >=3D 0)
>   sa    : Fetch stack address.
>   @ADDR : Fetch memory at ADDR (ADDR should be in kernel)
>   @SYM[+|-offs] : Fetch memory at SYM +|- offs (SYM should be a data =
symbol)
>   aN    : Fetch function argument. (N >=3D 0)
>   rv    : Fetch return value.
>   ra    : Fetch return address.
>   +|-offs(FETCHARG) : fetch memory at FETCHARG +|- offs address.
>=20
> See Documentation/trace/kprobetrace.txt for details.
>=20
> Changes from v13:
>  - Support 'sa' for stack address.
>  - Use call->data instead of container_of() macro.
>=20
> Signed-off-by: Masami Hiramatsu <mhiramat@redhat.com>
> Acked-by: Ananth N Mavinakayanahalli <ananth@in.ibm.com>
> Cc: Avi Kivity <avi@redhat.com>
> Cc: Andi Kleen <ak@linux.intel.com>
> Cc: Christoph Hellwig <hch@infradead.org>
> Cc: Frank Ch. Eigler <fche@redhat.com>
> Cc: Frederic Weisbecker <fweisbec@gmail.com>
> Cc: H. Peter Anvin <hpa@zytor.com>
> Cc: Ingo Molnar <mingo@elte.hu>
> Cc: Jason Baron <jbaron@redhat.com>
> Cc: Jim Keniston <jkenisto@us.ibm.com>
> Cc: K.Prasad <prasad@linux.vnet.ibm.com>
> Cc: Lai Jiangshan <laijs@cn.fujitsu.com>
> Cc: Li Zefan <lizf@cn.fujitsu.com>
> Cc: Przemys=C5=82aw Pawe=C5=82czyk <przemyslaw@pawelczyk.it>
> Cc: Roland McGrath <roland@redhat.com>
> Cc: Sam Ravnborg <sam@ravnborg.org>
> Cc: Srikar Dronamraju <srikar@linux.vnet.ibm.com>
> Cc: Steven Rostedt <rostedt@goodmis.org>
> Cc: Tom Zanussi <tzanussi@gmail.com>
> Cc: Vegard Nossum <vegard.nossum@gmail.com>
> ---
>=20
>  Documentation/trace/kprobetrace.txt |  139 ++++


I'll probably split this commit to have the first version of the
documentation as a separate patch in order to lighten this.

=46rederic.