Async Operation Interface Atomic Operations Interface Base64 Interface Bit Operations Interface Buffer Interface Buffer Stream Interface Buffer Format Interface Condition Variable Interface Config File Interface Directory Interface Dynamic List Interface Shared Object Interface Environment Interface Errno Interface SilcExampleAPI Fd Stream Interface File Util Interface Finite State Machine GetOpt Interface Global Variable Interface Hash Table Interface HTTP PHP Translator HTTP Server Interface List Interface Local Network Stream Interface Logging Interface Memory Interface MIME Interface Mutex Interface Network Interface Random Number Interface Regex Interface Runtime Toolkit Interface Scheduler Interface Snprintf Interface Socket Stream Interface Memory Pool Interface Stream Interface Stringprep Interface String Utilities Thread Interface Thread Queue Interface Time Interface Timer Interface Binary Search Tree Interface Types and Definitions UTF-8 Interface Misc Utilities XML Interface

Atomic Operations Interface

DESCRIPTION

SILC Atomic operations interface provides utility functions to perform simple operations with integers atomically. This enables fast integer additions and subtractions safely in multithreaded environment. It is especially suited for reference counters and similar and is much faster than using locking. This interface supports 8, 16 and 32 bit integers and 32 or 64 bit pointers.

On some platforms this interface actually use mutual exclusion lock instead of true atomic operations, leading into some performace penalty. Also on some platforms the 8 and 16 bit integers are actually 32 bit integers.

Fast operations are supported on: x86, x86_64, ia64, PPC

EXAMPLE

 SilcAtomic32 refcnt;

 // Initialize atomic variable
 silc_atomic_init32(&refcnt, 0);

 // Increment referene counter by one
 silc_atomic_add_int32(&refcnt, 1);

 // Uninitialize atomic variable
 silc_atomic_uninit32(&refcnt);

TABLE OF CONTENTS

• SilcAtomic32
• SilcAtomic16
• SilcAtomic8
• SilcAtomicPointer
• silc_atomic_init32
• silc_atomic_init16
• silc_atomic_init8
• silc_atomic_init_pointer
• silc_atomic_uninit32
• silc_atomic_uninit16
• silc_atomic_uninit8
• silc_atomic_uninit_pointer
• silc_atomic_set_int32
• silc_atomic_set_int16
• silc_atomic_set_int8
• silc_atomic_set_pointer
• silc_atomic_get_int32
• silc_atomic_get_int16
• silc_atomic_get_int8
• silc_atomic_get_pointer
• silc_atomic_add_int32
• silc_atomic_add_int16
• silc_atomic_add_int8
• silc_atomic_sub_int32
• silc_atomic_sub_int16
• silc_atomic_sub_int8
• silc_atomic_inc32
• silc_atomic_inc16
• silc_atomic_inc8
• silc_atomic_dec32
• silc_atomic_dec16
• silc_atomic_dec8
• silc_atomic_cas32
• silc_atomic_cas16
• silc_atomic_cas8
• silc_atomic_cas_pointer