Received: by 2002:a05:6a10:413:0:0:0:0 with SMTP id 19csp382008pxp; Wed, 16 Mar 2022 07:43:46 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwhKlSw4hsxd9ORONhbtABxc2RH4+JVlyh0KLZVQFUSFrVZF4MKTtlnWG78VFViWX/xNyu2 X-Received: by 2002:a17:906:9c83:b0:6df:839a:a6d0 with SMTP id fj3-20020a1709069c8300b006df839aa6d0mr225314ejc.419.1647441826635; Wed, 16 Mar 2022 07:43:46 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1647441826; cv=none; d=google.com; s=arc-20160816; b=g2rlclkQLKtaa+Dgqd6DSyGcA1lLr9ZGgXHuPbU5ClpAxCR7bLexBB0x0EWtkvm/Yh Dtt/16SRYxaY8B6foBZcmRTjaz8jEDrpaD2L5q88iG96mpjz3xMrIxTe3I7bL7nODbdl d6YcUC0fZNIJdb8mdJFGK/nZvkD+V5oZL8PKg3B8mnd2x5u5JR4zA1+mg/ktzzMFpNTM USgNWiT2M+yQsD1/N5FQdjS0bc6dofuzlIAkokFCD1HGClSX/ebVdV1HO8JRjtkfJ1nk Z9Mf2gy4OkHjEuIrLg+YgVQxMxTG3N8C7/qcfGSbI2ZvsIONta5xoTJSZaRc7V+vGCyA CcKA== 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=T7rqhTpU+yMNKJlLCEIY4udhpaBYEwMxiiKxyUAa6/0=; b=NKENMrhWwLzBMLrJxiKLz+hdE2CFQrj8ttrjT9XNXUIW6ipfrfZp6t3cVYbtynHXNm XS30tmeEM/hTOmrlITmF6idfjjM9JpH9go4gkPAL20TZV9FAMqB0kJikWweMT+aLgsFi G0cEeWHp+0/127ChZZIHO5FP12P5ttUlHINfw8YngGYFG3B0uf02EyAy/l8K67DL27gE aY86obbOas4VRYV0f/mwFK/s7YIzh45wUHDOZGwcw1uFm9AhU5Ku7Jq8I83LyIYuopu+ b2c3m7U3hmQW6a7BkLTHW9Mj6iZfIJVTVTup/iqT23TBwD0ZSIFn+I/4AODef/dRBCuM c1Nw== 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id h3-20020a1709066d8300b006d6325d9c43si1149221ejt.492.2022.03.16.07.43.19; Wed, 16 Mar 2022 07:43:46 -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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1345426AbiCPAkk (ORCPT + 99 others); Tue, 15 Mar 2022 20:40:40 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48256 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231308AbiCPAki (ORCPT ); Tue, 15 Mar 2022 20:40:38 -0400 Received: from out30-45.freemail.mail.aliyun.com (out30-45.freemail.mail.aliyun.com [115.124.30.45]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AD6EE5DA51; Tue, 15 Mar 2022 17:39:24 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R461e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=e01e04395;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0V7JkLTl_1647391161; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0V7JkLTl_1647391161) by smtp.aliyun-inc.com(127.0.0.1); Wed, 16 Mar 2022 08:39:22 +0800 From: Yang Li To: serge@hallyn.com Cc: linux-security-module@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] capability: Add parameter description in kernel-doc comment Date: Wed, 16 Mar 2022 08:39:20 +0800 Message-Id: <20220316003920.108121-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=-9.9 required=5.0 tests=BAYES_00, ENV_AND_HDR_SPF_MATCH,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H5, RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE, UNPARSEABLE_RELAY,USER_IN_DEF_SPF_WL 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 Add the description of @mnt_userns in privileged_wrt_inode_uidgid() and capable_wrt_inode_uidgid() kernel-doc comment to remove warnings found by running scripts/kernel-doc, which is caused by using 'make W=1'. kernel/capability.c:491: warning: Function parameter or member 'mnt_userns' not described in 'privileged_wrt_inode_uidgid' kernel/capability.c:507: warning: Function parameter or member 'mnt_userns' not described in 'capable_wrt_inode_uidgid' Reported-by: Abaci Robot Signed-off-by: Yang Li --- kernel/capability.c | 2 ++ 1 file changed, 2 insertions(+) diff --git a/kernel/capability.c b/kernel/capability.c index 765194f5d678..ab401d17574d 100644 --- a/kernel/capability.c +++ b/kernel/capability.c @@ -481,6 +481,7 @@ EXPORT_SYMBOL(file_ns_capable); /** * privileged_wrt_inode_uidgid - Do capabilities in the namespace work over the inode? * @ns: The user namespace in question + * @mnt_userns: The user namespace of the capability to use * @inode: The inode in question * * Return true if the inode uid and gid are within the namespace. @@ -495,6 +496,7 @@ bool privileged_wrt_inode_uidgid(struct user_namespace *ns, /** * capable_wrt_inode_uidgid - Check nsown_capable and uid and gid mapped + * @mnt_userns: The user namespace of the capability to use * @inode: The inode in question * @cap: The capability in question * -- 2.20.1.7.g153144c