From patchwork Thu Dec 21 15:09:23 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Steven Rostedt X-Patchwork-Id: 182289 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:2483:b0:fb:cd0c:d3e with SMTP id q3csp476467dyi; Thu, 21 Dec 2023 07:12:15 -0800 (PST) X-Google-Smtp-Source: AGHT+IFwdXLKH1xbJwsIQJwzXch1EcwUbg7GUWQ5hEI078mTYqtSRheFotVv1bY8QZ59NuBdjFTV X-Received: by 2002:a05:6808:2e48:b0:3bb:5d7f:1d0a with SMTP id gp8-20020a0568082e4800b003bb5d7f1d0amr4739803oib.86.1703171535210; Thu, 21 Dec 2023 07:12:15 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703171535; cv=none; d=google.com; s=arc-20160816; b=A2D9ZY4sGxT5xgt49EWvrlM+BO+1zuipdEt70TxXHgYZJMLEH+neft8upScRaON3bX qHbs9+P44Pi/n+OtbAuTR4T+W6nZs0TS/1PuzkK84W/9hxbn7FZrepggnUouS8+QI/PA TJmOpU2af2YEmfZkL/YwVjz62u8wR7ACJiF43juImTgscv6NPbSD1DfNxjUcqnshwOMg QpMq0JRGzYxS+tAhnpWGFeExW+cD0QXxOpJL2RYOlov+UfXwqGxTDar1MlB0nkxCg9d3 BEpb5nn6fcAFy3bv67d7K5wUBxNRMk89xnfX3JkTl2ccfmsHQieB2EAgm/A5XvALqKS3 EjkQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:list-unsubscribe:list-subscribe:list-id:precedence :references:subject:cc:to:from:date:user-agent:message-id; bh=W94AeR4vjIAjjO786taVkell5EWb6tp3VGAaOeMEAxY=; fh=vLBuawAV7E7Ty/f2EVtcMY6Amr7fIBhej5UPFEg4990=; b=sRcfaBfFjdVetatSL7AHHai8DLV8+ZhiR0wMzpZfo6fQ6tuQ3c38NqO35mCit4bapI M70DHrLuTR6qgqJ+I+Ilv8+Ds3/WEyVfSrI/vapo8HgkqoDs3KPFd1Vkqu5JkhhzrSKn TSwDj5Zvd7cQIA16Q0W/oBVw6qIY6mNs3+oyaQdltaSipJVThlrDwjnV6mJBsKq+MZYb 2vaMY50AuFSCGXAA4m6v1Abl8ehcKXGa8iTI4a0eTzQBLlWJWQ8rMDwzkGktZucd2bcV +XJKq1Vu6BRFY6CjMoHXiWGIsDEzwdGs0Y+9lB2v5kL663Zzs9cnsIfvMQ4e+luqUvMM BmJA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel+bounces-8623-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-8623-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id y23-20020a05610207d700b00466b59c2e7dsi298831vsg.736.2023.12.21.07.12.15 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 21 Dec 2023 07:12:15 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-8623-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel+bounces-8623-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-8623-ouuuleilei=gmail.com@vger.kernel.org" Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id E9E421C23E6D for ; Thu, 21 Dec 2023 15:12:14 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id C61AC55E53; Thu, 21 Dec 2023 15:11:31 +0000 (UTC) X-Original-To: linux-kernel@vger.kernel.org Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 509D6539E8 for ; Thu, 21 Dec 2023 15:11:30 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id D70FAC433CB; Thu, 21 Dec 2023 15:11:29 +0000 (UTC) Received: from rostedt by gandalf with local (Exim 4.97) (envelope-from ) id 1rGKiv-000000040VK-2JWM; Thu, 21 Dec 2023 10:12:33 -0500 Message-ID: <20231221151233.336510377@goodmis.org> User-Agent: quilt/0.67 Date: Thu, 21 Dec 2023 10:09:23 -0500 From: Steven Rostedt To: linux-kernel@vger.kernel.org Cc: Masami Hiramatsu , Mark Rutland , Mathieu Desnoyers , Andrew Morton , Randy Dunlap Subject: [for-linus][PATCH 1/3] tracing/synthetic: fix kernel-doc warnings References: <20231221150922.017965539@goodmis.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1785904795646137415 X-GMAIL-MSGID: 1785904795646137415 From: Randy Dunlap scripts/kernel-doc warns about using @args: for variadic arguments to functions. Documentation/doc-guide/kernel-doc.rst says that this should be written as @...: instead, so update the source code to match that, preventing the warnings. trace_events_synth.c:1165: warning: Excess function parameter 'args' description in '__synth_event_gen_cmd_start' trace_events_synth.c:1714: warning: Excess function parameter 'args' description in 'synth_event_trace' Link: https://lore.kernel.org/linux-trace-kernel/20231220061226.30962-1-rdunlap@infradead.org Cc: Mathieu Desnoyers Fixes: 35ca5207c2d11 ("tracing: Add synthetic event command generation functions") Fixes: 8dcc53ad956d2 ("tracing: Add synth_event_trace() and related functions") Acked-by: Masami Hiramatsu (Google) Signed-off-by: Randy Dunlap Signed-off-by: Steven Rostedt (Google) --- kernel/trace/trace_events_synth.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/kernel/trace/trace_events_synth.c b/kernel/trace/trace_events_synth.c index 846e02c0fb59..e7af286af4f1 100644 --- a/kernel/trace/trace_events_synth.c +++ b/kernel/trace/trace_events_synth.c @@ -1137,7 +1137,7 @@ EXPORT_SYMBOL_GPL(synth_event_add_fields); * @cmd: A pointer to the dynevent_cmd struct representing the new event * @name: The name of the synthetic event * @mod: The module creating the event, NULL if not created from a module - * @args: Variable number of arg (pairs), one pair for each field + * @...: Variable number of arg (pairs), one pair for each field * * NOTE: Users normally won't want to call this function directly, but * rather use the synth_event_gen_cmd_start() wrapper, which @@ -1695,7 +1695,7 @@ __synth_event_trace_end(struct synth_event_trace_state *trace_state) * synth_event_trace - Trace a synthetic event * @file: The trace_event_file representing the synthetic event * @n_vals: The number of values in vals - * @args: Variable number of args containing the event values + * @...: Variable number of args containing the event values * * Trace a synthetic event using the values passed in the variable * argument list.