From: Mathieu Desnoyers Date: Fri, 21 Jun 2013 18:12:54 +0000 (-0400) Subject: doc/examples: cds_list_for_each_entry_rcu X-Git-Tag: v0.8.0~54 X-Git-Url: https://git.lttng.org./?a=commitdiff_plain;h=d427bff9f837b32b4f7cd000078ed43cc0929a73;p=userspace-rcu.git doc/examples: cds_list_for_each_entry_rcu Signed-off-by: Mathieu Desnoyers --- diff --git a/.gitignore b/.gitignore index 411fd22..01611b4 100644 --- a/.gitignore +++ b/.gitignore @@ -76,6 +76,7 @@ tests/*.log doc/examples/list/cds_list_add_rcu doc/examples/list/cds_list_add_tail_rcu doc/examples/list/cds_list_del_rcu +doc/examples/list/cds_list_for_each_entry_rcu doc/examples/list/cds_list_replace_rcu #automake diff --git a/doc/examples/Makefile.am b/doc/examples/Makefile.am index f80ebeb..b6ad791 100644 --- a/doc/examples/Makefile.am +++ b/doc/examples/Makefile.am @@ -16,10 +16,12 @@ dist_doc_examples_list_DATA = \ list/Makefile.cds_list_add_rcu \ list/Makefile.cds_list_add_tail_rcu \ list/Makefile.cds_list_del_rcu \ + list/Makefile.cds_list_for_each_entry_rcu \ list/Makefile.cds_list_replace_rcu \ list/cds_list_add_rcu.c \ list/cds_list_add_tail_rcu.c \ list/cds_list_del_rcu.c \ + list/cds_list_for_each_entry_rcu.c \ list/cds_list_replace_rcu.c if NO_SHARED diff --git a/doc/examples/list/Makefile b/doc/examples/list/Makefile index efd8a04..e62a883 100644 --- a/doc/examples/list/Makefile +++ b/doc/examples/list/Makefile @@ -15,6 +15,7 @@ all: $(MAKE) -f Makefile.cds_list_add_rcu $(MAKE) -f Makefile.cds_list_add_tail_rcu $(MAKE) -f Makefile.cds_list_del_rcu + $(MAKE) -f Makefile.cds_list_for_each_entry_rcu $(MAKE) -f Makefile.cds_list_replace_rcu .PHONY: clean @@ -22,4 +23,5 @@ clean: $(MAKE) -f Makefile.cds_list_add_rcu clean $(MAKE) -f Makefile.cds_list_add_tail_rcu clean $(MAKE) -f Makefile.cds_list_del_rcu clean + $(MAKE) -f Makefile.cds_list_for_each_entry_rcu $(MAKE) -f Makefile.cds_list_replace_rcu clean diff --git a/doc/examples/list/Makefile.cds_list_for_each_entry_rcu b/doc/examples/list/Makefile.cds_list_for_each_entry_rcu new file mode 100644 index 0000000..f9e6467 --- /dev/null +++ b/doc/examples/list/Makefile.cds_list_for_each_entry_rcu @@ -0,0 +1,20 @@ +# Copyright (C) 2013 Mathieu Desnoyers +# +# THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED +# OR IMPLIED. ANY USE IS AT YOUR OWN RISK. +# +# Permission is hereby granted to use or copy this program for any +# purpose, provided the above notices are retained on all copies. +# Permission to modify the code and to distribute modified code is +# granted, provided the above notices are retained, and a notice that +# the code was modified is included with the above copyright notice. +# +# This makefile is purposefully kept simple to support GNU and BSD make. + +EXAMPLE_NAME = cds_list_for_each_entry_rcu + +SOURCES = $(EXAMPLE_NAME).c +OBJECTS = $(EXAMPLE_NAME).o +BINARY = $(EXAMPLE_NAME) + +include ../Makefile.examples.template diff --git a/doc/examples/list/cds_list_for_each_entry_rcu.c b/doc/examples/list/cds_list_for_each_entry_rcu.c new file mode 100644 index 0000000..b0aff29 --- /dev/null +++ b/doc/examples/list/cds_list_for_each_entry_rcu.c @@ -0,0 +1,84 @@ +/* + * Copyright (C) 2013 Mathieu Desnoyers + * + * THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED + * OR IMPLIED. ANY USE IS AT YOUR OWN RISK. + * + * Permission is hereby granted to use or copy this program for any + * purpose, provided the above notices are retained on all copies. + * Permission to modify the code and to distribute modified code is + * granted, provided the above notices are retained, and a notice that + * the code was modified is included with the above copyright notice. + * + * This example shows how to to a RCU linked list traversal, safely + * against concurrent RCU updates. + */ + +#include + +#include /* Userspace RCU flavor */ +#include /* RCU list */ +#include /* For CAA_ARRAY_SIZE */ + +/* + * Nodes populated into the list. + */ +struct mynode { + int value; /* Node content */ + struct cds_list_head node; /* Linked-list chaining */ +}; + +int main(int argc, char **argv) +{ + int values[] = { -5, 42, 36, 24, }; + CDS_LIST_HEAD(mylist); /* Defines an empty list head */ + unsigned int i; + int ret = 0; + struct mynode *node; + + /* + * Each thread need using RCU read-side need to be explicitely + * registered. + */ + rcu_register_thread(); + + /* + * Adding nodes to the linked-list. Safe against concurrent + * RCU traversals, require mutual exclusion with list updates. + */ + for (i = 0; i < CAA_ARRAY_SIZE(values); i++) { + node = malloc(sizeof(*node)); + if (!node) { + ret = -1; + goto end; + } + node->value = values[i]; + cds_list_add_tail_rcu(&node->node, &mylist); + } + + /* + * RCU-safe iteration on the list. + */ + printf("mylist content:"); + + /* + * Surround the RCU read-side critical section with rcu_read_lock() + * and rcu_read_unlock(). + */ + rcu_read_lock(); + + /* + * This traversal can be performed concurrently with RCU + * updates. + */ + cds_list_for_each_entry_rcu(node, &mylist, node) { + printf(" %d", node->value); + } + + rcu_read_unlock(); + + printf("\n"); +end: + rcu_unregister_thread(); + return ret; +}