Re: [PATCH v2] completion: Document that reinit_completion() must be called after complete_all()

From: Ingo Molnar
Date: Wed Aug 16 2017 - 14:06:57 EST



* Linus Torvalds <torvalds@xxxxxxxxxxxxxxxxxxxx> wrote:

> On Wed, Aug 16, 2017 at 10:12 AM, Steven Rostedt <rostedt@xxxxxxxxxxx> wrote:
> > The function complete_all() modifies the completion "done" variable to
> > UINT_MAX, and no other caller (wait_for_completion(), etc) will modify
> > it back to zero. That means that any call to complete_all() must have a
> > reinit_completion() before that completion can be used again.
> >
> > Document this fact by the complete_all() function.
> >
> > Also document that completion_done() will always return true if
> > complete_all() is called.
>
> Ack. Do I take it directly or is it indended for some other tree?

Will add it to the scheduler tree.

Thanks,

Ingo