Re: [PATCH 5/6] Documentation: tracing: Add %return suffix description

2020-08-31 Thread Masami Hiramatsu
On Tue, 1 Sep 2020 07:27:45 +0900
Masami Hiramatsu  wrote:

> On Mon, 31 Aug 2020 11:50:20 -0700
> Randy Dunlap  wrote:
> 
> > On 8/31/20 5:46 AM, Masami Hiramatsu wrote:
> > > Add a description of the %return suffix option for kprobe tracer.
> > > 
> > > Signed-off-by: Masami Hiramatsu 
> > > ---
> > >  Documentation/trace/kprobetrace.rst |2 ++
> > >  1 file changed, 2 insertions(+)
> > > 
> > > diff --git a/Documentation/trace/kprobetrace.rst 
> > > b/Documentation/trace/kprobetrace.rst
> > > index c1709165c553..d29d1f9e6721 100644
> > > --- a/Documentation/trace/kprobetrace.rst
> > > +++ b/Documentation/trace/kprobetrace.rst
> > 
> > Check spacing:
> > 
> > > @@ -37,6 +38,7 @@ Synopsis of kprobe_events
> > > based on SYM+offs or MEMADDR.
> > >   MOD : Module name which has given SYM.
> > >   SYM[+offs]  : Symbol+offset where the probe is inserted.
> > > + SYM%return : Return address of the symbol
> > >   MEMADDR : Address where the probe is inserted.
> > >   MAXACTIVE   : Maximum number of instances of the specified function 
> > > that
> > > can be probed simultaneously, or 0 for the default value
> > 
> > If I remove the '+', the ':' lines up but the SYM does not line up.
> > Am I missing something?
> > 
> > @@ -37,6 +38,7 @@ Synopsis of kprobe_events
> >   based on SYM+offs or MEMADDR.
> >   MOD   : Module name which has given SYM.
> >   SYM[+offs]: Symbol+offset where the probe is inserted.
> >  SYM%return : Return address of the symbol
> >   MEMADDR   : Address where the probe is inserted.
> >   MAXACTIVE : Maximum number of instances of the specified function that
> >   can be probed simultaneously, or 0 for the default value
> > 
> 

Shouldn't we use the horizontal tab in .rst ? It seems other lines
use a tab to indent, but this line doesn't (VIM converted the tab to spaces.)

Thank you,

-- 
Masami Hiramatsu 


Re: [PATCH 5/6] Documentation: tracing: Add %return suffix description

2020-08-31 Thread Masami Hiramatsu
On Mon, 31 Aug 2020 11:50:20 -0700
Randy Dunlap  wrote:

> On 8/31/20 5:46 AM, Masami Hiramatsu wrote:
> > Add a description of the %return suffix option for kprobe tracer.
> > 
> > Signed-off-by: Masami Hiramatsu 
> > ---
> >  Documentation/trace/kprobetrace.rst |2 ++
> >  1 file changed, 2 insertions(+)
> > 
> > diff --git a/Documentation/trace/kprobetrace.rst 
> > b/Documentation/trace/kprobetrace.rst
> > index c1709165c553..d29d1f9e6721 100644
> > --- a/Documentation/trace/kprobetrace.rst
> > +++ b/Documentation/trace/kprobetrace.rst
> 
> Check spacing:
> 
> > @@ -37,6 +38,7 @@ Synopsis of kprobe_events
> >   based on SYM+offs or MEMADDR.
> >   MOD   : Module name which has given SYM.
> >   SYM[+offs]: Symbol+offset where the probe is inserted.
> > + SYM%return : Return address of the symbol
> >   MEMADDR   : Address where the probe is inserted.
> >   MAXACTIVE : Maximum number of instances of the specified function that
> >   can be probed simultaneously, or 0 for the default value
> 
> If I remove the '+', the ':' lines up but the SYM does not line up.
> Am I missing something?
> 
> @@ -37,6 +38,7 @@ Synopsis of kprobe_events
> based on SYM+offs or MEMADDR.
>   MOD : Module name which has given SYM.
>   SYM[+offs]  : Symbol+offset where the probe is inserted.
>  SYM%return : Return address of the symbol
>   MEMADDR : Address where the probe is inserted.
>   MAXACTIVE   : Maximum number of instances of the specified function that
> can be probed simultaneously, or 0 for the default value
> 

Oops, that's my typo.

Thank you!

-- 
Masami Hiramatsu 


Re: [PATCH 5/6] Documentation: tracing: Add %return suffix description

2020-08-31 Thread Randy Dunlap
On 8/31/20 5:46 AM, Masami Hiramatsu wrote:
> Add a description of the %return suffix option for kprobe tracer.
> 
> Signed-off-by: Masami Hiramatsu 
> ---
>  Documentation/trace/kprobetrace.rst |2 ++
>  1 file changed, 2 insertions(+)
> 
> diff --git a/Documentation/trace/kprobetrace.rst 
> b/Documentation/trace/kprobetrace.rst
> index c1709165c553..d29d1f9e6721 100644
> --- a/Documentation/trace/kprobetrace.rst
> +++ b/Documentation/trace/kprobetrace.rst

Check spacing:

> @@ -37,6 +38,7 @@ Synopsis of kprobe_events
> based on SYM+offs or MEMADDR.
>   MOD : Module name which has given SYM.
>   SYM[+offs]  : Symbol+offset where the probe is inserted.
> + SYM%return : Return address of the symbol
>   MEMADDR : Address where the probe is inserted.
>   MAXACTIVE   : Maximum number of instances of the specified function that
> can be probed simultaneously, or 0 for the default value

If I remove the '+', the ':' lines up but the SYM does not line up.
Am I missing something?

@@ -37,6 +38,7 @@ Synopsis of kprobe_events
  based on SYM+offs or MEMADDR.
  MOD   : Module name which has given SYM.
  SYM[+offs]: Symbol+offset where the probe is inserted.
 SYM%return : Return address of the symbol
  MEMADDR   : Address where the probe is inserted.
  MAXACTIVE : Maximum number of instances of the specified function that
  can be probed simultaneously, or 0 for the default value


thanks.
-- 
~Randy



[PATCH 5/6] Documentation: tracing: Add %return suffix description

2020-08-31 Thread Masami Hiramatsu
Add a description of the %return suffix option for kprobe tracer.

Signed-off-by: Masami Hiramatsu 
---
 Documentation/trace/kprobetrace.rst |2 ++
 1 file changed, 2 insertions(+)

diff --git a/Documentation/trace/kprobetrace.rst 
b/Documentation/trace/kprobetrace.rst
index c1709165c553..d29d1f9e6721 100644
--- a/Documentation/trace/kprobetrace.rst
+++ b/Documentation/trace/kprobetrace.rst
@@ -30,6 +30,7 @@ Synopsis of kprobe_events
 
   p[:[GRP/]EVENT] [MOD:]SYM[+offs]|MEMADDR [FETCHARGS] : Set a probe
   r[MAXACTIVE][:[GRP/]EVENT] [MOD:]SYM[+0] [FETCHARGS] : Set a return probe
+  p:[GRP/]EVENT] [MOD:]SYM[+0]%return [FETCHARGS]  : Set a return probe
   -:[GRP/]EVENT: Clear a probe
 
  GRP   : Group name. If omitted, use "kprobes" for it.
@@ -37,6 +38,7 @@ Synopsis of kprobe_events
  based on SYM+offs or MEMADDR.
  MOD   : Module name which has given SYM.
  SYM[+offs]: Symbol+offset where the probe is inserted.
+ SYM%return : Return address of the symbol
  MEMADDR   : Address where the probe is inserted.
  MAXACTIVE : Maximum number of instances of the specified function that
  can be probed simultaneously, or 0 for the default value