aboutsummaryrefslogtreecommitdiffstats
path: root/tools/lib/traceevent/event-parse-api.c
diff options
context:
space:
mode:
authorTzvetomir Stoyanov <tstoyanov@vmware.com>2019-04-01 12:43:10 -0400
committerArnaldo Carvalho de Melo <acme@redhat.com>2019-04-01 14:18:09 -0400
commit489b34948cbbc725755e1b1125dbdb16401eea07 (patch)
tree1f12a28b0e38cf452fbc7524d216bad4f29bc151 /tools/lib/traceevent/event-parse-api.c
parent70df6a7311186a7ab0b19f481dee4ca540a73837 (diff)
tools lib traceevent: Change description of few APIs
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() - tep_set_page_size() Signed-off-by: Tzvetomir Stoyanov <tstoyanov@vmware.com> Cc: Andrew Morton <akpm@linux-foundation.org> Cc: Jiri Olsa <jolsa@redhat.com> Cc: Namhyung Kim <namhyung@kernel.org> Link: http://lore.kernel.org/linux-trace-devel/20190325145017.30246-2-tstoyanov@vmware.com Link: http://lkml.kernel.org/r/20190401164343.396759247@goodmis.org Signed-off-by: Steven Rostedt (VMware) <rostedt@goodmis.org> Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
Diffstat (limited to 'tools/lib/traceevent/event-parse-api.c')
-rw-r--r--tools/lib/traceevent/event-parse-api.c20
1 files changed, 10 insertions, 10 deletions
diff --git a/tools/lib/traceevent/event-parse-api.c b/tools/lib/traceevent/event-parse-api.c
index d463761a58f4..3686a221e981 100644
--- a/tools/lib/traceevent/event-parse-api.c
+++ b/tools/lib/traceevent/event-parse-api.c
@@ -43,8 +43,8 @@ int tep_get_events_count(struct tep_handle *tep)
43 * @flag: flag, or combination of flags to be set 43 * @flag: flag, or combination of flags to be set
44 * can be any combination from enum tep_flag 44 * can be any combination from enum tep_flag
45 * 45 *
46 * This sets a flag or mbination of flags from enum tep_flag 46 * This sets a flag or combination of flags from enum tep_flag
47 */ 47 */
48void tep_set_flag(struct tep_handle *tep, int flag) 48void tep_set_flag(struct tep_handle *tep, int flag)
49{ 49{
50 if(tep) 50 if(tep)
@@ -140,10 +140,10 @@ void tep_set_cpus(struct tep_handle *pevent, int cpus)
140} 140}
141 141
142/** 142/**
143 * tep_get_long_size - get the size of a long integer on the current machine 143 * tep_get_long_size - get the size of a long integer on the traced machine
144 * @pevent: a handle to the tep_handle 144 * @pevent: a handle to the tep_handle
145 * 145 *
146 * This returns the size of a long integer on the current machine 146 * This returns the size of a long integer on the traced machine
147 * If @pevent is NULL, 0 is returned. 147 * If @pevent is NULL, 0 is returned.
148 */ 148 */
149int tep_get_long_size(struct tep_handle *pevent) 149int tep_get_long_size(struct tep_handle *pevent)
@@ -154,11 +154,11 @@ int tep_get_long_size(struct tep_handle *pevent)
154} 154}
155 155
156/** 156/**
157 * tep_set_long_size - set the size of a long integer on the current machine 157 * tep_set_long_size - set the size of a long integer on the traced machine
158 * @pevent: a handle to the tep_handle 158 * @pevent: a handle to the tep_handle
159 * @size: size, in bytes, of a long integer 159 * @size: size, in bytes, of a long integer
160 * 160 *
161 * This sets the size of a long integer on the current machine 161 * This sets the size of a long integer on the traced machine
162 */ 162 */
163void tep_set_long_size(struct tep_handle *pevent, int long_size) 163void tep_set_long_size(struct tep_handle *pevent, int long_size)
164{ 164{
@@ -167,10 +167,10 @@ void tep_set_long_size(struct tep_handle *pevent, int long_size)
167} 167}
168 168
169/** 169/**
170 * tep_get_page_size - get the size of a memory page on the current machine 170 * tep_get_page_size - get the size of a memory page on the traced machine
171 * @pevent: a handle to the tep_handle 171 * @pevent: a handle to the tep_handle
172 * 172 *
173 * This returns the size of a memory page on the current machine 173 * This returns the size of a memory page on the traced machine
174 * If @pevent is NULL, 0 is returned. 174 * If @pevent is NULL, 0 is returned.
175 */ 175 */
176int tep_get_page_size(struct tep_handle *pevent) 176int tep_get_page_size(struct tep_handle *pevent)
@@ -181,11 +181,11 @@ int tep_get_page_size(struct tep_handle *pevent)
181} 181}
182 182
183/** 183/**
184 * tep_set_page_size - set the size of a memory page on the current machine 184 * tep_set_page_size - set the size of a memory page on the traced machine
185 * @pevent: a handle to the tep_handle 185 * @pevent: a handle to the tep_handle
186 * @_page_size: size of a memory page, in bytes 186 * @_page_size: size of a memory page, in bytes
187 * 187 *
188 * This sets the size of a memory page on the current machine 188 * This sets the size of a memory page on the traced machine
189 */ 189 */
190void tep_set_page_size(struct tep_handle *pevent, int _page_size) 190void tep_set_page_size(struct tep_handle *pevent, int _page_size)
191{ 191{