Re: [PATCH rcu/dev -fixes 4/4] rcu/tree: Use consistent style for comments

Uladzislau Rezki
2020-04-21T13:09:03Z

On Mon, Apr 20, 2020 at 11:38:37AM -0400, Joel Fernandes (Google) wrote:
> Simple clean up of comments in kfree_rcu() code to keep it consistent
> with majority of commenting styles.
>
> Signed-off-by: Joel Fernandes (Google) <joel@joelfernandes.org>
> ---
> kernel/rcu/tree.c | 16 ++++++++--------
> 1 file changed, 8 insertions(+), 8 deletions(-)
>
> diff --git a/kernel/rcu/tree.c b/kernel/rcu/tree.c
> index f6eb3aee0935e..0512e0f9e2f31 100644
> --- a/kernel/rcu/tree.c
> +++ b/kernel/rcu/tree.c
> @@ -3043,15 +3043,15 @@ static inline bool queue_kfree_rcu_work(struct kfree_rcu_cpu *krcp)
> static inline void kfree_rcu_drain_unlock(struct kfree_rcu_cpu *krcp,
> unsigned long flags)
> {
> - // Attempt to start a new batch.
> + /* Attempt to start a new batch. */
> krcp->monitor_todo = false;
> if (queue_kfree_rcu_work(krcp)) {
> - // Success! Our job is done here.
> + /* Success! Our job is done here. */
> raw_spin_unlock_irqrestore(&krcp->lock, flags);
> return;
> }
>
> - // Previous RCU batch still in progress, try again later.
> + /* Previous RCU batch still in progress, try again later. */
> krcp->monitor_todo = true;
> schedule_delayed_work(&krcp->monitor_work, KFREE_DRAIN_JIFFIES);
> raw_spin_unlock_irqrestore(&krcp->lock, flags);
> @@ -3152,14 +3152,14 @@ void kfree_call_rcu(struct rcu_head *head, rcu_callback_t func)
> unsigned long flags;
> struct kfree_rcu_cpu *krcp;
>
> - local_irq_save(flags); // For safely calling this_cpu_ptr().
> + local_irq_save(flags); /* For safely calling this_cpu_ptr(). */
> krcp = this_cpu_ptr(&krc);
> if (krcp->initialized)
> raw_spin_lock(&krcp->lock);
>
> - // Queue the object but don't yet schedule the batch.
> + /* Queue the object but don't yet schedule the batch. */
> if (debug_rcu_head_queue(head)) {
> - // Probable double kfree_rcu(), just leak.
> + /* Probable double kfree_rcu(), just leak. */
> WARN_ONCE(1, "%s(): Double-freed call. rcu_head %p\n",
> __func__, head);
> goto unlock_return;
> @@ -3177,7 +3177,7 @@ void kfree_call_rcu(struct rcu_head *head, rcu_callback_t func)
>
> WRITE_ONCE(krcp->count, krcp->count + 1);
>
> - // Set timer to drain after KFREE_DRAIN_JIFFIES.
> + /* Set timer to drain after KFREE_DRAIN_JIFFIES. */
> if (rcu_scheduler_active == RCU_SCHEDULER_RUNNING &&
> !krcp->monitor_todo) {
> krcp->monitor_todo = true;
> @@ -3723,7 +3723,7 @@ int rcutree_offline_cpu(unsigned int cpu)
>
> rcutree_affinity_setting(cpu, cpu);
>
> - // nohz_full CPUs need the tick for stop-machine to work quickly
> + /* nohz_full CPUs need the tick for stop-machine to work quickly */
> tick_dep_set(TICK_DEP_BIT_RCU);
> return 0;
> }
> --
> 2.26.1.301.g55bc3eb7cb9-goog
>
Reviewed-by: Uladzislau Rezki (Sony) <urezki@gmail.com>

--
Vlad Rezki