fixing stuff
[dyninst.git] / dynutil / h / dyn_detail / boost / detail / atomic_count.hpp
1 #ifndef DYN_DETAIL_BOOST_DETAIL_ATOMIC_COUNT_HPP_INCLUDED
2 #define DYN_DETAIL_BOOST_DETAIL_ATOMIC_COUNT_HPP_INCLUDED
3
4 // MS compatible compilers support #pragma once
5
6 #if defined(_MSC_VER) && (_MSC_VER >= 1020)
7 # pragma once
8 #endif
9
10 //
11 //  boost/detail/atomic_count.hpp - thread/SMP safe reference counter
12 //
13 //  Copyright (c) 2001, 2002 Peter Dimov and Multi Media Ltd.
14 //
15 // Distributed under the Boost Software License, Version 1.0. (See
16 // accompanying file LICENSE_1_0.txt or copy at
17 // http://www.boost.org/LICENSE_1_0.txt)
18 //
19 //  typedef <implementation-defined> boost::detail::atomic_count;
20 //
21 //  atomic_count a(n);
22 //
23 //    (n is convertible to long)
24 //
25 //    Effects: Constructs an atomic_count with an initial value of n
26 //
27 //  a;
28 //
29 //    Returns: (long) the current value of a
30 //
31 //  ++a;
32 //
33 //    Effects: Atomically increments the value of a
34 //    Returns: nothing
35 //
36 //  --a;
37 //
38 //    Effects: Atomically decrements the value of a
39 //    Returns: (long) zero if the new value of a is zero,
40 //      unspecified non-zero value otherwise (usually the new value)
41 //
42 //    Important note: when --a returns zero, it must act as a
43 //      read memory barrier (RMB); i.e. the calling thread must
44 //      have a synchronized view of the memory
45 //
46 //    On Intel IA-32 (x86) memory is always synchronized, so this
47 //      is not a problem.
48 //
49 //    On many architectures the atomic instructions already act as
50 //      a memory barrier.
51 //
52 //    This property is necessary for proper reference counting, since
53 //      a thread can update the contents of a shared object, then
54 //      release its reference, and another thread may immediately
55 //      release the last reference causing object destruction.
56 //
57 //    The destructor needs to have a synchronized view of the
58 //      object to perform proper cleanup.
59 //
60 //    Original example by Alexander Terekhov:
61 //
62 //    Given:
63 //
64 //    - a mutable shared object OBJ;
65 //    - two threads THREAD1 and THREAD2 each holding 
66 //      a private smart_ptr object pointing to that OBJ.
67 //
68 //    t1: THREAD1 updates OBJ (thread-safe via some synchronization)
69 //      and a few cycles later (after "unlock") destroys smart_ptr;
70 //
71 //    t2: THREAD2 destroys smart_ptr WITHOUT doing any synchronization 
72 //      with respect to shared mutable object OBJ; OBJ destructors
73 //      are called driven by smart_ptr interface...
74 //
75
76 #include <dyn_detail/boost/config.hpp>
77
78 #ifndef DYN_DETAIL_BOOST_HAS_THREADS
79 namespace dyn_detail
80 {
81   
82 namespace boost
83 {
84
85 namespace detail
86 {
87
88 typedef long atomic_count;
89
90 }
91
92 }
93
94 }
95 #elif defined(DYN_DETAIL_BOOST_AC_USE_PTHREADS)
96 #include <dyn_detail/boost/detail/atomic_count_pthreads.hpp>
97
98 #elif defined( __GNUC__ ) && ( defined( __i386__ ) || defined( __x86_64__ ) )
99 #include <dyn_detail/boost/detail/atomic_count_gcc_x86.hpp>
100
101 #elif defined(WIN32) || defined(_WIN32) || defined(__WIN32__)
102 #include <dyn_detail/boost/detail/atomic_count_win32.hpp>
103
104 #elif defined( __GNUC__ ) && ( __GNUC__ * 100 + __GNUC_MINOR__ >= 401 ) && !defined( __arm__ ) && !defined( __hppa ) && ( !defined( __INTEL_COMPILER ) || defined( __ia64__ ) )
105 #include <dyn_detail/boost/detail/atomic_count_sync.hpp>
106
107 #elif defined(__GLIBCPP__) || defined(__GLIBCXX__)
108 #include <dyn_detail/boost/detail/atomic_count_gcc.hpp>
109
110 #elif defined(DYN_DETAIL_BOOST_HAS_PTHREADS)
111
112 #  define DYN_DETAIL_BOOST_AC_USE_PTHREADS
113 #include <dyn_detail/boost/detail/atomic_count_pthreads.hpp>
114
115 #else
116
117 // Use #define DYN_DETAIL_BOOST_DISABLE_THREADS to avoid the error
118 #error Unrecognized threading platform
119
120 #endif
121
122 #endif // #ifndef DYN_DETAIL_BOOST_DETAIL_ATOMIC_COUNT_HPP_INCLUDED