PM / Sleep: Unify kerneldoc comments in kernel/power/suspend.c
The kerneldoc comments in kernel/power/suspend.c are not formatted in the same way and the quality of some of them is questionable. Unify the formatting and improve the contents. Signed-off-by: Rafael J. Wysocki <rjw@sisk.pl> Acked-by: Srivatsa S. Bhat <srivatsa.bhat@linux.vnet.ibm.com>
This commit is contained in:
parent
6f585f750d
commit
55ae451918
|
@ -38,7 +38,7 @@ static const struct platform_suspend_ops *suspend_ops;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* suspend_set_ops - Set the global suspend method table.
|
* suspend_set_ops - Set the global suspend method table.
|
||||||
* @ops: Pointer to ops structure.
|
* @ops: Suspend operations to use.
|
||||||
*/
|
*/
|
||||||
void suspend_set_ops(const struct platform_suspend_ops *ops)
|
void suspend_set_ops(const struct platform_suspend_ops *ops)
|
||||||
{
|
{
|
||||||
|
@ -58,11 +58,11 @@ bool valid_state(suspend_state_t state)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* suspend_valid_only_mem - generic memory-only valid callback
|
* suspend_valid_only_mem - Generic memory-only valid callback.
|
||||||
*
|
*
|
||||||
* Platform drivers that implement mem suspend only and only need
|
* Platform drivers that implement mem suspend only and only need to check for
|
||||||
* to check for that in their .valid callback can use this instead
|
* that in their .valid() callback can use this instead of rolling their own
|
||||||
* of rolling their own .valid callback.
|
* .valid() callback.
|
||||||
*/
|
*/
|
||||||
int suspend_valid_only_mem(suspend_state_t state)
|
int suspend_valid_only_mem(suspend_state_t state)
|
||||||
{
|
{
|
||||||
|
@ -83,10 +83,11 @@ static int suspend_test(int level)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* suspend_prepare - Do prep work before entering low-power state.
|
* suspend_prepare - Prepare for entering system sleep state.
|
||||||
*
|
*
|
||||||
* This is common code that is called for each state that we're entering.
|
* Common code run for every system sleep state that can be entered (except for
|
||||||
* Run suspend notifiers, allocate a console and stop all processes.
|
* hibernation). Run suspend notifiers, allocate the "suspend" console and
|
||||||
|
* freeze processes.
|
||||||
*/
|
*/
|
||||||
static int suspend_prepare(void)
|
static int suspend_prepare(void)
|
||||||
{
|
{
|
||||||
|
@ -131,9 +132,9 @@ void __attribute__ ((weak)) arch_suspend_enable_irqs(void)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* suspend_enter - enter the desired system sleep state.
|
* suspend_enter - Make the system enter the given sleep state.
|
||||||
* @state: State to enter
|
* @state: System sleep state to enter.
|
||||||
* @wakeup: Returns information that suspend should not be entered again.
|
* @wakeup: Returns information that the sleep state should not be re-entered.
|
||||||
*
|
*
|
||||||
* This function should be called after devices have been suspended.
|
* This function should be called after devices have been suspended.
|
||||||
*/
|
*/
|
||||||
|
@ -199,9 +200,8 @@ static int suspend_enter(suspend_state_t state, bool *wakeup)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* suspend_devices_and_enter - suspend devices and enter the desired system
|
* suspend_devices_and_enter - Suspend devices and enter system sleep state.
|
||||||
* sleep state.
|
* @state: System sleep state to enter.
|
||||||
* @state: state to enter
|
|
||||||
*/
|
*/
|
||||||
int suspend_devices_and_enter(suspend_state_t state)
|
int suspend_devices_and_enter(suspend_state_t state)
|
||||||
{
|
{
|
||||||
|
@ -251,10 +251,10 @@ int suspend_devices_and_enter(suspend_state_t state)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* suspend_finish - Do final work before exiting suspend sequence.
|
* suspend_finish - Clean up before finishing the suspend sequence.
|
||||||
*
|
*
|
||||||
* Call platform code to clean up, restart processes, and free the
|
* Call platform code to clean up, restart processes, and free the console that
|
||||||
* console that we've allocated. This is not called for suspend-to-disk.
|
* we've allocated. This routine is not called for hibernation.
|
||||||
*/
|
*/
|
||||||
static void suspend_finish(void)
|
static void suspend_finish(void)
|
||||||
{
|
{
|
||||||
|
@ -265,14 +265,12 @@ static void suspend_finish(void)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* enter_state - Do common work of entering low-power state.
|
* enter_state - Do common work needed to enter system sleep state.
|
||||||
* @state: pm_state structure for state we're entering.
|
* @state: System sleep state to enter.
|
||||||
*
|
*
|
||||||
* Make sure we're the only ones trying to enter a sleep state. Fail
|
* Make sure that no one else is trying to put the system into a sleep state.
|
||||||
* if someone has beat us to it, since we don't want anything weird to
|
* Fail if that's not the case. Otherwise, prepare for system suspend, make the
|
||||||
* happen when we wake up.
|
* system enter the given sleep state and clean up after wakeup.
|
||||||
* Then, do the setup for suspend, enter the state, and cleaup (after
|
|
||||||
* we've woken up).
|
|
||||||
*/
|
*/
|
||||||
int enter_state(suspend_state_t state)
|
int enter_state(suspend_state_t state)
|
||||||
{
|
{
|
||||||
|
@ -310,11 +308,11 @@ int enter_state(suspend_state_t state)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* pm_suspend - Externally visible function for suspending system.
|
* pm_suspend - Externally visible function for suspending the system.
|
||||||
* @state: Enumerated value of state to enter.
|
* @state: System sleep state to enter.
|
||||||
*
|
*
|
||||||
* Determine whether or not value is within range, get state
|
* Check if the value of @state represents one of the supported states,
|
||||||
* structure, and enter (above).
|
* execute enter_state() and update system suspend statistics.
|
||||||
*/
|
*/
|
||||||
int pm_suspend(suspend_state_t state)
|
int pm_suspend(suspend_state_t state)
|
||||||
{
|
{
|
||||||
|
|
Loading…
Reference in New Issue