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 lists.ozlabs.org (lists.ozlabs.org [112.213.38.117]) (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 6C885C44503 for ; Mon, 6 Jul 2026 12:45:31 +0000 (UTC) Received: from boromir.ozlabs.org (localhost [127.0.0.1]) by lists.ozlabs.org (Postfix) with ESMTP id 4gv3wk4YWCz3bqV; Mon, 06 Jul 2026 22:45:10 +1000 (AEST) Authentication-Results: lists.ozlabs.org; arc=none smtp.remote-ip=205.220.180.131 ARC-Seal: i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1783341910; cv=none; b=c9/LX3m773dhTCRzx+gsC3ronIBqT7B1PbWS7jNvpFsL8eVzs88mEbPGC1a7hyGwQmtsj4SUDzZHj9iU/qiKRwErL3nzPEQ8F6K/Fmw8ViV3YAesTSZ9tcPc93qYfZKQ71DYR2SbsM/3sP1sfR/3w3dtzLfEF6nDCfYre83/+unF98KPC//r6s22w39bfTtGJbD/dFwE0/fQPe26RAfAZhLVoCGKoZkoEjdGWpsiWtFW8BUzLoKggLZr7fFUbwlzvnDoYpfwoXZIB/Msfrika89M67SyoG05alYXS3Lmc/lGNjzWuRRhELca/fXr6udDc+1yzoeP+eRP8wUrQ69qSA== ARC-Message-Signature: i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1783341910; c=relaxed/relaxed; bh=4ypedl6lAdelBq6beblP/gtF5+9BXsm+BYvhqSYvSm0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=RKS+CygJcAjfFeB1EQTneT2gNjyGCOKhR1NYKz6bcVE64TLpK1TwkZnRdMhxXDErHpviWBbICzZ1PYieyLERLICtVA7InG7ag3rSTq+n1Gn0pvSmieMYLA+2/AOaKuXkDwrQONYFWYjBH7tZ+ISnP9Xfec696wyGN2VghgkpI0sqp/v98kPS3u87TBJIpyOm7RrREoYM7CAASGeETN4OeDPMVwrsKPNHNKfaxo7FL2JPJgioNJ9p2IhUNh+8MjsZDHuW3xLuUe6rDBZg/H49Nq9x2wYov+k7tbpHxTmDizTvRGQYQGNTLEFNtKV8+WH+s36ZKmop+TIXm745EpbSKg== ARC-Authentication-Results: i=1; lists.ozlabs.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; dkim=pass (2048-bit key; unprotected) header.d=qualcomm.com header.i=@qualcomm.com header.a=rsa-sha256 header.s=qcppdkim1 header.b=pdv8xzeb; dkim=pass (2048-bit key; unprotected) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.a=rsa-sha256 header.s=google header.b=QpY/4rhJ; dkim-atps=neutral; spf=pass (client-ip=205.220.180.131; helo=mx0b-0031df01.pphosted.com; envelope-from=bartosz.golaszewski@oss.qualcomm.com; receiver=lists.ozlabs.org) smtp.mailfrom=oss.qualcomm.com Authentication-Results: lists.ozlabs.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: lists.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=qualcomm.com header.i=@qualcomm.com header.a=rsa-sha256 header.s=qcppdkim1 header.b=pdv8xzeb; dkim=pass (2048-bit key; unprotected) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.a=rsa-sha256 header.s=google header.b=QpY/4rhJ; dkim-atps=neutral Authentication-Results: lists.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=oss.qualcomm.com (client-ip=205.220.180.131; helo=mx0b-0031df01.pphosted.com; envelope-from=bartosz.golaszewski@oss.qualcomm.com; receiver=lists.ozlabs.org) Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 4gv3wj3rbqz3bby for ; Mon, 06 Jul 2026 22:45:09 +1000 (AEST) Received: from pps.filterd (m0279872.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 666AxLa7218452 for ; Mon, 6 Jul 2026 12:45:07 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= 4ypedl6lAdelBq6beblP/gtF5+9BXsm+BYvhqSYvSm0=; b=pdv8xzeblN7EO7HG FH5xzwmFSqOU2Hgogzz26thWi65+vWdeyuOWD7eOyLyNa29P0b+SaswNqF9kS4FC KA1OVnpMYTn/40Nz2pxTYv4trMR0LigFtFqWn5NPzbosdepwcoCO7dLbSdFCU11+ 625Rv+YZ9WtsBt6QnCuBYwmabFKfoYm1Etyt6EIi5GTkcT84WTKLii+0R8U05BkP QzADCpTzhPgK8NnvXRccEl/Ux/Y7UZb18sHQKEENYHn17Kvs9gUu8wgAYrYfwdim kihEO6nIPf5AxXiTwzdTR5gncp7wXW5IQPREllLfupSbD+sMCFkBnKT21iqYXfA0 EiG0KQ== Received: from mail-qk1-f200.google.com (mail-qk1-f200.google.com [209.85.222.200]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4f88hs93bp-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Mon, 06 Jul 2026 12:45:07 +0000 (GMT) Received: by mail-qk1-f200.google.com with SMTP id af79cd13be357-92e56b2b350so610107885a.3 for ; Mon, 06 Jul 2026 05:45:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1783341906; x=1783946706; darn=lists.ozlabs.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=4ypedl6lAdelBq6beblP/gtF5+9BXsm+BYvhqSYvSm0=; b=QpY/4rhJf7Tx/YFYWapFRfQCVGdT7KyRCI7KUA4I+u19R3B0Fe/Rf0OfnH0vfTl12s hc1BJkCqn9dbMyUYdyZQacX9A7IRqwX6mo5tbtgckrNPuW6EUBFedea41f3BYkn0VLFN 9i6ECkJBj9G8D5A6K2e0Cdd1xsfi6kmfm36MHP9nfUA4tDQoOpUkXR2BBTmlXaHn40UI tCYrYijxDDQktv2wB7pJ9tjyiE0yFPr+pO2KS9AqJGfR7jPxXxq9uA36/Go0emaApAPV DuJ0W4WNmwU4SDYXfrnxOOpg4TRP7MVK27I7EzqH93NsJkc8lz77/3EH2EOUAkojtyBr YDhQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1783341906; x=1783946706; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :content-type:mime-version:subject:date:from:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to :content-type; bh=4ypedl6lAdelBq6beblP/gtF5+9BXsm+BYvhqSYvSm0=; b=ZLdgB3MtiniVzk+DUVJTj+tJNghHuFGHbnqA43ciNpFfANKxly6Pr1UYTD61vcykmY rhla/Z4BTvR/6dmf1TKEfwjl0JvqtUP826j/4PB3i2JQmEmNl6X+jax3j0ovadIPLr/u kdT898qQgq9e6pJuKsOFMdDYn+1A8XofHWGMfKw9PH5cO9R55Zlm+XhWJ89WZgbmwY62 7G0+hL2P3z5tUquC/v6SkkHEyjjNpV07hWhaQiVXYq6M2WA8P6O8UvWrHLvdWbC9e3bQ aquo20bnGzjHsGtVlkRj2wBGUqkzOtbC0iBASlUYIWEnum+0GOSwpzxBLoQI8FUEDEPx RN5Q== X-Forwarded-Encrypted: i=1; AHgh+RrJ5PKBU21vkd1UTgpTMBFQC56sdmg/rjF4YiWGvPVR6ITsFIqpA870iQpUNNCHgO85E4cHqr5EY1LcgcQ=@lists.ozlabs.org X-Gm-Message-State: AOJu0Yzwyse2IVAddEcdXvcpC6m3Ybw4zN0EsJK+FYdHTlJtCpQjrRGh OdrFfmSrhpAsruX4+jG+dVmxc49nWd9Ydo+AjsWeL7CBoeLeAR7GLDT+E/a4cdc6Xv+F6J4bF5Y NbWhokb0R0D01QNGWOM8Snp2fNO2Oiytuq+en9bk9b7zM/C8GrTHjsMscR8gtQ3uB1EPQ X-Gm-Gg: AfdE7ckHXFWWQsNvkaJe0nByEKPkpjWnwpYIvonzvF9Ouf0KaXv72eYRpjyNSeQF2po w+eT1Pj3F/UQjYT2lcskKhp3J7h3YOLzSNrVQoyyrUJnFqhOAtZTQG+czbwy4CJ6WtbI/zYwkp0 ndkgvTActuKFqmcH/Q1IYKrpKLuNvZHz2MwDOXh7kSq+yf7EL46P6OJzMTAbze8HF5sNt6WFZ9j kTk32NFfwtr5tmM9Talli6xpDR1rX6I7kW1oCkVvORG52Crk+dASHOAi1Y4KHDYZGWsMtsBX1CE P8y0xpHvjcPdtKKWC327Ptit0cQ/HSTSaDlfxMYlg3KZB6eyFQrDLYwKl6P8pqOPqu5o+38/rAn tOfdFL2iR3rafjtYpy+yUiye2wutXBK4hTOukKWAo X-Received: by 2002:a05:620a:28d3:b0:92a:e474:92eb with SMTP id af79cd13be357-92ebb58d4c6mr45841285a.55.1783341905978; Mon, 06 Jul 2026 05:45:05 -0700 (PDT) X-Received: by 2002:a05:620a:28d3:b0:92a:e474:92eb with SMTP id af79cd13be357-92ebb58d4c6mr45828885a.55.1783341905233; Mon, 06 Jul 2026 05:45:05 -0700 (PDT) Received: from brgl-qcom.local ([2a01:cb1d:dc:7e00:86f0:c42b:ef4c:d3bb]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-47aa0a55be4sm22126539f8f.31.2026.07.06.05.45.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 06 Jul 2026 05:45:04 -0700 (PDT) From: Bartosz Golaszewski Date: Mon, 06 Jul 2026 14:44:17 +0200 Subject: [PATCH v3 05/20] driver core: update kerneldoc for platform_device_alloc() X-Mailing-List: linuxppc-dev@lists.ozlabs.org List-Id: List-Help: List-Owner: List-Post: List-Archive: , List-Subscribe: , , List-Unsubscribe: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: 7bit Message-Id: <20260706-pdev-fwnode-ref-v3-5-1ff028e33779@oss.qualcomm.com> References: <20260706-pdev-fwnode-ref-v3-0-1ff028e33779@oss.qualcomm.com> In-Reply-To: <20260706-pdev-fwnode-ref-v3-0-1ff028e33779@oss.qualcomm.com> To: Lee Jones , Mark Brown , Thierry Reding , Sebastian Hesselbarth , Andrew Lunn , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Srinivas Kandagatla , Greg Kroah-Hartman , Vinod Koul , "Rafael J. Wysocki" , Danilo Krummrich , Rob Herring , Saravana Kannan , Madhavan Srinivasan , Michael Ellerman , Nicholas Piggin , "Christophe Leroy (CS GROUP)" , Andi Shyti , Andy Shevchenko , Joerg Roedel , Will Deacon , Robin Murphy , Doug Berger , Florian Fainelli , Broadcom internal kernel review list , Ulf Hansson , Frank Li , Sascha Hauer , Pengutronix Kernel Team , Fabio Estevam , Matthew Brost , =?utf-8?q?Thomas_Hellstr=C3=B6m?= , Rodrigo Vivi , David Airlie , Simona Vetter , Peter Chen , Paul Cercueil , Bin Liu , Philipp Zabel , Maximilian Luz , Hans de Goede , =?utf-8?q?Ilpo_J=C3=A4rvinen?= , Krzysztof Kozlowski , Benjamin Herrenschmidt Cc: brgl@kernel.org, linux-kernel@vger.kernel.org, netdev@vger.kernel.org, linux-arm-msm@vger.kernel.org, linux-sound@vger.kernel.org, driver-core@lists.linux.dev, devicetree@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, linux-i2c@vger.kernel.org, iommu@lists.linux.dev, linux-pm@vger.kernel.org, imx@lists.linux.dev, linux-arm-kernel@lists.infradead.org, intel-xe@lists.freedesktop.org, dri-devel@lists.freedesktop.org, linux-usb@vger.kernel.org, linux-mips@vger.kernel.org, platform-driver-x86@vger.kernel.org, mfd@lists.linux.dev, Bartosz Golaszewski , Manuel Ebner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1416; i=bartosz.golaszewski@oss.qualcomm.com; h=from:subject:message-id; bh=Jgf74WxLCxW5Zz726nCnOm1WawVwm90mJr+JyHWzTfo=; b=owEBbQKS/ZANAwAKAQWdLsv/NoTDAcsmYgBqS6Mye7m4WIbR8PkDTH2c4X+IwaDKU66SIcDpL mQAGRuCAsaJAjMEAAEKAB0WIQSR5RMt5bVGHXuiZfwFnS7L/zaEwwUCakujMgAKCRAFnS7L/zaE w4ZfEAC41Mo4fJZG469yMU0Of0D0DGwRVaKN4uoZLlhdTRAcVxaepoBujUjtupSZqXiayqNHV5U gi5UTfW3wn++NDJyYjf09qZKyCOyEnE/UmdnwGURK5nJ+PshyBSYME0avY5FZHKVYTCIXlPzGqF UHC6t7eVnwL46lXo0kHJ7EsWs4t3tAPczpks24WUn0sdkVu3uPWOSTcCd94HIBE4WBs5ytMBh/+ /FrSJqgIth1+QT2DtNBUdqqbCdI8jabVZp3kRhU2DP/pDsdKfBtljH8QRtloSKXSAddgv+vDvmZ 5KdXc433Hkh/oTWAw8jbFbKHe67pgQKXGKko6LXTH77itBDpywUUWcIk/qEbCKQgqCku3xTgHZP H+H4trXem4YILFtiNbwsiQFtaD9iv124/YqQzguOiNSJYYbneWqaJUXkLzRdiHcklMRySNnUQ1Z zzlY+2vbp7eQSY7hvbHjthXmH7V3pryL4Y7yDI+OaiYJcYu8ca/YbMP5Lq2mqASntQtP0qTkBwv WlH7HQjT0H2v8cocaoPHpRRmZ6FmkINXxIXvK+awAkiCuscSrZeN9lSC36RmTZANo+qHicYPUm3 0ymNHLd9ZEW7+c55YFCw8msnV5MMfdIaQF6xsNtguNg6ayHTyrtqvt38bkFvNglpZCmrVFxNFQ6 Ysws8qDm8bTfJYQ== X-Developer-Key: i=bartosz.golaszewski@oss.qualcomm.com; a=openpgp; fpr=169DEB6C0BC3C46013D2C79F11A72EA01471D772 X-Proofpoint-ORIG-GUID: U9r4KYM5OlFxH4siJtD0f_iqSsDcY15E X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwNzA2MDEyOSBTYWx0ZWRfX4vH2KgDkQKIB G/rI94DlzOCSvTqb97ysV46s5u9Iiy5g9PeppnLm502QXQKH0Frldq9f8pcvKPh6HHivJvyqnvs y+QwSelxumofy6V17S6hgdmUV+JcmuIZH1Vkh0BPylZpQ9Z9bZrCNx7TJ85cNtuRwBHmQjXrtfI T8NVa/Um92aTwbfT0RvPb/rp28+2gPrznZiMJ3bLSZuE4js6do3I3yneF5uZgDeLrHeIB8VqfeH fzMm13d4r8/+J7ddBbylQ4RznVpbOyaItnHbMoky0ewP7kZf105PXlBb6r7MX3TJsVWT3NOhVd2 4/ReV3r6E+O1WDqIZ4RVDYu058KZKXpa7eMtZL6sKzb92uET8JyFI45/yVxdjK4j83je7nEAPr/ jmSfc3HXvi0wEwxnXF2LMTGD4i8g4DmsGsxWxfQKqADmIo+hQ5ghDLpan/rXZkJEtdn76bZMFh+ eA/cFDg0X/vfAXYOHTQ== X-Proofpoint-Spam-Info: AW1haW4tMjYwNzA2MDEyOSBTYWx0ZWRfXwM6an9B0uMk+ MJ5E7SqsXGkXW9EibIrROZ9JKrHbQ5G2r9MIyE5Bcj5oQedD8dJJoYMgVJs3haFP3oc69cIBAc+ PDIUIRWEJUb3UgQ5TTBp52R/y2SN/WY= X-Authority-Analysis: v=2.4 cv=XIwAjwhE c=1 sm=1 tr=0 ts=6a4ba353 cx=c_pps a=hnmNkyzTK/kJ09Xio7VxxA==:117 a=xqWC_Br6kY4A:10 a=IkcTkHD0fZMA:10 a=RAioF0-LDSMA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=yx91gb_oNiZeI1HMLzn7:22 a=b3CbU_ItAAAA:8 a=EUspDBNiAAAA:8 a=1vxtNpAeqxpoFZHZEuYA:9 a=QEXdDO2ut3YA:10 a=PEH46H7Ffwr30OY-TuGO:22 a=Rv2g8BkzVjQTVhhssdqe:22 X-Proofpoint-GUID: U9r4KYM5OlFxH4siJtD0f_iqSsDcY15E X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-07-06_01,2026-07-06_01,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 adultscore=0 clxscore=1015 bulkscore=0 priorityscore=1501 impostorscore=0 malwarescore=0 lowpriorityscore=0 spamscore=0 phishscore=0 suspectscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2607060129 Users of platform_device_alloc() + platform_device_add() must not modify certain fields of the dynamically created platform device object. Update the kernel doc to say which fields are affected and which functions to use. Suggested-by: Manuel Ebner Signed-off-by: Bartosz Golaszewski --- drivers/base/platform.c | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/drivers/base/platform.c b/drivers/base/platform.c index f24a5f406746b53ca9eaab9472f6dd1345e04ad6..9357942d0c79b032645035879b2bed3d53305b9f 100644 --- a/drivers/base/platform.c +++ b/drivers/base/platform.c @@ -619,6 +619,13 @@ static void platform_device_release_full(struct device *dev) * * Create a platform device object which can have other objects attached * to it, and which will have attached objects freed when it is released. + * + * The following fields of the dynamically allocated platform device must not + * be modified manually: resource, num_resources, dev.platform_data, + * dev.of_node and dev.fwnode. Users wishing to do the split platform device + * registration with platform_device_alloc() + platform_device_add() are + * required to use dedicated helpers for adding resources, platform data or + * assigning firmware nodes. */ struct platform_device *platform_device_alloc(const char *name, int id) { -- 2.47.3