github-mirror/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-09-22 12:44:03 +02:00
Code Issues Actions Packages Projects Releases Wiki Activity Graph

driver core: update kerneldoc for platform_device_alloc()

Browse Source 
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 <manuelebner@mailbox.org>
Signed-off-by: Bartosz Golaszewski <bartosz.golaszewski@oss.qualcomm.com>
Link: https://patch.msgid.link/20260706-pdev-fwnode-ref-v3-5-1ff028e33779@oss.qualcomm.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
Bartosz Golaszewski 2026-07-06 14:44:17 +02:00 committed by Greg Kroah-Hartman
parent 5b84ef0b02
commit 67e1ddc9f7
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
drivers/base/platform.c
View File

@ -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)
{