[lttng-dev] [RELEASE] Userspace RCU 0.7.3

[Mathieu Desnoyers]

* Gerhard Mack (gmack at innerfire.net) wrote:
> 
> Are there any online examples of how to use this library?  I can't seem to 
> find any.

The perfbook from Paul McKenney now uses userspace RCU in its examples
(http://kernel.org/pub/linux/kernel/people/paulmck/perfbook/perfbook.html)

Also, you will find various small programs in the source tree of the
userspace-rcu packages under tests/ that act as test programs, and also
show how to use the library. (in the git tree:
http://git.lttng.org/?p=userspace-rcu.git;a=tree;f=tests;hb=HEAD)

I guess setting up a tutorial HTML page from the test content would be
valuable, we just have not had the time to do it at this point. Maybe
setting up links to that documentation on the lttng.org/urcu web page
would be a good start though.

Alexandre, when you find a minute, can you look into this ?

Thanks!

Mathieu


> 
> 	Gerhard
> 
> 
> 
> On Fri, 1 Jun 2012, Mathieu Desnoyers wrote:
> 
> > Date: Fri, 1 Jun 2012 14:05:33 -0400
> > From: Mathieu Desnoyers <mathieu.desnoyers at efficios.com>
> > To: linux-kernel at vger.kernel.org, lttng-dev at lists.lttng.org,
> >     rp at svcs.cs.pdx.edu
> > Cc: Paul E. McKenney <paulmck at linux.vnet.ibm.com>,
> >     Lai Jiangshan <laijs at cn.fujitsu.com>,
> >     Stephen Hemminger <shemminger at vyatta.com>
> > Subject: [RELEASE] Userspace RCU 0.7.3
> > 
> > liburcu is a LGPLv2.1 userspace RCU (read-copy-update) library. This
> > data synchronization library provides read-side access which scales
> > linearly with the number of cores. It does so by allowing multiples
> > copies of a given data structure to live at the same time, and by
> > monitoring the data structure accesses to detect grace periods after
> > which memory reclamation is possible.
> > 
> > liburcu-cds provides efficient data structures based on RCU and
> > lock-free algorithms. Those structures include hash tables, queues,
> > stacks, and doubly-linked lists.
> > 
> > This is a minor compatibility-related release, fixing build issues with
> > FreeBSD and NetBSD. On Linux, only the test_perthreadlock fix could
> > change the result of make check (which could previously fail due to
> > non-initialized mutexes), but it does not impact anything installed on
> > the system.
> > 
> > Changelog:
> > 2012-06-01 Userspace RCU 0.7.3
> >         * Fix tests: make dist lib dependency
> >         * Update README for OS supported, tests dependency
> >         * Add CodingStyle to tarball
> >         * Add coding style document
> >         * Test fix: test_perthreadlock uninitialized mutex
> >         * tests: support FreeBSD short "time" args
> >         * freebsd 8.2 fix: define MAP_ANONYMOUS for compatibility
> > 
> > Project website: http://lttng.org/urcu
> > Download link: http://lttng.org/files/urcu/
> > 
> > 
> 
> --
> Gerhard Mack
> 
> gmack at innerfire.net
> 
> <>< As a computer, I find your faith in technology amusing.

-- 
Mathieu Desnoyers
Operating System Efficiency R&D Consultant
EfficiOS Inc.
http://www.efficios.com