Skip to contentSkip to conversation

clk: Fix notifier documentation

PATCH In review Soren Brinkmann 2 participants 5 messages Jan 22, 2014 – Feb 5, 2014 Common clk

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 clk: Fix notifier documentation

Contradicting to documenation, the notifier callbacks do receive the original clock rate in struct clk_notifier_data.old_rate and the new frequency struct clk_notifier_data.new_rate, independent of the notification reason.

This behavior also seems to make more sense, since callbacks can use the same code to deterimine whether clocks are scaled up or down. Something which would not even possible in the post-rate-change case if the behavior was as documented.

---
Hi Mike,

I am working with some clock notifiers and if my results are correct the notifiers behave differently from how they are documented.
I think the actual behavior makes more sense than the documented and my original plan was to change the behavior, but it seems I might get away with a doc-update.

Thanks,
S?ren

 drivers/clk/clk.c | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)
drivers/clk/clk.c +3 -12
index 2cf2ea6b77a1..26825db03e64 100644
@@ -1983,20 +1983,11 @@ EXPORT_SYMBOL_GPL(devm_clk_unregister);
  * re-enter into the clk framework by calling any top-level clk APIs;
  * this will cause a nested prepare_lock mutex.
  *
- * Pre-change notifier callbacks will be passed the current, pre-change
- * rate of the clk via struct clk_notifier_data.old_rate.  The new,
- * post-change rate of the clk is passed via struct
+ * In all notification cases cases (pre, post and abort rate change) the
+ * original clock rate is passed to the callback via struct
+ * clk_notifier_data.old_rate and the new frequency is passed via struct
  * clk_notifier_data.new_rate.
  *
- * Post-change notifiers will pass the now-current, post-change rate of
- * the clk in both struct clk_notifier_data.old_rate and struct
- * clk_notifier_data.new_rate.
- *
- * Abort-change notifiers are effectively the opposite of pre-change
- * notifiers: the original pre-change clk rate is passed in via struct
- * clk_notifier_data.new_rate and the failed post-change rate is passed
- * in via struct clk_notifier_data.old_rate.
- *
  * clk_notifier_register() must be called from non-atomic context.
  * Returns -EINVAL if called with null arguments, -ENOMEM upon
  * allocation failure; otherwise, passes along the return value of
Signature · 1 line
1.8.5.3
#1 lore raw

ping?

Quoted 58 lines · Soren Brinkmann

Contradicting to documenation, the notifier callbacks do receive the original clock rate in struct clk_notifier_data.old_rate and the new frequency struct clk_notifier_data.new_rate, independent of the notification reason.

This behavior also seems to make more sense, since callbacks can use the same code to deterimine whether clocks are scaled up or down. Something which would not even possible in the post-rate-change case if the behavior was as documented.

---
Hi Mike,

I am working with some clock notifiers and if my results are correct the notifiers behave differently from how they are documented.
I think the actual behavior makes more sense than the documented and my original plan was to change the behavior, but it seems I might get away with a doc-update.

Thanks,
S?ren

 drivers/clk/clk.c | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)
drivers/clk/clk.c +3 -12
index 2cf2ea6b77a1..26825db03e64 100644
@@ -1983,20 +1983,11 @@ EXPORT_SYMBOL_GPL(devm_clk_unregister);
  * re-enter into the clk framework by calling any top-level clk APIs;
  * this will cause a nested prepare_lock mutex.
  *
- * Pre-change notifier callbacks will be passed the current, pre-change
- * rate of the clk via struct clk_notifier_data.old_rate.  The new,
- * post-change rate of the clk is passed via struct
+ * In all notification cases cases (pre, post and abort rate change) the
+ * original clock rate is passed to the callback via struct
+ * clk_notifier_data.old_rate and the new frequency is passed via struct
  * clk_notifier_data.new_rate.
  *
- * Post-change notifiers will pass the now-current, post-change rate of
- * the clk in both struct clk_notifier_data.old_rate and struct
- * clk_notifier_data.new_rate.
- *
- * Abort-change notifiers are effectively the opposite of pre-change
- * notifiers: the original pre-change clk rate is passed in via struct
- * clk_notifier_data.new_rate and the failed post-change rate is passed
- * in via struct clk_notifier_data.old_rate.
- *
  * clk_notifier_register() must be called from non-atomic context.
  * Returns -EINVAL if called with null arguments, -ENOMEM upon
  * allocation failure; otherwise, passes along the return value of
Signature · 1 line
1.8.5.3
#2 lore raw
Quoted 1 line · S?ren Brinkmann

ping?

Hi Soren,

I'm a bit slow to review patches during the merge window. Thanks for the doc update. I'll take it in after -rc1 drops.

Regards,
Mik

Quoted 61 lines · Soren Brinkmann
Quoted 58 lines

Contradicting to documenation, the notifier callbacks do receive the original clock rate in struct clk_notifier_data.old_rate and the new frequency struct clk_notifier_data.new_rate, independent of the notification reason.

This behavior also seems to make more sense, since callbacks can use the same code to deterimine whether clocks are scaled up or down. Something which would not even possible in the post-rate-change case if the behavior was as documented.

---
Hi Mike,

I am working with some clock notifiers and if my results are correct the notifiers behave differently from how they are documented.
I think the actual behavior makes more sense than the documented and my original plan was to change the behavior, but it seems I might get away with a doc-update.

Thanks,
S?ren

 drivers/clk/clk.c | 15 +++------------
 1 file changed, 3 insertions(+), 12 deletions(-)
drivers/clk/clk.c +3 -13
index 2cf2ea6b77a1..26825db03e64 100644
@@ -1983,20 +1983,11 @@ EXPORT_SYMBOL_GPL(devm_clk_unregister);
  * re-enter into the clk framework by calling any top-level clk APIs;
  * this will cause a nested prepare_lock mutex.
  *
- * Pre-change notifier callbacks will be passed the current, pre-change
- * rate of the clk via struct clk_notifier_data.old_rate.  The new,
- * post-change rate of the clk is passed via struct
+ * In all notification cases cases (pre, post and abort rate change) the
+ * original clock rate is passed to the callback via struct
+ * clk_notifier_data.old_rate and the new frequency is passed via struct
  * clk_notifier_data.new_rate.
  *
- * Post-change notifiers will pass the now-current, post-change rate of
- * the clk in both struct clk_notifier_data.old_rate and struct
- * clk_notifier_data.new_rate.
- *
- * Abort-change notifiers are effectively the opposite of pre-change
- * notifiers: the original pre-change clk rate is passed in via struct
- * clk_notifier_data.new_rate and the failed post-change rate is passed
- * in via struct clk_notifier_data.old_rate.
- *
  * clk_notifier_register() must be called from non-atomic context.
  * Returns -EINVAL if called with null arguments, -ENOMEM upon
  * allocation failure; otherwise, passes along the return value of
--

1.8.5.3

#3 lore raw
Quoted 8 lines · Mike Turquette
Quoted 1 line · S?ren Brinkmann

ping?

Hi Soren,

I'm a bit slow to review patches during the merge window. Thanks for the doc update. I'll take it in after -rc1 drops.

Sorry for my impatience. Thank you!

S?ren

#4 lore raw

PATCH 1/1 clk: Fix notifier documentation

Quoting S?ren Brinkmann (2014-02-03 08:36:57)

Quoted 11 lines · Mike Turquette
Quoted 8 lines
Quoted 1 line · S?ren Brinkmann

ping?

Hi Soren,

I'm a bit slow to review patches during the merge window. Thanks for the doc update. I'll take it in after -rc1 drops.

Sorry for my impatience. Thank you!

Taken into clk-next.

Regards,
Mike

Quoted 4 lines

S?ren