Received: by 2002:a05:7412:251c:b0:e2:908c:2ebd with SMTP id w28csp945674rda; Sun, 22 Oct 2023 18:12:04 -0700 (PDT) X-Google-Smtp-Source: AGHT+IGiF0CoUE0Lh4t07CF77AjZr1ZLldDIBpJfl/niqPps1bedKcNJoK5b1gLr1iIBh8qp0eQf X-Received: by 2002:a17:902:ed55:b0:1c5:b4a1:ff6 with SMTP id y21-20020a170902ed5500b001c5b4a10ff6mr5608276plb.45.1698023524608; Sun, 22 Oct 2023 18:12:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698023524; cv=none; d=google.com; s=arc-20160816; b=pjjEG26u1IJ/MMQkEMIRotsg0RC8X5AmeHqjl5fAfDJAbymqxzBSw1N7wb6w9UrPpL 60vrlcPhH8mzYX+H+7e2td3iHb93U2khXQQ6RLkInnYNbI5tlX0xLYemx9VepMA4Nf6v MhNwQTbQ/9T11rG+1YGzt91SHmQiXriVUga8F4FAG8lR5+RXulxpKq+qZKx5UZ0Yzung NY8jjaOUTbxOKlNSE4L0BUWZuaab4qF+vEZbbn2q3y2HSPqay7I8F/xwMWJl3SDQB/UJ Kk3RVyJEUwApQqN9hSBGc+YesJ9uUcP5tOdALUIYiJ/Krqhax5tH9QZGhZGeKdG6J7W7 vNyA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=IAxOlcwRqFja+TOdqhn1u61E28quyDBEDIb2nRM9OUw=; fh=CsrrSYuaOy6XOars/dGdvSnPykGebxMPWt+wbxMWbTM=; b=qciySiq8pWjiOM2lEeuZrIJhQCJ547eITS0mgjXtokoc2FF8gic2ZNo3tddLql0/ZB dFKklDEYzp9Xb5VaK+gMN5lmUq5ZYGBHItuD5MY3gj0QUDYhtm5dTTikxwMf3l6PuMIk EliqFHNmckCmAY7c3VyVgFk+iOBX0qbDFvKK7XVlkyCXnn787lhuGAq/amn88IWpmfOh CjJwB5sHjVkgkAbGyRbNGQPB9G1TvmOc2yQpk4rvbDZKoqUCHGGZ11TlSNUw8q1J26+R qjktx0JgPHn/8IkAgIk6Fu0FT4TnztwWMPEOYqnDVUwHikWOmkowOWISxh/nS/x5tOQd msuQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from morse.vger.email (morse.vger.email. [2620:137:e000::3:1]) by mx.google.com with ESMTPS id b4-20020a170902d30400b001bbabd5b14esi5212354plc.608.2023.10.22.18.12.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Oct 2023 18:12:04 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) client-ip=2620:137:e000::3:1; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by morse.vger.email (Postfix) with ESMTP id 7C5188075DE5; Sun, 22 Oct 2023 18:11:58 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at morse.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232985AbjJWBLh (ORCPT + 99 others); Sun, 22 Oct 2023 21:11:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49482 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232970AbjJWBLe (ORCPT ); Sun, 22 Oct 2023 21:11:34 -0400 Received: from out30-124.freemail.mail.aliyun.com (out30-124.freemail.mail.aliyun.com [115.124.30.124]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CD0C6ED; Sun, 22 Oct 2023 18:11:31 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R291e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018046051;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=9;SR=0;TI=SMTPD_---0Vucq0b9_1698023488; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0Vucq0b9_1698023488) by smtp.aliyun-inc.com; Mon, 23 Oct 2023 09:11:28 +0800 From: Yang Li To: john.johansen@canonical.com, paul@paul-moore.com, jmorris@namei.org, serge@hallyn.com Cc: apparmor@lists.ubuntu.com, linux-security-module@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next 2/2] apparmor: Fix some kernel-doc comments Date: Mon, 23 Oct 2023 09:11:24 +0800 Message-Id: <20231023011124.19034-2-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c In-Reply-To: <20231023011124.19034-1-yang.lee@linux.alibaba.com> References: <20231023011124.19034-1-yang.lee@linux.alibaba.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-0.7 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,UNPARSEABLE_RELAY autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on morse.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (morse.vger.email [0.0.0.0]); Sun, 22 Oct 2023 18:11:58 -0700 (PDT) Fix some kernel-doc comments to silence the warnings: security/apparmor/policy.c:117: warning: Function parameter or member 'kref' not described in 'aa_pdb_free_kref' security/apparmor/policy.c:117: warning: Excess function parameter 'kr' description in 'aa_pdb_free_kref' security/apparmor/policy.c:882: warning: Function parameter or member 'subj_cred' not described in 'aa_may_manage_policy' Reported-by: Abaci Robot Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=7037 Signed-off-by: Yang Li --- security/apparmor/policy.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/security/apparmor/policy.c b/security/apparmor/policy.c index a441d96adcbf..ed4c9803c8fa 100644 --- a/security/apparmor/policy.c +++ b/security/apparmor/policy.c @@ -111,7 +111,7 @@ static void aa_free_pdb(struct aa_policydb *policy) /** * aa_pdb_free_kref - free aa_policydb by kref (called by aa_put_pdb) - * @kr: kref callback for freeing of a dfa (NOT NULL) + * @kref: kref callback for freeing of a dfa (NOT NULL) */ void aa_pdb_free_kref(struct kref *kref) { @@ -870,7 +870,7 @@ bool aa_current_policy_admin_capable(struct aa_ns *ns) /** * aa_may_manage_policy - can the current task manage policy - * @subj_cred; subjects cred + * @subj_cred: subjects cred * @label: label to check if it can manage policy * @ns: namespace being managed by @label (may be NULL if @label's ns) * @mask: contains the policy manipulation operation being done -- 2.20.1.7.g153144c