diff options
author | Mike Turquette <mturquette@linaro.org> | 2014-02-24 16:08:41 -0800 |
---|---|---|
committer | Mike Turquette <mturquette@linaro.org> | 2014-02-24 17:13:55 -0800 |
commit | 86bcfa2e87c42b8af77188e7a939e952199d4da1 (patch) | |
tree | 6a0e9bab07e4eb9a930a3a9b782b6a957f2ab3b4 /include/linux/clk.h | |
parent | 05135b4cb4e20a3f36f09e7e5c798eac30c49c21 (diff) |
clk: add pr_debug & kerneldoc around clk notifiers
Both the pr_err and the additional kerneldoc aim to help when debugging
errors thrown from within a clock rate-change notifier callback.
Reported-by: Sören Brinkmann <soren.brinkmann@xilinx.com>
Acked-by: Sören Brinkmann <soren.brinkmann@xilinx.com>
Signed-off-by: Mike Turquette <mturquette@linaro.org>
Diffstat (limited to 'include/linux/clk.h')
-rw-r--r-- | include/linux/clk.h | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/include/linux/clk.h b/include/linux/clk.h index 0dd91148165..fb5e097d8f7 100644 --- a/include/linux/clk.h +++ b/include/linux/clk.h @@ -78,8 +78,22 @@ struct clk_notifier_data { unsigned long new_rate; }; +/** + * clk_notifier_register: register a clock rate-change notifier callback + * @clk: clock whose rate we are interested in + * @nb: notifier block with callback function pointer + * + * ProTip: debugging across notifier chains can be frustrating. Make sure that + * your notifier callback function prints a nice big warning in case of + * failure. + */ int clk_notifier_register(struct clk *clk, struct notifier_block *nb); +/** + * clk_notifier_unregister: unregister a clock rate-change notifier callback + * @clk: clock whose rate we are no longer interested in + * @nb: notifier block which will be unregistered + */ int clk_notifier_unregister(struct clk *clk, struct notifier_block *nb); /** |