Received: by 2002:ac0:a5a6:0:0:0:0:0 with SMTP id m35-v6csp2780461imm; Tue, 4 Sep 2018 09:53:25 -0700 (PDT) X-Google-Smtp-Source: ANB0VdZ6ZkXuIquzGlEqNQjtiUaDyHbPEnGq3fDozrezzgxoQKwiaqQuMOyNK9YlMiNa3VHsZS1e X-Received: by 2002:a17:902:9a06:: with SMTP id v6-v6mr34577597plp.316.1536080005824; Tue, 04 Sep 2018 09:53:25 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1536080005; cv=none; d=google.com; s=arc-20160816; b=EluWKgolyIGKAqSoQ4j0Na9Dl9BpJi3TjGY49JHh47cYSlcVX0on9y3qWfU1EyaUEi mAu/rg9yv12++XFi/x42ubqZpntRG9YXtbEisbQJxMQXqJEJNZJRbQq1e4+i9N7Ldagy h9cezvNIO9E53QyM6vj1ny4xuPubQebDUXyz5BONhr60e4Tw+Ij0ubNN48qD7d0S8BUo lPUaMv6seL1sYGWE8KEIAYkIa6FqoEduWKiP32up64/MU24lqL6oICfDvEFtGqM8zon4 Qv0FUDR8j8o3Dh52iYAbKZjcqogPH/rDZnoQzxlOlwnMeMh9JvkZAGdkndK05MnwUB+d qV7g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:user-agent:in-reply-to :content-disposition:mime-version:references:reply-to:subject:cc:to :from:date:arc-authentication-results; bh=cOvMMiJtaQ0Yj1CAjgw/DJGvZhEbNQ8kOveJ1RhyENs=; b=IFM4FwurRLWHn78hqCoD7kzYTs/7VOPw9UMIR3RGqJ+bImMLaZkr4uO3PRZcweA7P5 IDmM+gavpyRObV99yVAmDfCO7791/ZU9TmKQdu7mho9Df9ZotuSc6cI3fe4HeZJkvjgb gu2v7B0rb6CveigBfejZtie5Txjnu20jLpi+5O2xt03hTeJ/n0fyappooo8I6slxqpM1 YJ3qUm7MsXIP+6Xi4HXbbS+P+6Xfy0Jn/nXIBnu40GYG5wTeS1fJsij66JtrlTR7wdrD wG0HkpGeY5M0troW+S9ad+hDN64+/r2ktg8QB8m72Hn0r4wSBAGx26TKeTjb0gudC1kd CCQw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id v36-v6si20518787pga.336.2018.09.04.09.53.09; Tue, 04 Sep 2018 09:53:25 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727466AbeIDVSA (ORCPT + 99 others); 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) > > >