David Marchand <[email protected]> 于2022年5月25日周三 19:27写道:

> Title should be: "ovs-rcu: Add ovsrcu_barrier."
>
> On Wed, May 25, 2022 at 3:36 AM Peng He <[email protected]> wrote:
> >
> > rcu_barrier will block the current thread until all the postponed
>
> ovsrcu_barrier*
>
> > rcu job has been finished. it's like the OVS's version of
> > the kernel rcu_barrier()
>
> It's like a OVS version of the Linux kernel rcu_barrier().
>
>
> >
> > Signed-off-by: Peng He <[email protected]>
> > Co-authored-by: Eelco Chaudron <[email protected]>
> > Signed-off-by: Eelco Chaudron <[email protected]>
> > ---
> >  lib/ovs-rcu.c | 38 ++++++++++++++++++++++++++++++++++++++
> >  lib/ovs-rcu.h | 15 +++++++++++++++
> >  2 files changed, 53 insertions(+)
> >
> > diff --git a/lib/ovs-rcu.c b/lib/ovs-rcu.c
> > index 1866bd308..86741f2b4 100644
> > --- a/lib/ovs-rcu.c
> > +++ b/lib/ovs-rcu.c
> > @@ -444,3 +444,41 @@ ovsrcu_init_module(void)
> >          ovsthread_once_done(&once);
> >      }
> >  }
> > +
> > +static void
> > +ovsrcu_barrier_func(void *seq_)
> > +{
> > +    struct seq *seq = (struct seq *) seq_;
> > +    seq_change(seq);
> > +}
> > +
> > +
>
> One blank line is enough.
>
>
> > +/* Similar to the kernel rcu_barrier, ovsrcu_barrier waits for all
> outstanding
> > + * RCU callbacks to complete. However, unlike the kernel rcu_barrier,
> which
> > + * might retrun immediately if there are no outstanding RCU callbacks,
>
> return*
>
> > + * this API will at least wait for a grace period.
> > + *
> > + * Another issue the caller might need to know it's that the barrier is
> just
> > + * for "one-shot", i.e. if inside some RCU callbacks, another RCU
> callback is
> > + * registered, this API only guarantees the first round of RCU
> callbacks have
> > + * been executed after it returns.
>
> to know is* that
>
>
> > + */
> > +void
> > +ovsrcu_barrier(void)
> > +{
> > +    struct seq *seq = seq_create();
> > +    /* First let all threads flush their cbsets. */
> > +    ovsrcu_synchronize();
> > +
> > +    /* Then register a new cbset, ensure this cbset
> > +     * is at the tail of the global list. */
> > +    uint64_t seqno = seq_read(seq);
> > +    ovsrcu_postpone__(ovsrcu_barrier_func, (void *) seq);
> > +
> > +    do {
> > +        seq_wait(seq, seqno);
> > +        poll_block();
> > +    } while (seqno == seq_read(seq));
> > +
> > +    seq_destroy(seq);
> > +}
> > diff --git a/lib/ovs-rcu.h b/lib/ovs-rcu.h
> > index ecc4c9201..32a49069e 100644
> > --- a/lib/ovs-rcu.h
> > +++ b/lib/ovs-rcu.h
> > @@ -155,6 +155,19 @@
> >   *         port_delete(id);
> >   *     }
> >   *
> > + * Use ovsrcu_barrier() to wait for all the outstanding RCU callbacks to
> > + * finish. This is useful when you have to destroy some resources
> however
> > + * these resources are referenced in the outstanding RCU callbacks.
> > + *
> > + * void rcu_cb(void *A) {
> > + *     Use_A_do_something(A);
>
> do_something() is enough.
>
>
> > + * }
> > + *
> > + * void destroy_A() {
> > + *     ovsrcu_postpone(rcu_cb, A); // will use A later
> > + *     ovsrcu_barrier(); // wait for rcu_cb done
> > + *     do_destroy_A(); // free A
> > + * }
>
> In these comments, code snippets are indented with an additional level.
> IOW:
>
> + * Use ovsrcu_barrier() to wait for all the outstanding RCU callbacks to
> + * finish. This is useful when you have to destroy some resources however
> + * these resources are referenced in the outstanding RCU callbacks.
> + *
> + *     void rcu_cb(void *A) {
> + *        do_something(A);
> + *     }
> + *
> + *     void destroy_A() {
> + *         ovsrcu_postpone(rcu_cb, A); // will use A later
> + *         ovsrcu_barrier(); // wait for rcu_cb done
> + *         do_destroy_A(); // free A
> + *     }
>
>
> >   */
> >
> >  #include "compiler.h"
> > @@ -310,4 +323,6 @@ void ovsrcu_synchronize(void);
> >
> >  void ovsrcu_exit(void);
> >
> > +void ovsrcu_barrier(void);
> > +
> >  #endif /* ovs-rcu.h */
> > --
> > 2.25.1
> >
>
> Reviewed-by: David Marchand <[email protected]>
>
>
> I think we should have a unit test for this new part of the ovs-rcu API.
>

OK. I am going to add it in test-rcu.c.
Thanks for the review!

>
>
> --
> David Marchand
>
>

-- 
hepeng
_______________________________________________
dev mailing list
[email protected]
https://mail.openvswitch.org/mailman/listinfo/ovs-dev

Reply via email to