From nobody Thu Apr 2 23:53:38 2026 Received: from mail-dy1-f178.google.com (mail-dy1-f178.google.com [74.125.82.178]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 417DF212F89 for ; Sat, 14 Feb 2026 02:52:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.178 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771037574; cv=none; b=tF6BOOrUoRTlOCorVZqT7rItLkS1VztbKWxSmCBC3NAHrjCcbty9q8md9+lzL1WX8w2HOdBzAty4oPFXpSXDEeP6AipcyqBp5bfskmPLLWfA2H38TvWzKbq4Dn+n1bbxQxNMxG0YXxJ4b6JybDQxOC2d+w2qF7ntxDQhc7zPOrY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1771037574; c=relaxed/simple; bh=ZCjgJa1q1ef26Uzc5lZB5kDeX4Sp5b/8xxGjMT9pBKE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=X3TBe2h4x3+alOLOjRgJCqKXnu/z+iBOcrGnQAg+2WENw3QWjU4A3OGJoPYhn5v4qVViiodPvOuC+oVHH8cOgUx3jggxBQE9lStfvBPxcJr3QS8F1156EyvrGDx4tvm1PT9Zxr76QE8gty9ZqCuYV+Cc0nzE812rcR8H6guBCkY= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=GjMRxd3n; arc=none smtp.client-ip=74.125.82.178 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="GjMRxd3n" Received: by mail-dy1-f178.google.com with SMTP id 5a478bee46e88-2ba6aa57d5fso1626495eec.1 for ; Fri, 13 Feb 2026 18:52:53 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1771037572; x=1771642372; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=KyigEN7r87jNeejhSKAK4DhbusMJoWTQIc/5u56FEas=; b=GjMRxd3nPhHlnU/gGwHdaGnZX3W6PnGzcwMmL2K6zSgev1ZscKa8J7hnna9/BZlktb h0O+11iGeb5+Hx6W/DTkeS9dZ3LJH8+YIeeHF0T4AAilGHYCUYT+g6xAXPnlWx0CPX/1 R2JOM7osqPszMZ5X5FZIvoGxvLMNLlTBQ5Ue/g0dPeCMCNtuak1JSZSRDy5CWZihe6tW MBFZ3HU4y+/Bnjzrfg3LxyzFBH2wIF3WSus3OGvvb8s5dxHo1Dbh48z5JJYPLTRlI+3L /jJ4++ButbEvdj98g6vGpbMTrVQ+I6tlyhogR+YKiXi7vMYRxpa1VUb+nO54uFTQynSK 28sQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1771037572; x=1771642372; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=KyigEN7r87jNeejhSKAK4DhbusMJoWTQIc/5u56FEas=; b=QdlLFs+RnmMlxDbmRsX10btpFSsjfzE/EQAQd/utOY7eJtV3g3UZLqzWjFo0Vcsvam OJESTDDARaE35V4XpYEQFMSz0ruX2ywMLolGD+H0L1Wz6TXshuelEd+rw0f2qQBtystm 1cpy8gDkp5OLHXgYhiD6e4zgZleWsGPD3rY0ou+qXn1563/JB80/KKVI1eRddxOfCjXZ /yqK/AXQhZZzGnzYNF8IKl0r6KxDe3B8V+ESsdjBbFxxNcIgZLa3wQ1xOyOeHQ8Py8Ll OyXff+vEBaHnCKJkvDklspHHy84myuiRLM13IsNhpNmjf93u6jFYg3A5HrO5FJjkiZjV da7w== X-Forwarded-Encrypted: i=1; AJvYcCUpK/6ZS2ayS8rBKDC5OOCp0/2zqC2YKDpbfPlJy3k1/6/BL+JfYq1ysXKPS0uwp6N9sANY9nQxQimIfdk=@vger.kernel.org X-Gm-Message-State: AOJu0Yz3dsUE65k/2F1SnYfRm3HM+pQbCQzx442L2HhgoGWovet1lbse O3GxXlz/wovDduTX0RmqqcNFwkzguu90BAUfRFUWsn8zqqCwet96ZrPz X-Gm-Gg: AZuq6aIh1HmUUpuhmziPQssl2qrcd4Xabd5fx6wjikFEkmb9Aw26LoPuvxkM71Os+6h Gg31D/EyXZRfK8ioX3T0X2byFso/dU6IcQHXdZ3KEwDey2T+cAJRdaHgzjDy8ARMItrjaT5Qy1O snOVyqzQtV1PKMv/9o3E27wyrFI8LAnQiswJ5iVw+oNoz7qquzAA4/ZxeE2QM0Utf04JZqJ7PFN myVLdaEBm2pSoSZxjcLtiakj6i5OdK7TJEqBxiwwLG8yme/YfQQBIxHqh8aj0grTpiSxgpduIKD +ynaY3wuYmUyCORAxi1f+iK1U93nRzhk09tTqblEOOS6Jwv0dmme7BGJZq8FTSphaJkQtxkrzKj WfH2f/GjbKS9k+MmWSjyRdNSsZtTkE206hPKErqjTWv+5HgT6VEZWvb+yftdS74YeaQJPxS2GWi GQx67NkzQpqyBDBe6GUQRUjvcQQHbtT1pz8v/DiFUvepnikm8ki7kWPJPqSafjkHJCiREfecGi0 s/bEcGX1NO1uhE= X-Received: by 2002:a05:7300:d517:b0:2b8:64ad:ad4c with SMTP id 5a478bee46e88-2bac97cab51mr512822eec.31.1771037572160; Fri, 13 Feb 2026 18:52:52 -0800 (PST) Received: from dtor-ws.sjc.corp.google.com ([2a00:79e0:2ebe:8:b713:5e7b:5963:d2ad]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2bacb543d4dsm638589eec.7.2026.02.13.18.52.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 13 Feb 2026 18:52:51 -0800 (PST) From: Dmitry Torokhov To: Greg Kroah-Hartman , Danilo Krummrich Cc: "Rafael J. Wysocki" , Arnd Bergmann , Bartosz Golaszewski , Hans de Goede , linux-kernel@vger.kernel.org Subject: [PATCH v2 1/3] driver core: platform: add kerneldoc to struct platform_device_info Date: Fri, 13 Feb 2026 18:52:43 -0800 Message-ID: <20260214025246.2095239-2-dmitry.torokhov@gmail.com> X-Mailer: git-send-email 2.53.0.310.g728cabbaf7-goog In-Reply-To: <20260214025246.2095239-1-dmitry.torokhov@gmail.com> References: <20260214025246.2095239-1-dmitry.torokhov@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add kernel documentation for struct platform_device_info and its individual members. While at it remove an extra indent level from the structure definition. Signed-off-by: Dmitry Torokhov Reviewed-by: Bartosz Golaszewski --- include/linux/platform_device.h | 53 ++++++++++++++++++++++++++------- 1 file changed, 42 insertions(+), 11 deletions(-) diff --git a/include/linux/platform_device.h b/include/linux/platform_devic= e.h index 813da101b5bf..5f54217930e1 100644 --- a/include/linux/platform_device.h +++ b/include/linux/platform_device.h @@ -118,22 +118,53 @@ extern int platform_get_irq_byname_optional(struct pl= atform_device *dev, const char *name); extern int platform_add_devices(struct platform_device **, int); =20 +/** + * struct platform_device_info - set of parameters for creating a platform= device + * @parent: parent device for the new platform device. + * @fwnode: firmware node associated with the device. + * @of_node_reused: indicates that device tree node associated with the de= vice + * is shared with another device, typically its ancestor. Setting this to + * %true prevents the device from being matched via the OF match table, + * and stops the device core from automatically binding pinctrl + * configuration to avoid disrupting the other device. + * @name: name of the device. + * @id: instance ID of the device. Use %PLATFORM_DEVID_NONE if there is on= ly + * one instance of the device, or %PLATFORM_DEVID_AUTO to let the + * kernel automatically assign a unique instance ID. + * @res: set of resources to attach to the device. + * @num_res: number of entries in @res. + * @data: device-specific data for this platform device. + * @size_data: size of device-specific data. + * @dma_mask: DMA mask for the device. + * @properties: a set of software properties for the device. If provided, + * a managed software node will be automatically created and + * assigned to the device. The properties array must be terminated + * with a sentinel entry. + * + * This structure is used to hold information needed to create and register + * a platform device using platform_device_register_full(). + * + * platform_device_register_full() makes deep copies of @name, @res, @data= and + * @properties, so the caller does not need to keep them after registratio= n. + * If the registration is performed during initialization, these can be ma= rked + * as __initconst. + */ struct platform_device_info { - struct device *parent; - struct fwnode_handle *fwnode; - bool of_node_reused; + struct device *parent; + struct fwnode_handle *fwnode; + bool of_node_reused; =20 - const char *name; - int id; + const char *name; + int id; =20 - const struct resource *res; - unsigned int num_res; + const struct resource *res; + unsigned int num_res; =20 - const void *data; - size_t size_data; - u64 dma_mask; + const void *data; + size_t size_data; + u64 dma_mask; =20 - const struct property_entry *properties; + const struct property_entry *properties; }; extern struct platform_device *platform_device_register_full( const struct platform_device_info *pdevinfo); --=20 2.53.0.310.g728cabbaf7-goog