From: Steven Rostedt <rostedt@goodmis.org>
To: Qiujun Huang <hqjagain@gmail.com>
Cc: mingo@redhat.com, linux-kernel@vger.kernel.org
Subject: Re: [PATCH] tracing: Update create_system_filter() kernel-doc comment
Date: Wed, 24 Mar 2021 20:56:42 -0400 [thread overview]
Message-ID: <20210324205642.65e03248@oasis.local.home> (raw)
In-Reply-To: <20210320113916.22175-1-hqjagain@gmail.com>
On Sat, 20 Mar 2021 11:39:16 +0000
Qiujun Huang <hqjagain@gmail.com> wrote:
> commit f306cc82a93d ("tracing: Update event filters for multibuffer")
> added the parameter @tr for create_system_filter().
>
> commit bb9ef1cb7d86 ("tracing: Change apply_subsystem_event_filter() paths to
> check file->system == dir")
> changed the parameter from @system to @dir.
>
> commit 1e144d73f729 ("tracing: Add trace_array parameter to
> create_event_filter()")
> added the parameter @tr for create_filter().
>
> Signed-off-by: Qiujun Huang <hqjagain@gmail.com>
> ---
> kernel/trace/trace_events_filter.c | 6 ++++--
> 1 file changed, 4 insertions(+), 2 deletions(-)
>
> diff --git a/kernel/trace/trace_events_filter.c b/kernel/trace/trace_events_filter.c
> index e91259f6a722..00e78a012de9 100644
> --- a/kernel/trace/trace_events_filter.c
> +++ b/kernel/trace/trace_events_filter.c
> @@ -1693,6 +1693,7 @@ static void create_filter_finish(struct filter_parse_error *pe)
>
> /**
> * create_filter - create a filter for a trace_event_call
> + * @tr: the trace array associated with these events
This looks fine.
> * @call: trace_event_call to create a filter for
> * @filter_str: filter string
> * @set_str: remember @filter_str and enable detailed error in filter
> @@ -1741,8 +1742,9 @@ int create_event_filter(struct trace_array *tr,
> }
>
> /**
> - * create_system_filter - create a filter for an event_subsystem
> - * @system: event_subsystem to create a filter for
> + * create_system_filter - create a filter for an event_subsystem_dir
Do you know what a "event_subsystem_dir" is? I don't.
In fact, the original text makes much more sense. You could remove the
"_" and have it say "event subsystem".
> + * @dir: event_subsystem_dir to create a filter for
I have no idea what the above text even means. @dir is the descriptor
for the system directory.
> + * @tr: the trace array associated with these events
> * @filter_str: filter string
> * @filterp: out param for created filter (always updated on return)
> *
Looking at the code I think it should have another clean up, as where
both @dir and @tr as passed it, it should just pass in @dir, because
@tr is simply @dir->tr.
-- Steve
next prev parent reply other threads:[~2021-03-25 0:57 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-03-20 11:39 [PATCH] tracing: Update create_system_filter() kernel-doc comment Qiujun Huang
2021-03-25 0:56 ` Steven Rostedt [this message]
2021-03-25 14:31 ` Qiujun Huang
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20210324205642.65e03248@oasis.local.home \
--to=rostedt@goodmis.org \
--cc=hqjagain@gmail.com \
--cc=linux-kernel@vger.kernel.org \
--cc=mingo@redhat.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).