On Tue, Nov 29, 2016 at 12:46:59PM +0100, Paolo Bonzini wrote: > A QemuLockCnt comprises a counter and a mutex, with primitives > to increment and decrement the counter, and to take and release the > mutex. It can be used to do lock-free visits to a data structure > whenever mutexes would be too heavy-weight and the critical section > is too long for RCU. > > This could be implemented simply by protecting the counter with the > mutex, but QemuLockCnt is harder to misuse and more efficient. > > Signed-off-by: Paolo Bonzini <pbonz...@redhat.com> > --- > docs/lockcnt.txt | 343 > ++++++++++++++++++++++++++++++++++++++++++++++++++ > include/qemu/thread.h | 17 +++ > util/Makefile.objs | 1 + > util/lockcnt.c | 113 +++++++++++++++++ > 4 files changed, 474 insertions(+) > create mode 100644 docs/lockcnt.txt > create mode 100644 util/lockcnt.c > > diff --git a/docs/lockcnt.txt b/docs/lockcnt.txt > new file mode 100644 > index 0000000..fc5d240 > --- /dev/null > +++ b/docs/lockcnt.txt > @@ -0,0 +1,343 @@ > +DOCUMENTATION FOR LOCKED COUNTERS (aka QemuLockCnt) > +===================================================
This file contains all the documentation but the header file has no doc comments. Could you move everything into the header file (like include/qom/object.h)?
signature.asc
Description: PGP signature