summaryrefslogtreecommitdiff
path: root/drivers/base/platform.c
diff options
context:
space:
mode:
authorJani Nikula <ext-jani.1.nikula@nokia.com>2010-03-11 18:11:45 +0200
committerGreg Kroah-Hartman <gregkh@suse.de>2010-03-19 07:12:21 -0700
commitf0eae0ed3b7d4182a6b4dd03540a738518ea3163 (patch)
treef7432690b4df967f10643fa82f05f57aecba142f /drivers/base/platform.c
parent178a5b35b2777346206d4b577b36d10061732f8c (diff)
downloadlinux-3.10-f0eae0ed3b7d4182a6b4dd03540a738518ea3163.tar.gz
linux-3.10-f0eae0ed3b7d4182a6b4dd03540a738518ea3163.tar.bz2
linux-3.10-f0eae0ed3b7d4182a6b4dd03540a738518ea3163.zip
driver-core: document ERR_PTR() return values
A number of functions in the driver core return ERR_PTR() values on error. Document this in the kernel-doc of the functions. Signed-off-by: Jani Nikula <ext-jani.1.nikula@nokia.com> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
Diffstat (limited to 'drivers/base/platform.c')
-rw-r--r--drivers/base/platform.c6
1 files changed, 6 insertions, 0 deletions
diff --git a/drivers/base/platform.c b/drivers/base/platform.c
index f6bcf22e6bd..4b4b565c835 100644
--- a/drivers/base/platform.c
+++ b/drivers/base/platform.c
@@ -362,6 +362,8 @@ EXPORT_SYMBOL_GPL(platform_device_unregister);
* enumeration tasks, they don't fully conform to the Linux driver model.
* In particular, when such drivers are built as modules, they can't be
* "hotplugged".
+ *
+ * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
*/
struct platform_device *platform_device_register_simple(const char *name,
int id,
@@ -408,6 +410,8 @@ EXPORT_SYMBOL_GPL(platform_device_register_simple);
* allocated for the device allows drivers using such devices to be
* unloaded without waiting for the last reference to the device to be
* dropped.
+ *
+ * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
*/
struct platform_device *platform_device_register_data(
struct device *parent,
@@ -559,6 +563,8 @@ EXPORT_SYMBOL_GPL(platform_driver_probe);
*
* Use this in legacy-style modules that probe hardware directly and
* register a single platform device and corresponding platform driver.
+ *
+ * Returns &struct platform_device pointer on success, or ERR_PTR() on error.
*/
struct platform_device * __init_or_module platform_create_bundle(
struct platform_driver *driver,