wfcqueue: return whether dequeue is dequeuing last element
[urcu.git] / tests / test_urcu_wfcq.c
CommitLineData
5e70d572
MD
1/*
2 * test_urcu_wfcq.c
3 *
4 * Userspace RCU library - example RCU-based lock-free concurrent queue
5 *
6 * Copyright February 2010 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
7 * Copyright February 2010 - Paolo Bonzini <pbonzini@redhat.com>
8 *
9 * This program is free software; you can redistribute it and/or modify
10 * it under the terms of the GNU General Public License as published by
11 * the Free Software Foundation; either version 2 of the License, or
12 * (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License along
20 * with this program; if not, write to the Free Software Foundation, Inc.,
21 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
22 */
23
24#define _GNU_SOURCE
25#include "../config.h"
26#include <stdio.h>
27#include <pthread.h>
28#include <stdlib.h>
29#include <stdint.h>
30#include <stdbool.h>
31#include <string.h>
32#include <sys/types.h>
33#include <sys/wait.h>
34#include <unistd.h>
35#include <stdio.h>
36#include <assert.h>
5e70d572
MD
37#include <errno.h>
38
39#include <urcu/arch.h>
40#include <urcu/tls-compat.h>
985c3168 41#include <urcu/uatomic.h>
2953b501 42#include "cpuset.h"
5e70d572
MD
43
44#ifdef __linux__
45#include <syscall.h>
46#endif
47
48/* hardcoded number of CPUs */
49#define NR_CPUS 16384
50
51#if defined(_syscall0)
52_syscall0(pid_t, gettid)
53#elif defined(__NR_gettid)
54static inline pid_t gettid(void)
55{
56 return syscall(__NR_gettid);
57}
58#else
59#warning "use pid as tid"
60static inline pid_t gettid(void)
61{
62 return getpid();
63}
64#endif
65
66#ifndef DYNAMIC_LINK_TEST
67#define _LGPL_SOURCE
68#endif
5e70d572
MD
69#include <urcu/wfcqueue.h>
70
f5d36fed 71enum test_sync {
372b9ad7
MD
72 TEST_SYNC_NONE = 0,
73 TEST_SYNC_MUTEX,
f5d36fed
MD
74};
75
76static enum test_sync test_sync;
77
372b9ad7
MD
78static int test_force_sync;
79
cf9451dc 80static volatile int test_go, test_stop_enqueue, test_stop_dequeue;
5e70d572
MD
81
82static unsigned long rduration;
83
84static unsigned long duration;
85
86/* read-side C.S. duration, in loops */
87static unsigned long wdelay;
88
ab0aacbe 89static inline void loop_sleep(unsigned long loops)
5e70d572 90{
ab0aacbe 91 while (loops-- != 0)
5e70d572
MD
92 caa_cpu_relax();
93}
94
95static int verbose_mode;
96
cf9451dc
MD
97static int test_dequeue, test_splice, test_wait_empty;
98static int test_enqueue_stopped;
f5d36fed 99
5e70d572
MD
100#define printf_verbose(fmt, args...) \
101 do { \
102 if (verbose_mode) \
f5d36fed 103 printf(fmt, ## args); \
5e70d572
MD
104 } while (0)
105
106static unsigned int cpu_affinities[NR_CPUS];
107static unsigned int next_aff = 0;
108static int use_affinity = 0;
109
110pthread_mutex_t affinity_mutex = PTHREAD_MUTEX_INITIALIZER;
111
5e70d572
MD
112static void set_affinity(void)
113{
95bc7fb9 114#if HAVE_SCHED_SETAFFINITY
5e70d572 115 cpu_set_t mask;
95bc7fb9
MD
116 int cpu, ret;
117#endif /* HAVE_SCHED_SETAFFINITY */
5e70d572
MD
118
119 if (!use_affinity)
120 return;
121
122#if HAVE_SCHED_SETAFFINITY
123 ret = pthread_mutex_lock(&affinity_mutex);
124 if (ret) {
125 perror("Error in pthread mutex lock");
126 exit(-1);
127 }
128 cpu = cpu_affinities[next_aff++];
129 ret = pthread_mutex_unlock(&affinity_mutex);
130 if (ret) {
131 perror("Error in pthread mutex unlock");
132 exit(-1);
133 }
134
135 CPU_ZERO(&mask);
136 CPU_SET(cpu, &mask);
137#if SCHED_SETAFFINITY_ARGS == 2
138 sched_setaffinity(0, &mask);
139#else
140 sched_setaffinity(0, sizeof(mask), &mask);
141#endif
142#endif /* HAVE_SCHED_SETAFFINITY */
143}
144
145/*
146 * returns 0 if test should end.
147 */
148static int test_duration_dequeue(void)
149{
cf9451dc 150 return !test_stop_dequeue;
5e70d572
MD
151}
152
153static int test_duration_enqueue(void)
154{
cf9451dc 155 return !test_stop_enqueue;
5e70d572
MD
156}
157
158static DEFINE_URCU_TLS(unsigned long long, nr_dequeues);
159static DEFINE_URCU_TLS(unsigned long long, nr_enqueues);
160
161static DEFINE_URCU_TLS(unsigned long long, nr_successful_dequeues);
162static DEFINE_URCU_TLS(unsigned long long, nr_successful_enqueues);
cf9451dc
MD
163static DEFINE_URCU_TLS(unsigned long long, nr_empty_dest_enqueues);
164static DEFINE_URCU_TLS(unsigned long long, nr_splice);
5e70d572
MD
165
166static unsigned int nr_enqueuers;
167static unsigned int nr_dequeuers;
168
169static struct cds_wfcq_head __attribute__((aligned(CAA_CACHE_LINE_SIZE))) head;
170static struct cds_wfcq_tail __attribute__((aligned(CAA_CACHE_LINE_SIZE))) tail;
171
f5d36fed 172static void *thr_enqueuer(void *_count)
5e70d572
MD
173{
174 unsigned long long *count = _count;
cf9451dc 175 bool was_nonempty;
5e70d572
MD
176
177 printf_verbose("thread_begin %s, thread id : %lx, tid %lu\n",
6ff854ac
MD
178 "enqueuer", (unsigned long) pthread_self(),
179 (unsigned long) gettid());
5e70d572
MD
180
181 set_affinity();
182
183 while (!test_go)
184 {
185 }
186 cmm_smp_mb();
187
188 for (;;) {
189 struct cds_wfcq_node *node = malloc(sizeof(*node));
190 if (!node)
191 goto fail;
192 cds_wfcq_node_init(node);
cf9451dc 193 was_nonempty = cds_wfcq_enqueue(&head, &tail, node);
5e70d572 194 URCU_TLS(nr_successful_enqueues)++;
cf9451dc
MD
195 if (!was_nonempty)
196 URCU_TLS(nr_empty_dest_enqueues)++;
5e70d572
MD
197
198 if (caa_unlikely(wdelay))
199 loop_sleep(wdelay);
200fail:
201 URCU_TLS(nr_enqueues)++;
202 if (caa_unlikely(!test_duration_enqueue()))
203 break;
204 }
205
cf9451dc 206 uatomic_inc(&test_enqueue_stopped);
5e70d572
MD
207 count[0] = URCU_TLS(nr_enqueues);
208 count[1] = URCU_TLS(nr_successful_enqueues);
cf9451dc 209 count[2] = URCU_TLS(nr_empty_dest_enqueues);
5e70d572 210 printf_verbose("enqueuer thread_end, thread id : %lx, tid %lu, "
cf9451dc
MD
211 "enqueues %llu successful_enqueues %llu, "
212 "empty_dest_enqueues %llu\n",
6ff854ac
MD
213 pthread_self(),
214 (unsigned long) gettid(),
cf9451dc
MD
215 URCU_TLS(nr_enqueues),
216 URCU_TLS(nr_successful_enqueues),
217 URCU_TLS(nr_empty_dest_enqueues));
5e70d572
MD
218 return ((void*)1);
219
220}
221
f5d36fed
MD
222static void do_test_dequeue(enum test_sync sync)
223{
224 struct cds_wfcq_node *node;
225
226 if (sync == TEST_SYNC_MUTEX)
227 node = cds_wfcq_dequeue_blocking(&head, &tail);
228 else
229 node = __cds_wfcq_dequeue_blocking(&head, &tail);
230
231 if (node) {
232 free(node);
233 URCU_TLS(nr_successful_dequeues)++;
234 }
235 URCU_TLS(nr_dequeues)++;
236}
237
238static void do_test_splice(enum test_sync sync)
239{
240 struct cds_wfcq_head tmp_head;
241 struct cds_wfcq_tail tmp_tail;
242 struct cds_wfcq_node *node, *n;
cf9451dc 243 enum cds_wfcq_ret ret;
f5d36fed
MD
244
245 cds_wfcq_init(&tmp_head, &tmp_tail);
246
247 if (sync == TEST_SYNC_MUTEX)
cf9451dc 248 ret = cds_wfcq_splice_blocking(&tmp_head, &tmp_tail,
f5d36fed
MD
249 &head, &tail);
250 else
cf9451dc 251 ret = __cds_wfcq_splice_blocking(&tmp_head, &tmp_tail,
f5d36fed
MD
252 &head, &tail);
253
cf9451dc
MD
254 switch (ret) {
255 case CDS_WFCQ_RET_WOULDBLOCK:
256 assert(0); /* blocking call */
257 break;
258 case CDS_WFCQ_RET_DEST_EMPTY:
259 URCU_TLS(nr_splice)++;
260 /* ok */
261 break;
262 case CDS_WFCQ_RET_DEST_NON_EMPTY:
263 assert(0); /* entirely unexpected */
264 break;
265 case CDS_WFCQ_RET_SRC_EMPTY:
266 /* ok, we could even skip iteration on dest if we wanted */
267 break;
268 }
269
f5d36fed
MD
270 __cds_wfcq_for_each_blocking_safe(&tmp_head, &tmp_tail, node, n) {
271 free(node);
272 URCU_TLS(nr_successful_dequeues)++;
273 URCU_TLS(nr_dequeues)++;
274 }
275}
276
277static void *thr_dequeuer(void *_count)
5e70d572
MD
278{
279 unsigned long long *count = _count;
f5d36fed 280 unsigned int counter;
5e70d572
MD
281
282 printf_verbose("thread_begin %s, thread id : %lx, tid %lu\n",
6ff854ac
MD
283 "dequeuer", (unsigned long) pthread_self(),
284 (unsigned long) gettid());
5e70d572
MD
285
286 set_affinity();
287
288 while (!test_go)
289 {
290 }
291 cmm_smp_mb();
292
293 for (;;) {
f5d36fed
MD
294 if (test_dequeue && test_splice) {
295 if (counter & 1)
296 do_test_dequeue(test_sync);
297 else
298 do_test_splice(test_sync);
299 counter++;
300 } else {
301 if (test_dequeue)
302 do_test_dequeue(test_sync);
303 else
304 do_test_splice(test_sync);
5e70d572 305 }
5e70d572
MD
306 if (caa_unlikely(!test_duration_dequeue()))
307 break;
308 if (caa_unlikely(rduration))
309 loop_sleep(rduration);
310 }
311
312 printf_verbose("dequeuer thread_end, thread id : %lx, tid %lu, "
cf9451dc
MD
313 "dequeues %llu, successful_dequeues %llu, "
314 "nr_splice %llu\n",
6ff854ac
MD
315 pthread_self(),
316 (unsigned long) gettid(),
cf9451dc
MD
317 URCU_TLS(nr_dequeues), URCU_TLS(nr_successful_dequeues),
318 URCU_TLS(nr_splice));
5e70d572
MD
319 count[0] = URCU_TLS(nr_dequeues);
320 count[1] = URCU_TLS(nr_successful_dequeues);
cf9451dc 321 count[2] = URCU_TLS(nr_splice);
5e70d572
MD
322 return ((void*)2);
323}
324
f5d36fed 325static void test_end(unsigned long long *nr_dequeues)
5e70d572
MD
326{
327 struct cds_wfcq_node *node;
328
329 do {
330 node = cds_wfcq_dequeue_blocking(&head, &tail);
331 if (node) {
332 free(node);
333 (*nr_dequeues)++;
334 }
335 } while (node);
336}
337
f5d36fed 338static void show_usage(int argc, char **argv)
5e70d572
MD
339{
340 printf("Usage : %s nr_dequeuers nr_enqueuers duration (s)", argv[0]);
341 printf(" [-d delay] (enqueuer period (in loops))");
342 printf(" [-c duration] (dequeuer period (in loops))");
343 printf(" [-v] (verbose output)");
344 printf(" [-a cpu#] [-a cpu#]... (affinity)");
f5d36fed
MD
345 printf(" [-q] (test dequeue)");
346 printf(" [-s] (test splice, enabled by default)");
347 printf(" [-M] (use mutex external synchronization)");
372b9ad7
MD
348 printf(" Note: default: no external synchronization used.");
349 printf(" [-f] (force user-provided synchronization)");
cf9451dc 350 printf(" [-w] Wait for dequeuer to empty queue");
5e70d572
MD
351 printf("\n");
352}
353
354int main(int argc, char **argv)
355{
356 int err;
357 pthread_t *tid_enqueuer, *tid_dequeuer;
358 void *tret;
359 unsigned long long *count_enqueuer, *count_dequeuer;
360 unsigned long long tot_enqueues = 0, tot_dequeues = 0;
361 unsigned long long tot_successful_enqueues = 0,
cf9451dc
MD
362 tot_successful_dequeues = 0,
363 tot_empty_dest_enqueues = 0,
364 tot_splice = 0;
5e70d572 365 unsigned long long end_dequeues = 0;
cf9451dc 366 int i, a, retval = 0;
5e70d572
MD
367
368 if (argc < 4) {
369 show_usage(argc, argv);
370 return -1;
371 }
372
373 err = sscanf(argv[1], "%u", &nr_dequeuers);
374 if (err != 1) {
375 show_usage(argc, argv);
376 return -1;
377 }
378
379 err = sscanf(argv[2], "%u", &nr_enqueuers);
380 if (err != 1) {
381 show_usage(argc, argv);
382 return -1;
383 }
384
385 err = sscanf(argv[3], "%lu", &duration);
386 if (err != 1) {
387 show_usage(argc, argv);
388 return -1;
389 }
390
391 for (i = 4; i < argc; i++) {
392 if (argv[i][0] != '-')
393 continue;
394 switch (argv[i][1]) {
395 case 'a':
396 if (argc < i + 2) {
397 show_usage(argc, argv);
398 return -1;
399 }
400 a = atoi(argv[++i]);
401 cpu_affinities[next_aff++] = a;
402 use_affinity = 1;
403 printf_verbose("Adding CPU %d affinity\n", a);
404 break;
405 case 'c':
406 if (argc < i + 2) {
407 show_usage(argc, argv);
408 return -1;
409 }
410 rduration = atol(argv[++i]);
411 break;
412 case 'd':
413 if (argc < i + 2) {
414 show_usage(argc, argv);
415 return -1;
416 }
417 wdelay = atol(argv[++i]);
418 break;
419 case 'v':
420 verbose_mode = 1;
421 break;
f5d36fed
MD
422 case 'q':
423 test_dequeue = 1;
424 break;
425 case 's':
426 test_splice = 1;
427 break;
428 case 'M':
429 test_sync = TEST_SYNC_MUTEX;
430 break;
cf9451dc
MD
431 case 'w':
432 test_wait_empty = 1;
433 break;
372b9ad7
MD
434 case 'f':
435 test_force_sync = 1;
436 break;
5e70d572
MD
437 }
438 }
439
f5d36fed
MD
440 /* activate splice test by default */
441 if (!test_dequeue && !test_splice)
442 test_splice = 1;
443
372b9ad7
MD
444 if (test_sync == TEST_SYNC_NONE && nr_dequeuers > 1 && test_dequeue) {
445 if (test_force_sync) {
446 fprintf(stderr, "[WARNING] Using dequeue concurrently "
447 "with other dequeue or splice without external "
448 "synchronization. Expect run-time failure.\n");
449 } else {
450 printf("Enforcing mutex synchronization\n");
451 test_sync = TEST_SYNC_MUTEX;
452 }
453 }
454
5e70d572
MD
455 printf_verbose("running test for %lu seconds, %u enqueuers, "
456 "%u dequeuers.\n",
457 duration, nr_enqueuers, nr_dequeuers);
f5d36fed
MD
458 if (test_dequeue)
459 printf_verbose("dequeue test activated.\n");
460 else
461 printf_verbose("splice test activated.\n");
462 if (test_sync == TEST_SYNC_MUTEX)
463 printf_verbose("External sync: mutex.\n");
464 else
465 printf_verbose("External sync: none.\n");
cf9451dc
MD
466 if (test_wait_empty)
467 printf_verbose("Wait for dequeuers to empty queue.\n");
5e70d572
MD
468 printf_verbose("Writer delay : %lu loops.\n", rduration);
469 printf_verbose("Reader duration : %lu loops.\n", wdelay);
470 printf_verbose("thread %-6s, thread id : %lx, tid %lu\n",
6ff854ac
MD
471 "main", (unsigned long) pthread_self(),
472 (unsigned long) gettid());
5e70d572
MD
473
474 tid_enqueuer = malloc(sizeof(*tid_enqueuer) * nr_enqueuers);
475 tid_dequeuer = malloc(sizeof(*tid_dequeuer) * nr_dequeuers);
cf9451dc
MD
476 count_enqueuer = malloc(3 * sizeof(*count_enqueuer) * nr_enqueuers);
477 count_dequeuer = malloc(3 * sizeof(*count_dequeuer) * nr_dequeuers);
5e70d572
MD
478 cds_wfcq_init(&head, &tail);
479
480 next_aff = 0;
481
482 for (i = 0; i < nr_enqueuers; i++) {
483 err = pthread_create(&tid_enqueuer[i], NULL, thr_enqueuer,
cf9451dc 484 &count_enqueuer[3 * i]);
5e70d572
MD
485 if (err != 0)
486 exit(1);
487 }
488 for (i = 0; i < nr_dequeuers; i++) {
489 err = pthread_create(&tid_dequeuer[i], NULL, thr_dequeuer,
cf9451dc 490 &count_dequeuer[3 * i]);
5e70d572
MD
491 if (err != 0)
492 exit(1);
493 }
494
495 cmm_smp_mb();
496
497 test_go = 1;
498
499 for (i = 0; i < duration; i++) {
500 sleep(1);
501 if (verbose_mode)
502 write (1, ".", 1);
503 }
504
cf9451dc
MD
505 test_stop_enqueue = 1;
506
507 if (test_wait_empty) {
508 while (nr_enqueuers != uatomic_read(&test_enqueue_stopped)) {
509 sleep(1);
510 }
511 while (!cds_wfcq_empty(&head, &tail)) {
512 sleep(1);
513 }
514 }
515
516 test_stop_dequeue = 1;
5e70d572
MD
517
518 for (i = 0; i < nr_enqueuers; i++) {
519 err = pthread_join(tid_enqueuer[i], &tret);
520 if (err != 0)
521 exit(1);
cf9451dc
MD
522 tot_enqueues += count_enqueuer[3 * i];
523 tot_successful_enqueues += count_enqueuer[3 * i + 1];
524 tot_empty_dest_enqueues += count_enqueuer[3 * i + 2];
5e70d572
MD
525 }
526 for (i = 0; i < nr_dequeuers; i++) {
527 err = pthread_join(tid_dequeuer[i], &tret);
528 if (err != 0)
529 exit(1);
cf9451dc
MD
530 tot_dequeues += count_dequeuer[3 * i];
531 tot_successful_dequeues += count_dequeuer[3 * i + 1];
532 tot_splice += count_dequeuer[3 * i + 2];
5e70d572
MD
533 }
534
535 test_end(&end_dequeues);
536
537 printf_verbose("total number of enqueues : %llu, dequeues %llu\n",
538 tot_enqueues, tot_dequeues);
539 printf_verbose("total number of successful enqueues : %llu, "
cf9451dc 540 "enqueues to empty dest : %llu, "
23ae48ef 541 "successful dequeues %llu, "
cf9451dc
MD
542 "splice : %llu\n",
543 tot_successful_enqueues,
544 tot_empty_dest_enqueues,
545 tot_successful_dequeues,
546 tot_splice);
5e70d572
MD
547 printf("SUMMARY %-25s testdur %4lu nr_enqueuers %3u wdelay %6lu "
548 "nr_dequeuers %3u "
549 "rdur %6lu nr_enqueues %12llu nr_dequeues %12llu "
cf9451dc
MD
550 "successful enqueues %12llu enqueues to empty dest %12llu "
551 "successful dequeues %12llu splice %12llu "
5e70d572
MD
552 "end_dequeues %llu nr_ops %12llu\n",
553 argv[0], duration, nr_enqueuers, wdelay,
554 nr_dequeuers, rduration, tot_enqueues, tot_dequeues,
555 tot_successful_enqueues,
cf9451dc
MD
556 tot_empty_dest_enqueues,
557 tot_successful_dequeues, tot_splice, end_dequeues,
5e70d572 558 tot_enqueues + tot_dequeues);
cf9451dc
MD
559
560 if (tot_successful_enqueues != tot_successful_dequeues + end_dequeues) {
5e70d572
MD
561 printf("WARNING! Discrepancy between nr succ. enqueues %llu vs "
562 "succ. dequeues + end dequeues %llu.\n",
563 tot_successful_enqueues,
564 tot_successful_dequeues + end_dequeues);
cf9451dc
MD
565 retval = 1;
566 }
5e70d572 567
cf9451dc
MD
568 /*
569 * If only using splice to dequeue, the enqueuer should see
570 * exactly as many empty queues than the number of non-empty
571 * src splice.
572 */
573 if (test_wait_empty && test_splice && !test_dequeue
574 && tot_empty_dest_enqueues != tot_splice) {
575 printf("WARNING! Discrepancy between empty enqueue (%llu) and "
576 "number of non-empty splice (%llu)\n",
577 tot_empty_dest_enqueues,
578 tot_splice);
579 retval = 1;
580 }
5e70d572
MD
581 free(count_enqueuer);
582 free(count_dequeuer);
583 free(tid_enqueuer);
584 free(tid_dequeuer);
cf9451dc 585 return retval;
5e70d572 586}
This page took 0.046577 seconds and 4 git commands to generate.