Commit-ID:  512f09801b356c54baef62543e51169f03b2e642
Gitweb:     http://git.kernel.org/tip/512f09801b356c54baef62543e51169f03b2e642
Author:     Boris Ostrovsky <boris.ostrov...@oracle.com>
AuthorDate: Thu, 15 Dec 2016 10:00:57 -0500
Committer:  Thomas Gleixner <t...@linutronix.de>
CommitDate: Thu, 15 Dec 2016 17:48:20 +0100

cpu/hotplug: Clarify description of __cpuhp_setup_state() return value

When invoked with CPUHP_AP_ONLINE_DYN state __cpuhp_setup_state()
is expected to return positive value which is the hotplug state that
the routine assigns.

Signed-off-by: Boris Ostrovsky <boris.ostrov...@oracle.com>
Cc: linux...@vger.kernel.org
Cc: viresh.ku...@linaro.org
Cc: bige...@linutronix.de
Cc: r...@rjwysocki.net
Cc: xen-de...@lists.xenproject.org
Link: 
http://lkml.kernel.org/r/1481814058-4799-2-git-send-email-boris.ostrov...@oracle.com
Signed-off-by: Thomas Gleixner <t...@linutronix.de>

---
 kernel/cpu.c | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/kernel/cpu.c b/kernel/cpu.c
index 217fd2e..5339aca 100644
--- a/kernel/cpu.c
+++ b/kernel/cpu.c
@@ -1586,7 +1586,11 @@ EXPORT_SYMBOL_GPL(__cpuhp_state_add_instance);
  * @startup:   startup callback function
  * @teardown:  teardown callback function
  *
- * Returns 0 if successful, otherwise a proper error code
+ * Returns:
+ *   On success:
+ *      Positive state number if @state is CPUHP_AP_ONLINE_DYN
+ *      0 for all other states
+ *   On failure: proper (negative) error code
  */
 int __cpuhp_setup_state(enum cpuhp_state state,
                        const char *name, bool invoke,

Reply via email to