summaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorMike Turquette <mturquette@linaro.org>2014-02-24 16:08:41 -0800
committerMike Turquette <mturquette@linaro.org>2014-02-24 17:13:55 -0800
commit86bcfa2e87c42b8af77188e7a939e952199d4da1 (patch)
tree6a0e9bab07e4eb9a930a3a9b782b6a957f2ab3b4 /include
parent05135b4cb4e20a3f36f09e7e5c798eac30c49c21 (diff)
downloadop-kernel-dev-86bcfa2e87c42b8af77188e7a939e952199d4da1.zip
op-kernel-dev-86bcfa2e87c42b8af77188e7a939e952199d4da1.tar.gz
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')
-rw-r--r--include/linux/clk.h14
1 files changed, 14 insertions, 0 deletions
diff --git a/include/linux/clk.h b/include/linux/clk.h
index 0dd9114..fb5e097 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);
/**
OpenPOWER on IntegriCloud