PM / Runtime: Make documentation of runtime_idle() agree with the code
authorRafael J. Wysocki <rjw@sisk.pl>
Thu, 3 Dec 2009 20:04:08 +0000 (21:04 +0100)
committerRafael J. Wysocki <rjw@sisk.pl>
Sun, 6 Dec 2009 15:17:57 +0000 (16:17 +0100)
Currently the ->runtime_idle() callback is documented as having no
return value, but in fact it returns int.  Although its return value
is ignored at the PM core level, it may be used by bus type routines
executing the drivers' ->runtime_idle() callbacks.

Signed-off-by: Rafael J. Wysocki <rjw@sisk.pl>
Reported-by: Alan Stern <stern@rowland.harvard.edu>
Documentation/power/runtime_pm.txt

index f49a33b704d29265d1acd5e5c4c8bf7ee33e1e64..6bb25cb24da9e401e8ca308f6bc3adf9d6856fbf 100644 (file)
@@ -38,7 +38,7 @@ struct dev_pm_ops {
        ...
        int (*runtime_suspend)(struct device *dev);
        int (*runtime_resume)(struct device *dev);
-       void (*runtime_idle)(struct device *dev);
+       int (*runtime_idle)(struct device *dev);
        ...
 };
 
@@ -114,7 +114,8 @@ The action performed by a bus type's ->runtime_idle() callback is totally
 dependent on the bus type in question, but the expected and recommended action
 is to check if the device can be suspended (i.e. if all of the conditions
 necessary for suspending the device are satisfied) and to queue up a suspend
-request for the device in that case.
+request for the device in that case.  The value returned by this callback is
+ignored by the PM core.
 
 The helper functions provided by the PM core, described in Section 4, guarantee
 that the following constraints are met with respect to the bus type's run-time