From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-2.2 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_PASS,URIBL_BLOCKED,USER_AGENT_MUTT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 36109C43334 for ; Tue, 4 Sep 2018 16:52:07 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id DA14520843 for ; Tue, 4 Sep 2018 16:52:06 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org DA14520843 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linux.vnet.ibm.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727574AbeIDVSA (ORCPT ); Tue, 4 Sep 2018 17:18:00 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:43114 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726167AbeIDVSA (ORCPT ); Tue, 4 Sep 2018 17:18:00 -0400 Received: from pps.filterd (m0098396.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w84GndAv002729 for ; Tue, 4 Sep 2018 12:52:03 -0400 Received: from e11.ny.us.ibm.com (e11.ny.us.ibm.com [129.33.205.201]) by mx0a-001b2d01.pphosted.com with ESMTP id 2m9uw46adb-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 04 Sep 2018 12:52:02 -0400 Received: from localhost by e11.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Tue, 4 Sep 2018 12:52:01 -0400 Received: from b01cxnp22034.gho.pok.ibm.com (9.57.198.24) by e11.ny.us.ibm.com (146.89.104.198) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Tue, 4 Sep 2018 12:51:57 -0400 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp22034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w84Gpu552949514 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Tue, 4 Sep 2018 16:51:56 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id D6EA5B2064; Tue, 4 Sep 2018 12:50:44 -0400 (EDT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B914DB2066; Tue, 4 Sep 2018 12:50:44 -0400 (EDT) Received: from paulmck-ThinkPad-W541 (unknown [9.70.82.159]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP; Tue, 4 Sep 2018 12:50:44 -0400 (EDT) Received: by paulmck-ThinkPad-W541 (Postfix, from userid 1000) id 0C34516C1C02; Tue, 4 Sep 2018 09:52:00 -0700 (PDT) Date: Tue, 4 Sep 2018 09:52:00 -0700 From: "Paul E. McKenney" To: Randy Dunlap Cc: LKML , Lai Jiangshan , Josh Triplett , Steven Rostedt , Mathieu Desnoyers , "Joel Fernandes (Google)" Subject: Re: [PATCH] srcu: fix kernel-doc missing notation Reply-To: paulmck@linux.vnet.ibm.com References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.21 (2010-09-15) X-TM-AS-GCONF: 00 x-cbid: 18090416-2213-0000-0000-000002E7E9EB X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00009670; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000266; SDB=6.01083492; UDB=6.00559153; IPR=6.00863491; MB=3.00023109; MTD=3.00000008; XFM=3.00000015; UTC=2018-09-04 16:51:59 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18090416-2214-0000-0000-00005B70B755 Message-Id: <20180904165200.GF4225@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-09-04_10:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1809040170 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Sep 03, 2018 at 12:45:45PM -0700, Randy Dunlap wrote: > From: Randy Dunlap > > Fix kernel-doc warnings for missing parameter descriptions: > > ../include/linux/srcu.h:175: warning: Function parameter or member 'p' not described in 'srcu_dereference_notrace' > ../include/linux/srcu.h:175: warning: Function parameter or member 'sp' not described in 'srcu_dereference_notrace' > > Fixes: 0b764a6e4e19d ("srcu: Add notrace variant of srcu_dereference") > > Signed-off-by: Randy Dunlap Queued, thank you Randy! Thanx, Paul > Cc: Lai Jiangshan > Cc: "Paul E. McKenney" > Cc: Josh Triplett > Cc: Steven Rostedt > Cc: Mathieu Desnoyers > Cc: Joel Fernandes (Google) > --- > include/linux/srcu.h | 3 +++ > 1 file changed, 3 insertions(+) > > --- lnx-419-rc2.orig/include/linux/srcu.h > +++ lnx-419-rc2/include/linux/srcu.h > @@ -171,6 +171,9 @@ static inline int srcu_read_lock_held(co > > /** > * srcu_dereference_notrace - no tracing and no lockdep calls from here > + * @p: the pointer to fetch and protect for later dereferencing > + * @sp: pointer to the srcu_struct, which is used to check that we > + * really are in an SRCU read-side critical section. > */ > #define srcu_dereference_notrace(p, sp) srcu_dereference_check((p), (sp), 1) > > >