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 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id A1017C5475B for ; Fri, 8 Mar 2024 05:44:15 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:In-Reply-To:MIME-Version:References: Message-ID:Subject:Cc:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=Hpuelrah8nqlJQSt0CaNqf1YJmBwJy1iLgXjthUV0cs=; b=pppJtUQ3ExTtyk 0Ko4ACEiSRgcmJpDJ/djDDYU3omhK/mIwdsIdFImTSEpeW436Nl2eF23x7eyM/YwKUl7GDKGaLA3u QgV961GfrQm5MlhExWbk5u9iTp8PXdMqWBTO1FIpRXVi2EjDAmmZVebnZpMAhzr98RQ7ga39nwGkI tLKfGDHsZiCfuXZja/AFDHSu23FO3HdZ+sZgRNI85t4421Q2rnQpJr3N0sRUEsxbUa8lPVYUtYxEX O/fiw6zw6Qo/k1W1pDniOqO+8XAx2tafbIfv0xMcMwGIrKN43/VJ7ZdGBJ+x9Atw3hQb75lT0REQv Mv3iuJLkbTCyp6Uj5lpA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1riT1a-00000007usX-0xmL; Fri, 08 Mar 2024 05:44:06 +0000 Received: from mail-pf1-x431.google.com ([2607:f8b0:4864:20::431]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1riT1X-00000007urX-0Lf4 for linux-arm-kernel@lists.infradead.org; Fri, 08 Mar 2024 05:44:05 +0000 Received: by mail-pf1-x431.google.com with SMTP id d2e1a72fcca58-6e5d7f1f25fso381635b3a.0 for ; Thu, 07 Mar 2024 21:44:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1709876642; x=1710481442; darn=lists.infradead.org; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date:from:to :cc:subject:date:message-id:reply-to; bh=pP3WC4SyW/Vzti9hv7dYhKLJSQ5hGnrzQR/QY37QH6U=; b=DvdlQXyvKyxaexjlZUIXQRmbSOlup+AvHOPRxTq+SavNNSyNcFoc3oYjWm70Jq3swz z4946fAOTOusflid70Ix67HJeunTwR4p4dB0Epk5uYPy+puV4/IIQaKFjHum/mb/LN8s W40wnk7T2RwnKrOQjkY64mcHpyggLXdHwaUW+R+aH/CWyaQfr0mY1OffJ2HhVjyftt4y nAuS148OKpyuKq/MgQCHnwdC68BcP1tXBPd98aGRcwbgrLjjdvJyQxQzEnjiQD36xcsY sDkc+8IhKFlTMOH/+3o/onfuswCyLYnABcW9HFxwu+SA211wvBP6u0GdjAAaDqYnU0mw I4ew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1709876642; x=1710481442; h=in-reply-to:content-transfer-encoding:content-disposition :mime-version:references:message-id:subject:cc:to:from:date :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=pP3WC4SyW/Vzti9hv7dYhKLJSQ5hGnrzQR/QY37QH6U=; b=f85dsC/2U4cKX9n99QcbamfzFJHjTafkjm0EW1pk/TqWPpRrClbNS0dI/uhgzFusl2 Ot0O7MQ9efU1onpKAZyVmqHJtD8jTpNiwmndT615TdCllL922zfOv8mYt3pfmuKXLlmB Jl0h3asM2HkSHdqLZlSZhXjcsFXhv4VjmRlmiRqBApyAgbpGv9uMHaXO5Vf/mFC7rB6I 5A5agv7S2IB57m2xDwABw3oi1X3EDH/suu7IkGEHVJZhiiGmoViq5Br/rkf1CRoEMDp1 ZWK4MC/+wchxQ0E6fPSdtOTEi5dIkSwlgzHjHwIWhvE/XEk/r44esOx+AzvJt2tPHeM1 K6sQ== X-Forwarded-Encrypted: i=1; AJvYcCWYG2+otthjTvRkB5a8BlfsmXE+2wPDayHK6U3OoTL7l1xVYNQ4LUvh5fp1vVZ0Yqhp/6BkOcJucvrlE5s+dLNFZxERL8VX1U6iJ0Gkuv9G60VOQME= X-Gm-Message-State: AOJu0YzZDlbJI7GtJVh5o7fNFa3b0++ietDq6QDO0svDRmJD2tRv0bvS JV0FfT0GotxpOoI33Wz7fk3ZkZrW2B6jjMk1OnxvcWLMED2zjInJkeXrADvSaQ== X-Google-Smtp-Source: AGHT+IF4OBcYmj84dqXR/j7tUWistQOyDNgAnoteok0JgpLNMa/4XKXGz0eVlhJR+Ieyw9pe6cuoUw== X-Received: by 2002:a05:6a00:815:b0:6e5:9a92:f99b with SMTP id m21-20020a056a00081500b006e59a92f99bmr19446806pfk.16.1709876641435; Thu, 07 Mar 2024 21:44:01 -0800 (PST) Received: from thinkpad ([117.217.178.39]) by smtp.gmail.com with ESMTPSA id e3-20020aa79803000000b006e5667793d4sm13354830pfl.66.2024.03.07.21.43.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 07 Mar 2024 21:44:01 -0800 (PST) Date: Fri, 8 Mar 2024 11:13:47 +0530 From: Manivannan Sadhasivam To: Niklas Cassel Cc: Jingoo Han , Gustavo Pimentel , Lorenzo Pieralisi , Krzysztof =?utf-8?Q?Wilczy=C5=84ski?= , Rob Herring , Bjorn Helgaas , Marek Vasut , Yoshihiro Shimoda , Thierry Reding , Jonathan Hunter , Kishon Vijay Abraham I , Vidya Sagar , Vignesh Raghavendra , Richard Zhu , Lucas Stach , Shawn Guo , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , NXP Linux Team , Minghuan Lian , Mingkai Hu , Roy Zang , Kunihiko Hayashi , Masami Hiramatsu , Kishon Vijay Abraham I , Jesper Nilsson , Srikanth Thokala , linux-pci@vger.kernel.org, linux-kernel@vger.kernel.org, linux-renesas-soc@vger.kernel.org, linux-arm-msm@vger.kernel.org, linux-tegra@vger.kernel.org, linux-omap@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linuxppc-dev@lists.ozlabs.org, linux-arm-kernel@axis.com, Frank Li Subject: Re: [PATCH v9 10/10] PCI: dwc: ep: Add Kernel-doc comments for APIs Message-ID: <20240308054347.GE3789@thinkpad> References: <20240304-pci-dbi-rework-v9-0-29d433d99cda@linaro.org> <20240304-pci-dbi-rework-v9-10-29d433d99cda@linaro.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240307_214403_449350_33F61F8A X-CRM114-Status: GOOD ( 20.86 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org T24gVGh1LCBNYXIgMDcsIDIwMjQgYXQgMTA6NTg6MTJQTSArMDEwMCwgTmlrbGFzIENhc3NlbCB3 cm90ZToKPiBPbiBNb24sIE1hciAwNCwgMjAyNCBhdCAwMjo1MjoyMlBNICswNTMwLCBNYW5pdmFu bmFuIFNhZGhhc2l2YW0gd3JvdGU6Cj4gPiBBbGwgb2YgdGhlIEFQSXMgYXJlIG1pc3NpbmcgdGhl IEtlcm5lbC1kb2MgY29tbWVudHMuIEhlbmNlLCBhZGQgdGhlbS4KPiA+IAo+ID4gUmV2aWV3ZWQt Ynk6IEZyYW5rIExpIDxGcmFuay5MaUBueHAuY29tPgo+ID4gU2lnbmVkLW9mZi1ieTogTWFuaXZh bm5hbiBTYWRoYXNpdmFtIDxtYW5pdmFubmFuLnNhZGhhc2l2YW1AbGluYXJvLm9yZz4KPiA+IC0t LQo+IAo+IEZvciB0aGUgZnVuY3Rpb25zIHRoYXQgeW91IGFkZGVkIGluIHRoaXMgc2VyaWVzLCBl LmcuCj4gZHdfcGNpZV9lcF9jbGVhbnVwKCksIGR3X3BjaWVfZXBfaW5pdF9ub25fc3RpY2t5X3Jl Z2lzdGVycygpLAo+IGFuZCBkd19wY2llX2VwX2xpbmtkb3duKCksIEkgdGhpbmsgdGhhdCBpdCB3 b3VsZCBoYXZlIGJlZW4KPiBiZXR0ZXIgaWYgeW91IGFjdHVhbGx5IGFkZGVkIHRoZSBrZG9jIGlu IHRoZSBzYW1lIGNvbW1pdCB0aGF0Cj4gYWRkZWQgdGhlIHJlc3BlY3RpdmUgZnVuY3Rpb24uCj4g Cj4gCj4gRm9yIHRoZSBleGlzdGluZyBmdW5jdGlvbnMgdGhhdCBkaWQgbm90IGhhdmUgYSBrZG9j LCBJIHRoaW5rCj4gaXQgd291bGQgaGF2ZSBiZWVuIGJldHRlciBpZiB5b3UgZml4ZWQgdGhpcyBh cyBwYXRjaCAxLzEwIGluCj4gdGhpcyBzZXJpZXMuIChPciAyLzEwLCBpbiBjYXNlIHlvdSBrZWVw IHRoZSBGaXhlcyB0YWcgZm9yIHRoZQo+ICJQQ0k6IGR3YzogZXA6IEZpeCBEQkkgYWNjZXNzIGZh aWx1cmUgZm9yIGRyaXZlcnMgcmVxdWlyaW5nCj4gcmVmY2xrIGZyb20gaG9zdCIgcGF0Y2guKQo+ IAo+IFllcywgSSBrbm93IHRoYXQgeW91IHJlbmFtZSBzb21lIG9mIHRoZXNlIGZ1bmN0aW9ucyB0 aGF0Cj4gbGFja2VkIGtkb2MgbGF0ZXIgaW4gdGhlIHNlcmllcywgYnV0IHRoZSB3aG9sZSBrZG9j IGRlc2NyaXB0aW9uCj4gd291bGQgYmUgdGhlIHNhbWUsIHRoZSBrZG9jIHBhcmFtZXRlcnMgd291 bGQgYmUgdGhlIHNhbWUsIGFuZCB0aGUKPiBrZG9jIHJldHVybiB2YWx1ZSB3b3VsZCBiZSB0aGUg c2FtZS4KPiAKPiBJZiB5b3UgbGF0ZXIgcmVuYW1lIGEgZnVuY3Rpb24sIHlvdSB3b3VsZCBvbmx5 IG5lZWQgdG8gY2hhbmdlCj4gdGhlIGtkb2MgZnVuY3Rpb24gbmFtZSAoaW4gYWRkaXRpb24gdG8g dGhlIGZ1bmN0aW9uIGRlY2xhcmF0aW9uCj4gaXRzZWxmKS4KPiAKCk1ha2VzIHNlbnNlISBXaWxs IGNoYW5nZSBpdC4KCi0gTWFuaQoKLS0gCuCuruCuo+Cuv+CuteCuo+CvjeCuo+CuqeCvjSDgrprg rqTgrr7grprgrr/grrXgrq7gr40KCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fCmxpbnV4LWFybS1rZXJuZWwgbWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJu ZWxAbGlzdHMuaW5mcmFkZWFkLm9yZwpodHRwOi8vbGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFu L2xpc3RpbmZvL2xpbnV4LWFybS1rZXJuZWwK