DragonFly On-Line Manual Pages

ck_pr_stall(3)        DragonFly Library Functions Manual        ck_pr_stall(3)

NAME
     ck_pr_stall - busy-wait primitive

LIBRARY
     Concurrency Kit (libck, -lck)

SYNOPSIS
     #include <ck_pr.h>

     void
     ck_pr_stall(void);

DESCRIPTION
     The ck_pr_stall(3) function should be used inside retry paths of busy-
     wait loops.  It not only serves as a compiler barrier, but on some
     architectures it emits cycle-saving instructions.

EXAMPLE

           #include <ck_pr.h>

           static int ready = 0;

           void
           function(void)
           {

                   /* Busy-wait until ready is non-zero. */
                   while (ck_pr_load_int(&ready) == 0)
                           ck_pr_stall();

                   return;
           }

SEE ALSO
     ck_pr_fence_load(3), ck_pr_fence_load_depends(3), ck_pr_fence_store(3),
     ck_pr_fence_memory(3), ck_pr_barrier(3), ck_pr_fas(3), ck_pr_load(3),
     ck_pr_store(3), ck_pr_faa(3), ck_pr_inc(3), ck_pr_dec(3), ck_pr_neg(3),
     ck_pr_not(3), ck_pr_add(3), ck_pr_sub(3), ck_pr_and(3), ck_pr_or(3),
     ck_pr_xor(3), ck_pr_cas(3), ck_pr_btc(3), ck_pr_bts(3), ck_pr_btr(3)

     Additional information available at http://concurrencykit.org/

                                 April 7, 2013