* [PATCH v4] tools/lib/traceevent: Change description of few APIs
@ 2019-03-15 8:11 Tzvetomir Stoyanov
2019-03-18 21:03 ` Matt Helsley
0 siblings, 1 reply; 4+ messages in thread
From: Tzvetomir Stoyanov @ 2019-03-15 8:11 UTC (permalink / raw)
To: rostedt; +Cc: linux-trace-devel
APIs descriptions should describe the purpose of the
function, its parameters and return value. While working
on man pages implementation, I noticed mismatches in the
descriptions of few APIs. This patch changes the description
of these APIs, making them consistent with the man pages:
tep_print_num_field(), tep_print_func_field(),
tep_get_header_page_size(), tep_get_long_size(),
tep_set_long_size(), tep_get_page_size() and
tep_set_page_size().
Signed-off-by: Tzvetomir Stoyanov <tstoyanov@vmware.com>
---
tools/lib/traceevent/event-parse-api.c | 21 ++++++++++++---------
tools/lib/traceevent/event-parse.c | 4 ++--
2 files changed, 14 insertions(+), 11 deletions(-)
diff --git a/tools/lib/traceevent/event-parse-api.c b/tools/lib/traceevent/event-parse-api.c
index d4368dcc16ea..2d5d3642e3e9 100644
--- a/tools/lib/traceevent/event-parse-api.c
+++ b/tools/lib/traceevent/event-parse-api.c
@@ -100,10 +100,10 @@ tep_data2host8(struct tep_handle *pevent, unsigned long long data)
}
/**
- * tep_get_header_page_size - get size of the header page
+ * tep_get_header_page_size - get the size of a long integer, in kernel context
* @pevent: a handle to the tep_handle
*
- * This returns size of the header page
+ * This returns the size of a long integer, in kernel context
* If @pevent is NULL, 0 is returned.
*/
int tep_get_header_page_size(struct tep_handle *pevent)
@@ -140,10 +140,11 @@ void tep_set_cpus(struct tep_handle *pevent, int cpus)
}
/**
- * tep_get_long_size - get the size of a long integer on the current machine
+ * tep_get_long_size - get the size of a long integer on the traced machine
* @pevent: a handle to the tep_handle
*
- * This returns the size of a long integer on the current machine
+ * This returns the size of a long integer on the machine,
+ * where the trace is generated
* If @pevent is NULL, 0 is returned.
*/
int tep_get_long_size(struct tep_handle *pevent)
@@ -154,7 +155,7 @@ int tep_get_long_size(struct tep_handle *pevent)
}
/**
- * tep_set_long_size - set the size of a long integer on the current machine
+ * tep_set_long_size - set the size of a long integer on the traced machine
* @pevent: a handle to the tep_handle
* @size: size, in bytes, of a long integer
*
@@ -167,10 +168,11 @@ void tep_set_long_size(struct tep_handle *pevent, int long_size)
}
/**
- * tep_get_page_size - get the size of a memory page on the current machine
+ * tep_get_page_size - get the size of a memory page on the traced machine
* @pevent: a handle to the tep_handle
*
- * This returns the size of a memory page on the current machine
+ * This returns the size of a memory page on the machine,
+ * where the trace is generated
* If @pevent is NULL, 0 is returned.
*/
int tep_get_page_size(struct tep_handle *pevent)
@@ -181,11 +183,12 @@ int tep_get_page_size(struct tep_handle *pevent)
}
/**
- * tep_set_page_size - set the size of a memory page on the current machine
+ * tep_set_page_size - set the size of a memory page on the traced machine
* @pevent: a handle to the tep_handle
* @_page_size: size of a memory page, in bytes
*
- * This sets the size of a memory page on the current machine
+ * This sets the size of a memory page on the machine,
+ * where the trace is generated
*/
void tep_set_page_size(struct tep_handle *pevent, int _page_size)
{
diff --git a/tools/lib/traceevent/event-parse.c b/tools/lib/traceevent/event-parse.c
index 8f6ff7e0b51e..e6c7dcc5f3ee 100644
--- a/tools/lib/traceevent/event-parse.c
+++ b/tools/lib/traceevent/event-parse.c
@@ -6441,7 +6441,7 @@ int tep_get_any_field_val(struct trace_seq *s, struct tep_event *event,
* @record: The record with the field name.
* @err: print default error if failed.
*
- * Returns: 0 on success, -1 field not found, or 1 if buffer is full.
+ * Returns: 1 on success, -1 field not found, or 0 if buffer is full.
*/
int tep_print_num_field(struct trace_seq *s, const char *fmt,
struct tep_event *event, const char *name,
@@ -6473,7 +6473,7 @@ int tep_print_num_field(struct trace_seq *s, const char *fmt,
* @record: The record with the field name.
* @err: print default error if failed.
*
- * Returns: 0 on success, -1 field not found, or 1 if buffer is full.
+ * Returns: 1 on success, -1 field not found, or 0 if buffer is full.
*/
int tep_print_func_field(struct trace_seq *s, const char *fmt,
struct tep_event *event, const char *name,
--
2.20.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH v4] tools/lib/traceevent: Change description of few APIs
2019-03-15 8:11 [PATCH v4] tools/lib/traceevent: Change description of few APIs Tzvetomir Stoyanov
@ 2019-03-18 21:03 ` Matt Helsley
2019-03-19 10:35 ` Tzvetomir Stoyanov
0 siblings, 1 reply; 4+ messages in thread
From: Matt Helsley @ 2019-03-18 21:03 UTC (permalink / raw)
To: Tzvetomir Stoyanov; +Cc: Steven Rostedt, linux-trace-devel
> On Mar 15, 2019, at 1:11 AM, Tzvetomir Stoyanov <tstoyanov@vmware.com> wrote:
>
> APIs descriptions should describe the purpose of the
> function, its parameters and return value. While working
> on man pages implementation, I noticed mismatches in the
> descriptions of few APIs. This patch changes the description
> of these APIs, making them consistent with the man pages:
> tep_print_num_field(), tep_print_func_field(),
> tep_get_header_page_size(), tep_get_long_size(),
> tep_set_long_size(), tep_get_page_size() and
> tep_set_page_size().
>
> Signed-off-by: Tzvetomir Stoyanov <tstoyanov@vmware.com>
> ---
> tools/lib/traceevent/event-parse-api.c | 21 ++++++++++++---------
> tools/lib/traceevent/event-parse.c | 4 ++--
> 2 files changed, 14 insertions(+), 11 deletions(-)
>
> diff --git a/tools/lib/traceevent/event-parse-api.c b/tools/lib/traceevent/event-parse-api.c
> index d4368dcc16ea..2d5d3642e3e9 100644
> --- a/tools/lib/traceevent/event-parse-api.c
> +++ b/tools/lib/traceevent/event-parse-api.c
> @@ -100,10 +100,10 @@ tep_data2host8(struct tep_handle *pevent, unsigned long long data)
> }
>
> /**
> - * tep_get_header_page_size - get size of the header page
> + * tep_get_header_page_size - get the size of a long integer, in kernel context
Just want to check If this comment change correct. Given the function name it looks a bit odd compared to the comment for tep_get_long_size().
> * @pevent: a handle to the tep_handle
> *
> - * This returns size of the header page
> + * This returns the size of a long integer, in kernel context
> * If @pevent is NULL, 0 is returned.
> */
> int tep_get_header_page_size(struct tep_handle *pevent)
> @@ -140,10 +140,11 @@ void tep_set_cpus(struct tep_handle *pevent, int cpus)
> }
>
> /**
> - * tep_get_long_size - get the size of a long integer on the current machine
> + * tep_get_long_size - get the size of a long integer on the traced machine
> * @pevent: a handle to the tep_handle
> *
> - * This returns the size of a long integer on the current machine
> + * This returns the size of a long integer on the machine,
> + * where the trace is generated
> * If @pevent is NULL, 0 is returned.
> */
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH v4] tools/lib/traceevent: Change description of few APIs
2019-03-18 21:03 ` Matt Helsley
@ 2019-03-19 10:35 ` Tzvetomir Stoyanov
2019-03-19 16:43 ` Steven Rostedt
0 siblings, 1 reply; 4+ messages in thread
From: Tzvetomir Stoyanov @ 2019-03-19 10:35 UTC (permalink / raw)
To: Matt Helsley; +Cc: Steven Rostedt, linux-trace-devel
On Mon, Mar 18, 2019 at 11:03 PM Matt Helsley <mhelsley@vmware.com> wrote:
>
>
>
> > On Mar 15, 2019, at 1:11 AM, Tzvetomir Stoyanov <tstoyanov@vmware.com> wrote:
> >
> > APIs descriptions should describe the purpose of the
> > function, its parameters and return value. While working
> > on man pages implementation, I noticed mismatches in the
> > descriptions of few APIs. This patch changes the description
> > of these APIs, making them consistent with the man pages:
> > tep_print_num_field(), tep_print_func_field(),
> > tep_get_header_page_size(), tep_get_long_size(),
> > tep_set_long_size(), tep_get_page_size() and
> > tep_set_page_size().
> >
> > Signed-off-by: Tzvetomir Stoyanov <tstoyanov@vmware.com>
> > ---
> > tools/lib/traceevent/event-parse-api.c | 21 ++++++++++++---------
> > tools/lib/traceevent/event-parse.c | 4 ++--
> > 2 files changed, 14 insertions(+), 11 deletions(-)
> >
> > diff --git a/tools/lib/traceevent/event-parse-api.c b/tools/lib/traceevent/event-parse-api.c
> > index d4368dcc16ea..2d5d3642e3e9 100644
> > --- a/tools/lib/traceevent/event-parse-api.c
> > +++ b/tools/lib/traceevent/event-parse-api.c
> > @@ -100,10 +100,10 @@ tep_data2host8(struct tep_handle *pevent, unsigned long long data)
> > }
> >
> > /**
> > - * tep_get_header_page_size - get size of the header page
> > + * tep_get_header_page_size - get the size of a long integer, in kernel context
>
> Just want to check If this comment change correct. Given the function name it looks a bit odd compared to the comment for tep_get_long_size().
It is a copy / paste error,
Thanks Matt
>
> > * @pevent: a handle to the tep_handle
> > *
> > - * This returns size of the header page
> > + * This returns the size of a long integer, in kernel context
> > * If @pevent is NULL, 0 is returned.
> > */
> > int tep_get_header_page_size(struct tep_handle *pevent)
> > @@ -140,10 +140,11 @@ void tep_set_cpus(struct tep_handle *pevent, int cpus)
> > }
> >
> > /**
> > - * tep_get_long_size - get the size of a long integer on the current machine
> > + * tep_get_long_size - get the size of a long integer on the traced machine
> > * @pevent: a handle to the tep_handle
> > *
> > - * This returns the size of a long integer on the current machine
> > + * This returns the size of a long integer on the machine,
> > + * where the trace is generated
> > * If @pevent is NULL, 0 is returned.
> > */
--
Tzvetomir (Ceco) Stoyanov
VMware Open Source Technology Center
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH v4] tools/lib/traceevent: Change description of few APIs
2019-03-19 10:35 ` Tzvetomir Stoyanov
@ 2019-03-19 16:43 ` Steven Rostedt
0 siblings, 0 replies; 4+ messages in thread
From: Steven Rostedt @ 2019-03-19 16:43 UTC (permalink / raw)
To: Tzvetomir Stoyanov; +Cc: Matt Helsley, linux-trace-devel
On Tue, 19 Mar 2019 10:35:05 +0000
Tzvetomir Stoyanov <tstoyanov@vmware.com> wrote:
> On Mon, Mar 18, 2019 at 11:03 PM Matt Helsley <mhelsley@vmware.com> wrote:
> >
> >
> >
> > > On Mar 15, 2019, at 1:11 AM, Tzvetomir Stoyanov <tstoyanov@vmware.com> wrote:
> > >
> > > APIs descriptions should describe the purpose of the
> > > function, its parameters and return value. While working
> > > on man pages implementation, I noticed mismatches in the
> > > descriptions of few APIs. This patch changes the description
> > > of these APIs, making them consistent with the man pages:
> > > tep_print_num_field(), tep_print_func_field(),
> > > tep_get_header_page_size(), tep_get_long_size(),
> > > tep_set_long_size(), tep_get_page_size() and
> > > tep_set_page_size().
> > >
> > > Signed-off-by: Tzvetomir Stoyanov <tstoyanov@vmware.com>
> > > ---
> > > tools/lib/traceevent/event-parse-api.c | 21 ++++++++++++---------
> > > tools/lib/traceevent/event-parse.c | 4 ++--
> > > 2 files changed, 14 insertions(+), 11 deletions(-)
> > >
> > > diff --git a/tools/lib/traceevent/event-parse-api.c b/tools/lib/traceevent/event-parse-api.c
> > > index d4368dcc16ea..2d5d3642e3e9 100644
> > > --- a/tools/lib/traceevent/event-parse-api.c
> > > +++ b/tools/lib/traceevent/event-parse-api.c
> > > @@ -100,10 +100,10 @@ tep_data2host8(struct tep_handle *pevent, unsigned long long data)
> > > }
> > >
> > > /**
> > > - * tep_get_header_page_size - get size of the header page
> > > + * tep_get_header_page_size - get the size of a long integer, in kernel context
> >
> > Just want to check If this comment change correct. Given the function name it looks a bit odd compared to the comment for tep_get_long_size().
>
> It is a copy / paste error,
Hmm, the function name is very confusing, as it is returning the kernel
context long size. Perhaps we should rename it to:
tep_get_header_long_size()
-- Steve
> Thanks Matt
>
>
> >
> > > * @pevent: a handle to the tep_handle
> > > *
> > > - * This returns size of the header page
> > > + * This returns the size of a long integer, in kernel context
> > > * If @pevent is NULL, 0 is returned.
> > > */
> > > int tep_get_header_page_size(struct tep_handle *pevent)
> > > @@ -140,10 +140,11 @@ void tep_set_cpus(struct tep_handle *pevent, int cpus)
> > > }
> > >
> > > /**
> > > - * tep_get_long_size - get the size of a long integer on the current machine
> > > + * tep_get_long_size - get the size of a long integer on the traced machine
> > > * @pevent: a handle to the tep_handle
> > > *
> > > - * This returns the size of a long integer on the current machine
> > > + * This returns the size of a long integer on the machine,
> > > + * where the trace is generated
> > > * If @pevent is NULL, 0 is returned.
> > > */
>
>
>
> --
>
> Tzvetomir (Ceco) Stoyanov
> VMware Open Source Technology Center
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2019-03-19 16:43 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-03-15 8:11 [PATCH v4] tools/lib/traceevent: Change description of few APIs Tzvetomir Stoyanov
2019-03-18 21:03 ` Matt Helsley
2019-03-19 10:35 ` Tzvetomir Stoyanov
2019-03-19 16:43 ` Steven Rostedt
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.