PM / Runtime: Fix kerneldoc comment for rpm_suspend()
This patch fix kerneldoc comments for rpm_suspend(): - 'Cancel a pending idle notification' should be put before, also should be changed to 'Cancel a pending idle notification, autosuspend or suspend'. - idle notification for the device after succeeding suspend has been removed, so update the comment accordingly. [rjw: Modified the subject and changelog slightly.] Signed-off-by: Ming Lei <ming.lei@canonical.com> Signed-off-by: Rafael J. Wysocki <rjw@sisk.pl>
This commit is contained in:
committed by
Rafael J. Wysocki
parent
2fb242adca
commit
47d8f0bac0
@@ -286,14 +286,16 @@ static int rpm_callback(int (*cb)(struct device *), struct device *dev)
|
|||||||
* @dev: Device to suspend.
|
* @dev: Device to suspend.
|
||||||
* @rpmflags: Flag bits.
|
* @rpmflags: Flag bits.
|
||||||
*
|
*
|
||||||
* Check if the device's runtime PM status allows it to be suspended. If
|
* Check if the device's runtime PM status allows it to be suspended.
|
||||||
* another suspend has been started earlier, either return immediately or wait
|
* Cancel a pending idle notification, autosuspend or suspend. If
|
||||||
* for it to finish, depending on the RPM_NOWAIT and RPM_ASYNC flags. Cancel a
|
* another suspend has been started earlier, either return immediately
|
||||||
* pending idle notification. If the RPM_ASYNC flag is set then queue a
|
* or wait for it to finish, depending on the RPM_NOWAIT and RPM_ASYNC
|
||||||
* suspend request; otherwise run the ->runtime_suspend() callback directly.
|
* flags. If the RPM_ASYNC flag is set then queue a suspend request;
|
||||||
* If a deferred resume was requested while the callback was running then carry
|
* otherwise run the ->runtime_suspend() callback directly. If a deferred
|
||||||
* it out; otherwise send an idle notification for the device (if the suspend
|
* resume was requested while the callback was running then carry it out;
|
||||||
* failed) or for its parent (if the suspend succeeded).
|
* otherwise send an idle notification for its parent (if the suspend
|
||||||
|
* succeeded and both ignore_children of parent->power and irq_safe of
|
||||||
|
* dev->power are not set).
|
||||||
*
|
*
|
||||||
* This function must be called under dev->power.lock with interrupts disabled.
|
* This function must be called under dev->power.lock with interrupts disabled.
|
||||||
*/
|
*/
|
||||||
|
Reference in New Issue
Block a user