From patchwork Sat Jul 29 18:33:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Steven Rostedt X-Patchwork-Id: 128169 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:918b:0:b0:3e4:2afc:c1 with SMTP id s11csp1178965vqg; Sat, 29 Jul 2023 12:16:49 -0700 (PDT) X-Google-Smtp-Source: APBJJlFsLZHfndG4bVAN6ie4OywsW5LmjdwBiVG/RnqD+ouCfy22Vt8NjU2iWtXOR+EGEVdDmbtW X-Received: by 2002:a17:90a:94c2:b0:263:40e1:d4d9 with SMTP id j2-20020a17090a94c200b0026340e1d4d9mr5086110pjw.47.1690658209245; Sat, 29 Jul 2023 12:16:49 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1690658209; cv=none; d=google.com; s=arc-20160816; b=PoDqfAb/cIBLZH0AUHOFzdbKTtaXw2VkCM7tVrT9nv6AixvFp8gOEv6ZVW2z730iX6 eYq5sk6GX6MwKNO4N4XqElZVzLUwjoas8+COLFmK3BBkuyWqSe4vw7MtCrw8Weqw0ZuD bfLS2VkyjLjDyu8p44x0A38hUJ2KInSPylQuyps5RNL5PLsKY9KEy4kYcuCPOltLPDUA Em6m+XUU2XuLk32ePLkCpCf26eBKJ6iNM+EbTCF48Kgvq1D8kd1zLj8iSMDMLov8324N 0B4I6FA7u6OgIKVLNkqT0s2WhKbJw64GFNutJg9jTL0oAqIMptQGahh4sbe5VYCRBwO8 fEyA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:references:subject:cc:to:from:date :user-agent:message-id; bh=JmvmBQVrfheAjrdOn88XziKMzMPwznQEQkDGKveBm2k=; fh=mQvw8ETxqMNxI20RcI1leTTVW928YS5jvnmrHbcxzT0=; b=VZoY+ELfw6BDRvJfG+MaFDOCXYwI2Y2+j9HA/v8BYyJ3C+k5qVktCLdYg0cgia4bzd RxCFU49dAZokGgAcqJZk1G/4mHarfwH/25vppKjr9LX4aJtmTn9HmcI8k4Dtw59XjowK IIvkFY9OTzeC4u71714Tq3hDUKyTWa5gIdH0/+DofFVxh4B5Hzx9p/0jATCpTKkZp8jP ofptzmDpDLlxcP+OZeJsisHpvYS22kmJ1mGAhR5FdBfss6MuVdNKBSSRut6r3FIwyBiw viXz57uRx1K0BVieBquP8Lv/zGIuctmWLScQYHwVqWU0wTRixaQYMHY+hsD4sIM3/IMH nf7w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id pi10-20020a17090b1e4a00b00263c48abf8asi6790497pjb.31.2023.07.29.12.16.36; Sat, 29 Jul 2023 12:16:49 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229843AbjG2Se3 (ORCPT + 99 others); Sat, 29 Jul 2023 14:34:29 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43102 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229627AbjG2SeZ (ORCPT ); Sat, 29 Jul 2023 14:34:25 -0400 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 706CF3580 for ; Sat, 29 Jul 2023 11:34:23 -0700 (PDT) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by dfw.source.kernel.org (Postfix) with ESMTPS id F0F556092A for ; Sat, 29 Jul 2023 18:34:22 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 648C4C433CA; Sat, 29 Jul 2023 18:34:22 +0000 (UTC) Received: from rostedt by gandalf with local (Exim 4.96) (envelope-from ) id 1qPolh-0035J1-1Q; Sat, 29 Jul 2023 14:34:21 -0400 Message-ID: <20230729183421.257956360@goodmis.org> User-Agent: quilt/0.66 Date: Sat, 29 Jul 2023 14:33:35 -0400 From: Steven Rostedt To: linux-kernel@vger.kernel.org Cc: Masami Hiramatsu , Mark Rutland , Andrew Morton , Gaosheng Cui Subject: [for-linus][PATCH 2/7] ring-buffer: Fix kernel-doc warnings in ring_buffer.c References: <20230729183333.357029101@goodmis.org> MIME-Version: 1.0 X-Spam-Status: No, score=-6.7 required=5.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,RCVD_IN_DNSWL_HI,SPF_HELO_NONE,SPF_PASS, T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1772783622385419016 X-GMAIL-MSGID: 1772783622385419016 From: Gaosheng Cui Fix kernel-doc warnings: kernel/trace/ring_buffer.c:954: warning: Function parameter or member 'cpu' not described in 'ring_buffer_wake_waiters' kernel/trace/ring_buffer.c:3383: warning: Excess function parameter 'event' description in 'ring_buffer_unlock_commit' kernel/trace/ring_buffer.c:5359: warning: Excess function parameter 'cpu' description in 'ring_buffer_reset_online_cpus' Link: https://lkml.kernel.org/r/20230724140827.1023266-2-cuigaosheng1@huawei.com Cc: Signed-off-by: Gaosheng Cui Signed-off-by: Steven Rostedt (Google) --- kernel/trace/ring_buffer.c | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/kernel/trace/ring_buffer.c b/kernel/trace/ring_buffer.c index 46b4a3c7c3bf..52dea5dd5362 100644 --- a/kernel/trace/ring_buffer.c +++ b/kernel/trace/ring_buffer.c @@ -950,6 +950,7 @@ static void rb_wake_up_waiters(struct irq_work *work) /** * ring_buffer_wake_waiters - wake up any waiters on this ring buffer * @buffer: The ring buffer to wake waiters on + * @cpu: The CPU buffer to wake waiters on * * In the case of a file that represents a ring buffer is closing, * it is prudent to wake up any waiters that are on this. @@ -3375,7 +3376,6 @@ void ring_buffer_nest_end(struct trace_buffer *buffer) /** * ring_buffer_unlock_commit - commit a reserved * @buffer: The buffer to commit to - * @event: The event pointer to commit. * * This commits the data to the ring buffer, and releases any locks held. * @@ -5358,7 +5358,6 @@ EXPORT_SYMBOL_GPL(ring_buffer_reset_cpu); /** * ring_buffer_reset_online_cpus - reset a ring buffer per CPU buffer * @buffer: The ring buffer to reset a per cpu buffer of - * @cpu: The CPU buffer to be reset */ void ring_buffer_reset_online_cpus(struct trace_buffer *buffer) {