Message ID | 20221025060333.4295-1-liubo03@inspur.com |
---|---|
State | New |
Headers |
Return-Path: <linux-kernel-owner@vger.kernel.org> Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp834928wru; Mon, 24 Oct 2022 23:17:30 -0700 (PDT) X-Google-Smtp-Source: AMsMyM4Bzh9bWyjVxirvMJOfF63dZ6BVtnA70YSuTXRJinXv+uQfKlBFd3mqv8YD+X//l9uhBDnO X-Received: by 2002:a65:4c0e:0:b0:46a:eeb1:e78a with SMTP id u14-20020a654c0e000000b0046aeeb1e78amr31600806pgq.193.1666678650465; Mon, 24 Oct 2022 23:17:30 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666678650; cv=none; d=google.com; s=arc-20160816; b=AKBw2mw7udtZGaVMENribXT2n4RaqqQ2xkJsk5hCzSLPDkft+qpZzCVyKvd72k3gT6 SIZLSsXggAJheT8F8W+FV/hebv7ME9oUjhd6I8TTexQCU5zCETxXyOGJcSszcVi5nOKJ LcZo388qMq7FawzOBrDmKBtWpbW2VvtzYYEl+7wob4+xt7Fh3STc6mhDD/FnVDkPyTRx 4x0d9lon5MNo7lZD3gOy2FbmHlDkld92GOcCfCbIiMcS4W4On2eu3Rfvf8ACD1Zjyljf uCWlwWDSvcTIUELlycmDvbwt1lsZyT2HQEL84Q8S8EcPPziUfbLAFsZEBuIYq3Obe7UM Y9ew== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:abuse-reports-to:tuid:mime-version:message-id :date:subject:cc:to:from; bh=jCwF0YFxNhlJx1S6LQ+d/CnIwaXbFsNUT0vwYrIMDvw=; b=hzE8O5dC4IOdZkiEWYMjpFDqY+zyZ6pCNKDUinkuxL1h+dxjIJJwHiG4EPfUgCTOYT Zl/JR1oCpKoQQ9HHVF0ahTkOrMrjhwbV+a4i6w/DiXA5uqlOW+6dyfiAMnn7Mbu2J5xw FMyjCPFZdX4fVfSN9kjnOJv4/MOquW8t7ot21NqfIJSoZoBekrXKJhR+makhpteD3XQZ A1fNE23YiKxNLYZUi23JBQ9V/ZCtkpX4MxMer811Mn8DJGVDk/8vAuk93tIv/OZpjl7R +IfEShsjdJV0eCZ0QIsIIMxn5sEtzLcHY6an5S/VO6N92IwQ9hY0LhPUux/F3DNphumY 7PSw== 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 i7-20020a17090aee8700b0020d67aeb299si10400291pjz.53.2022.10.24.23.17.16; Mon, 24 Oct 2022 23:17:30 -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 S230292AbiJYGEB (ORCPT <rfc822;pwkd43@gmail.com> + 99 others); Tue, 25 Oct 2022 02:04:01 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:44004 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229535AbiJYGEA (ORCPT <rfc822;linux-kernel@vger.kernel.org>); Tue, 25 Oct 2022 02:04:00 -0400 Received: from ssh248.corpemail.net (ssh248.corpemail.net [210.51.61.248]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 9620C10692D; Mon, 24 Oct 2022 23:03:57 -0700 (PDT) Received: from ([60.208.111.195]) by ssh248.corpemail.net ((D)) with ASMTP (SSL) id TGC00050; Tue, 25 Oct 2022 14:03:50 +0800 Received: from localhost.localdomain (10.200.104.97) by jtjnmail201608.home.langchao.com (10.100.2.8) with Microsoft SMTP Server id 15.1.2507.12; Tue, 25 Oct 2022 14:03:44 +0800 From: Bo Liu <liubo03@inspur.com> To: <paul@paul-moore.com>, <jmorris@namei.org>, <serge@hallyn.com> CC: <linux-security-module@vger.kernel.org>, <linux-kernel@vger.kernel.org>, Bo Liu <liubo03@inspur.com> Subject: [PATCH] audit: Fix some kernel-doc warnings Date: Tue, 25 Oct 2022 02:03:33 -0400 Message-ID: <20221025060333.4295-1-liubo03@inspur.com> X-Mailer: git-send-email 2.18.2 MIME-Version: 1.0 Content-Type: text/plain X-Originating-IP: [10.200.104.97] tUid: 2022102514035055d23a6c1e63b313281baf30bfa3057f X-Abuse-Reports-To: service@corp-email.com Abuse-Reports-To: service@corp-email.com X-Complaints-To: service@corp-email.com X-Report-Abuse-To: service@corp-email.com X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,SPF_HELO_NONE, SPF_PASS 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: <linux-kernel.vger.kernel.org> X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1747639232615545210?= X-GMAIL-MSGID: =?utf-8?q?1747639232615545210?= |
Series |
audit: Fix some kernel-doc warnings
|
|
Commit Message
Bo Liu
Oct. 25, 2022, 6:03 a.m. UTC
The current code provokes some kernel-doc warnings:
security/lsm_audit.c:198: warning: Function parameter or member 'ab' not described in 'dump_common_audit_data'
Signed-off-by: Bo Liu <liubo03@inspur.com>
---
security/lsm_audit.c | 1 +
1 file changed, 1 insertion(+)
Comments
On 10/24/22 23:03, Bo Liu wrote: > The current code provokes some kernel-doc warnings: > security/lsm_audit.c:198: warning: Function parameter or member 'ab' not described in 'dump_common_audit_data' > > Signed-off-by: Bo Liu <liubo03@inspur.com> Acked-by: Randy Dunlap <rdunlap@infradead.org> Thanks. > --- > security/lsm_audit.c | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/security/lsm_audit.c b/security/lsm_audit.c > index 75cc3f8d2a42..ea5d35dce674 100644 > --- a/security/lsm_audit.c > +++ b/security/lsm_audit.c > @@ -190,6 +190,7 @@ static inline void print_ipv4_addr(struct audit_buffer *ab, __be32 addr, > > /** > * dump_common_audit_data - helper to dump common audit data > + * @ab : the audit data to fill > * @a : common audit data > * > */
On Tue, Oct 25, 2022 at 2:04 AM Bo Liu <liubo03@inspur.com> wrote: > > The current code provokes some kernel-doc warnings: > security/lsm_audit.c:198: warning: Function parameter or member 'ab' not described in 'dump_common_audit_data' > > Signed-off-by: Bo Liu <liubo03@inspur.com> > --- > security/lsm_audit.c | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/security/lsm_audit.c b/security/lsm_audit.c > index 75cc3f8d2a42..ea5d35dce674 100644 > --- a/security/lsm_audit.c > +++ b/security/lsm_audit.c > @@ -190,6 +190,7 @@ static inline void print_ipv4_addr(struct audit_buffer *ab, __be32 addr, > > /** > * dump_common_audit_data - helper to dump common audit data > + * @ab : the audit data to fill When we need to comment on audit_buffer structs we usually refer to it as "the audit buffer" or similar, e.g. kernel/audit*, and in lsm_audit.c the term "audit data to fill" is typically used by the common_audit_data struct. Please update this patch to something like the following: /** * ... * @ab: the audit buffer * ... */ > * @a : common audit data > * > */
diff --git a/security/lsm_audit.c b/security/lsm_audit.c index 75cc3f8d2a42..ea5d35dce674 100644 --- a/security/lsm_audit.c +++ b/security/lsm_audit.c @@ -190,6 +190,7 @@ static inline void print_ipv4_addr(struct audit_buffer *ab, __be32 addr, /** * dump_common_audit_data - helper to dump common audit data + * @ab : the audit data to fill * @a : common audit data * */