Received: by 2002:a05:7412:251c:b0:e2:908c:2ebd with SMTP id w28csp940915rda; Sun, 22 Oct 2023 17:55:53 -0700 (PDT) X-Google-Smtp-Source: AGHT+IEbx922AWenZTVgLTEq77tzi33SlsjfcoxsFb2jOeUAtnsJ4FT6pcrjleVmAZ8DxKvdn3sY X-Received: by 2002:a05:6830:25c4:b0:6c4:a127:9ff2 with SMTP id d4-20020a05683025c400b006c4a1279ff2mr9835221otu.11.1698022553683; Sun, 22 Oct 2023 17:55:53 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1698022553; cv=none; d=google.com; s=arc-20160816; b=W5j0GJCJG+hOfMI5KJ5fVZ/OW9GQJCI7C64z6oR8P0fZeAUUYtkm1bff8Yn84O5kYN Dhzmi87QrvezxVE+9/RmWRqDh1F0ixy0zxF7RSQDwlKa341tx5hslTXy679iK+fl2xsk gILy+8wWCVuvF7KT8Qrk69IUHdMPhH6Te24mmgb8R163F3q51qoV3xU8BQ/ONJQIyV71 wDIwI5nxgivVCDuDqL087/RqPDeBqPWJO2MATurPWe3dCjbQXaEBDcbBse6QyemkKyYz pPbuM0Cg8AZ5F9bLgmNT8JI1fIaCGxOJ3j5y6HJKdYcFfdk7iw1BEKW7wxF7LZ6OjeCT +Cqg== 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 :message-id:date:subject:cc:to:from; bh=K/HRlxPa5sadFoQyv3OthY48ay/bmvktlx+AgpdWEFc=; fh=CsrrSYuaOy6XOars/dGdvSnPykGebxMPWt+wbxMWbTM=; b=f0hmz6LGJ5VaG8EFPh9fKC8djhIH46WNCMfnj9YkSCOeszT9JR6aDxnWJ0TZIm5XIr YDOa9QVy1LhMLlqFBR06lKofXPoMNNGZhMZpnO11sy1mLxYlOXz+yAqiHnfhgshurPdv 1yhYbv6Ozo8jSH9uUrJDH6iK74dSejkt/rbXxhlheHysT+FHfD/6Tqld/iILx7GhFmnq 8M+ZU+bKzgDXz1+rD0eLN3o0Dg826aZwf9Jvw0AitUhKZ6oQd8NFXDlqV1od0iOJMDTp Qn4OpSF24i4pBTpcJNiGcdyGFwCsnmqT0/LTQvySutszZIFIL0aHkfdCnwGYQ6aEk7mB +GMw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 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 howler.vger.email (howler.vger.email. [23.128.96.34]) by mx.google.com with ESMTPS id q21-20020a632a15000000b00577f65baa3esi5534284pgq.775.2023.10.22.17.55.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 22 Oct 2023 17:55:53 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 as permitted sender) client-ip=23.128.96.34; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 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 howler.vger.email (Postfix) with ESMTP id D97EF808E0CA; Sun, 22 Oct 2023 17:55:50 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at howler.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232880AbjJWAzZ (ORCPT + 99 others); Sun, 22 Oct 2023 20:55:25 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54334 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229446AbjJWAzY (ORCPT ); Sun, 22 Oct 2023 20:55:24 -0400 Received: from out30-100.freemail.mail.aliyun.com (out30-100.freemail.mail.aliyun.com [115.124.30.100]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E1840B7; Sun, 22 Oct 2023 17:55:21 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R251e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=9;SR=0;TI=SMTPD_---0VuctJle_1698022518; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VuctJle_1698022518) by smtp.aliyun-inc.com; Mon, 23 Oct 2023 08:55:19 +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] apparmor: Fix some kernel-doc comments Date: Mon, 23 Oct 2023 08:55:17 +0800 Message-Id: <20231023005517.115318-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c 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 howler.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 (howler.vger.email [0.0.0.0]); Sun, 22 Oct 2023 17:55:51 -0700 (PDT) Fix some kernel-doc comments to silence the warnings: security/apparmor/capability.c:66: warning: Function parameter or member 'ad' not described in 'audit_caps' security/apparmor/capability.c:66: warning: Excess function parameter 'as' description in 'audit_caps' security/apparmor/capability.c:154: warning: Function parameter or member 'subj_cred' not described in 'aa_capable' security/apparmor/capability.c:154: warning: Excess function parameter 'subj_cread' description in 'aa_capable' Reported-by: Abaci Robot Closes: https://bugzilla.openanolis.cn/show_bug.cgi?id=7035 Signed-off-by: Yang Li --- security/apparmor/capability.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/security/apparmor/capability.c b/security/apparmor/capability.c index 0b7d2b1086c9..9934df16c843 100644 --- a/security/apparmor/capability.c +++ b/security/apparmor/capability.c @@ -51,7 +51,7 @@ static void audit_cb(struct audit_buffer *ab, void *va) /** * audit_caps - audit a capability - * @as: audit data + * @ad: audit data * @profile: profile being tested for confinement (NOT NULL) * @cap: capability tested * @error: error code returned by test @@ -140,7 +140,7 @@ static int profile_capable(struct aa_profile *profile, int cap, /** * aa_capable - test permission to use capability - * @subj_cread: cred we are testing capability against + * @subj_cred: cred we are testing capability against * @label: label being tested for capability (NOT NULL) * @cap: capability to be tested * @opts: CAP_OPT_NOAUDIT bit determines whether audit record is generated -- 2.20.1.7.g153144c