doc/examples: fix typo in list example
[urcu.git] / doc / examples / list / cds_list_for_each_entry_rcu.c
CommitLineData
d427bff9
MD
1/*
2 * Copyright (C) 2013 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
3 *
4 * THIS MATERIAL IS PROVIDED AS IS, WITH ABSOLUTELY NO WARRANTY EXPRESSED
5 * OR IMPLIED. ANY USE IS AT YOUR OWN RISK.
6 *
7 * Permission is hereby granted to use or copy this program for any
8 * purpose, provided the above notices are retained on all copies.
9 * Permission to modify the code and to distribute modified code is
10 * granted, provided the above notices are retained, and a notice that
11 * the code was modified is included with the above copyright notice.
12 *
8fd9af4a 13 * This example shows how to do a RCU linked list traversal, safely
d427bff9
MD
14 * against concurrent RCU updates.
15 */
16
17#include <stdio.h>
18
19#include <urcu.h> /* Userspace RCU flavor */
20#include <urcu/rculist.h> /* RCU list */
21#include <urcu/compiler.h> /* For CAA_ARRAY_SIZE */
22
23/*
24 * Nodes populated into the list.
25 */
26struct mynode {
27 int value; /* Node content */
28 struct cds_list_head node; /* Linked-list chaining */
29};
30
31int main(int argc, char **argv)
32{
33 int values[] = { -5, 42, 36, 24, };
34 CDS_LIST_HEAD(mylist); /* Defines an empty list head */
35 unsigned int i;
36 int ret = 0;
37 struct mynode *node;
38
39 /*
8fd9af4a 40 * Each thread need using RCU read-side need to be explicitly
d427bff9
MD
41 * registered.
42 */
43 rcu_register_thread();
44
45 /*
46 * Adding nodes to the linked-list. Safe against concurrent
47 * RCU traversals, require mutual exclusion with list updates.
48 */
49 for (i = 0; i < CAA_ARRAY_SIZE(values); i++) {
50 node = malloc(sizeof(*node));
51 if (!node) {
52 ret = -1;
53 goto end;
54 }
55 node->value = values[i];
56 cds_list_add_tail_rcu(&node->node, &mylist);
57 }
58
59 /*
60 * RCU-safe iteration on the list.
61 */
62 printf("mylist content:");
63
64 /*
65 * Surround the RCU read-side critical section with rcu_read_lock()
66 * and rcu_read_unlock().
67 */
68 rcu_read_lock();
69
70 /*
71 * This traversal can be performed concurrently with RCU
72 * updates.
73 */
74 cds_list_for_each_entry_rcu(node, &mylist, node) {
75 printf(" %d", node->value);
76 }
77
78 rcu_read_unlock();
79
80 printf("\n");
81end:
82 rcu_unregister_thread();
83 return ret;
84}
This page took 0.036686 seconds and 4 git commands to generate.