Home | History | Annotate | Download | only in include
      1 // -*- C++ -*-
      2 //===--------------------------- mutex ------------------------------------===//
      3 //
      4 //                     The LLVM Compiler Infrastructure
      5 //
      6 // This file is dual licensed under the MIT and the University of Illinois Open
      7 // Source Licenses. See LICENSE.TXT for details.
      8 //
      9 //===----------------------------------------------------------------------===//
     10 
     11 #ifndef _LIBCPP_MUTEX
     12 #define _LIBCPP_MUTEX
     13 
     14 /*
     15     mutex synopsis
     16 
     17 namespace std
     18 {
     19 
     20 class mutex
     21 {
     22 public:
     23      constexpr mutex() noexcept;
     24      ~mutex();
     25 
     26     mutex(const mutex&) = delete;
     27     mutex& operator=(const mutex&) = delete;
     28 
     29     void lock();
     30     bool try_lock();
     31     void unlock();
     32 
     33     typedef pthread_mutex_t* native_handle_type;
     34     native_handle_type native_handle();
     35 };
     36 
     37 class recursive_mutex
     38 {
     39 public:
     40      recursive_mutex();
     41      ~recursive_mutex();
     42 
     43     recursive_mutex(const recursive_mutex&) = delete;
     44     recursive_mutex& operator=(const recursive_mutex&) = delete;
     45 
     46     void lock();
     47     bool try_lock() noexcept;
     48     void unlock();
     49 
     50     typedef pthread_mutex_t* native_handle_type;
     51     native_handle_type native_handle();
     52 };
     53 
     54 class timed_mutex
     55 {
     56 public:
     57      timed_mutex();
     58      ~timed_mutex();
     59 
     60     timed_mutex(const timed_mutex&) = delete;
     61     timed_mutex& operator=(const timed_mutex&) = delete;
     62 
     63     void lock();
     64     bool try_lock();
     65     template <class Rep, class Period>
     66         bool try_lock_for(const chrono::duration<Rep, Period>& rel_time);
     67     template <class Clock, class Duration>
     68         bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
     69     void unlock();
     70 };
     71 
     72 class recursive_timed_mutex
     73 {
     74 public:
     75      recursive_timed_mutex();
     76      ~recursive_timed_mutex();
     77 
     78     recursive_timed_mutex(const recursive_timed_mutex&) = delete;
     79     recursive_timed_mutex& operator=(const recursive_timed_mutex&) = delete;
     80 
     81     void lock();
     82     bool try_lock() noexcept;
     83     template <class Rep, class Period>
     84         bool try_lock_for(const chrono::duration<Rep, Period>& rel_time);
     85     template <class Clock, class Duration>
     86         bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
     87     void unlock();
     88 };
     89 
     90 struct defer_lock_t {};
     91 struct try_to_lock_t {};
     92 struct adopt_lock_t {};
     93 
     94 inline constexpr defer_lock_t  defer_lock{};
     95 inline constexpr try_to_lock_t try_to_lock{};
     96 inline constexpr adopt_lock_t  adopt_lock{};
     97 
     98 template <class Mutex>
     99 class lock_guard
    100 {
    101 public:
    102     typedef Mutex mutex_type;
    103 
    104     explicit lock_guard(mutex_type& m);
    105     lock_guard(mutex_type& m, adopt_lock_t);
    106     ~lock_guard();
    107 
    108     lock_guard(lock_guard const&) = delete;
    109     lock_guard& operator=(lock_guard const&) = delete;
    110 };
    111 
    112 template <class... MutexTypes>
    113 class scoped_lock // C++17
    114 {
    115 public:
    116     using mutex_type = Mutex;  // If MutexTypes... consists of the single type Mutex
    117 
    118     explicit scoped_lock(MutexTypes&... m);
    119     scoped_lock(adopt_lock_t, MutexTypes&... m);
    120     ~scoped_lock();
    121     scoped_lock(scoped_lock const&) = delete;
    122     scoped_lock& operator=(scoped_lock const&) = delete;
    123 private:
    124     tuple<MutexTypes&...> pm; // exposition only
    125 };
    126 
    127 template <class Mutex>
    128 class unique_lock
    129 {
    130 public:
    131     typedef Mutex mutex_type;
    132     unique_lock() noexcept;
    133     explicit unique_lock(mutex_type& m);
    134     unique_lock(mutex_type& m, defer_lock_t) noexcept;
    135     unique_lock(mutex_type& m, try_to_lock_t);
    136     unique_lock(mutex_type& m, adopt_lock_t);
    137     template <class Clock, class Duration>
    138         unique_lock(mutex_type& m, const chrono::time_point<Clock, Duration>& abs_time);
    139     template <class Rep, class Period>
    140         unique_lock(mutex_type& m, const chrono::duration<Rep, Period>& rel_time);
    141     ~unique_lock();
    142 
    143     unique_lock(unique_lock const&) = delete;
    144     unique_lock& operator=(unique_lock const&) = delete;
    145 
    146     unique_lock(unique_lock&& u) noexcept;
    147     unique_lock& operator=(unique_lock&& u) noexcept;
    148 
    149     void lock();
    150     bool try_lock();
    151 
    152     template <class Rep, class Period>
    153         bool try_lock_for(const chrono::duration<Rep, Period>& rel_time);
    154     template <class Clock, class Duration>
    155         bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
    156 
    157     void unlock();
    158 
    159     void swap(unique_lock& u) noexcept;
    160     mutex_type* release() noexcept;
    161 
    162     bool owns_lock() const noexcept;
    163     explicit operator bool () const noexcept;
    164     mutex_type* mutex() const noexcept;
    165 };
    166 
    167 template <class Mutex>
    168   void swap(unique_lock<Mutex>& x, unique_lock<Mutex>& y) noexcept;
    169 
    170 template <class L1, class L2, class... L3>
    171   int try_lock(L1&, L2&, L3&...);
    172 template <class L1, class L2, class... L3>
    173   void lock(L1&, L2&, L3&...);
    174 
    175 struct once_flag
    176 {
    177     constexpr once_flag() noexcept;
    178 
    179     once_flag(const once_flag&) = delete;
    180     once_flag& operator=(const once_flag&) = delete;
    181 };
    182 
    183 template<class Callable, class ...Args>
    184   void call_once(once_flag& flag, Callable&& func, Args&&... args);
    185 
    186 }  // std
    187 
    188 */
    189 
    190 #include <__config>
    191 #include <__mutex_base>
    192 #include <functional>
    193 #include <memory>
    194 #ifndef _LIBCPP_CXX03_LANG
    195 #include <tuple>
    196 #endif
    197 #include <__threading_support>
    198 
    199 #if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
    200 #pragma GCC system_header
    201 #endif
    202 
    203 _LIBCPP_PUSH_MACROS
    204 #include <__undef_macros>
    205 
    206 
    207 _LIBCPP_BEGIN_NAMESPACE_STD
    208 
    209 #ifndef _LIBCPP_HAS_NO_THREADS
    210 
    211 class _LIBCPP_TYPE_VIS recursive_mutex
    212 {
    213     __libcpp_recursive_mutex_t __m_;
    214 
    215 public:
    216      recursive_mutex();
    217      ~recursive_mutex();
    218 
    219 private:
    220     recursive_mutex(const recursive_mutex&); // = delete;
    221     recursive_mutex& operator=(const recursive_mutex&); // = delete;
    222 
    223 public:
    224     void lock();
    225     bool try_lock() _NOEXCEPT;
    226     void unlock()  _NOEXCEPT;
    227 
    228     typedef __libcpp_recursive_mutex_t* native_handle_type;
    229 
    230     _LIBCPP_INLINE_VISIBILITY
    231     native_handle_type native_handle() {return &__m_;}
    232 };
    233 
    234 class _LIBCPP_TYPE_VIS timed_mutex
    235 {
    236     mutex              __m_;
    237     condition_variable __cv_;
    238     bool               __locked_;
    239 public:
    240      timed_mutex();
    241      ~timed_mutex();
    242 
    243 private:
    244     timed_mutex(const timed_mutex&); // = delete;
    245     timed_mutex& operator=(const timed_mutex&); // = delete;
    246 
    247 public:
    248     void lock();
    249     bool try_lock() _NOEXCEPT;
    250     template <class _Rep, class _Period>
    251         _LIBCPP_INLINE_VISIBILITY
    252         bool try_lock_for(const chrono::duration<_Rep, _Period>& __d)
    253             {return try_lock_until(chrono::steady_clock::now() + __d);}
    254     template <class _Clock, class _Duration>
    255         _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
    256         bool try_lock_until(const chrono::time_point<_Clock, _Duration>& __t);
    257     void unlock() _NOEXCEPT;
    258 };
    259 
    260 template <class _Clock, class _Duration>
    261 bool
    262 timed_mutex::try_lock_until(const chrono::time_point<_Clock, _Duration>& __t)
    263 {
    264     using namespace chrono;
    265     unique_lock<mutex> __lk(__m_);
    266     bool no_timeout = _Clock::now() < __t;
    267     while (no_timeout && __locked_)
    268         no_timeout = __cv_.wait_until(__lk, __t) == cv_status::no_timeout;
    269     if (!__locked_)
    270     {
    271         __locked_ = true;
    272         return true;
    273     }
    274     return false;
    275 }
    276 
    277 class _LIBCPP_TYPE_VIS recursive_timed_mutex
    278 {
    279     mutex              __m_;
    280     condition_variable __cv_;
    281     size_t             __count_;
    282     __libcpp_thread_id __id_;
    283 public:
    284      recursive_timed_mutex();
    285      ~recursive_timed_mutex();
    286 
    287 private:
    288     recursive_timed_mutex(const recursive_timed_mutex&); // = delete;
    289     recursive_timed_mutex& operator=(const recursive_timed_mutex&); // = delete;
    290 
    291 public:
    292     void lock();
    293     bool try_lock() _NOEXCEPT;
    294     template <class _Rep, class _Period>
    295         _LIBCPP_INLINE_VISIBILITY
    296         bool try_lock_for(const chrono::duration<_Rep, _Period>& __d)
    297             {return try_lock_until(chrono::steady_clock::now() + __d);}
    298     template <class _Clock, class _Duration>
    299         _LIBCPP_METHOD_TEMPLATE_IMPLICIT_INSTANTIATION_VIS
    300         bool try_lock_until(const chrono::time_point<_Clock, _Duration>& __t);
    301     void unlock() _NOEXCEPT;
    302 };
    303 
    304 template <class _Clock, class _Duration>
    305 bool
    306 recursive_timed_mutex::try_lock_until(const chrono::time_point<_Clock, _Duration>& __t)
    307 {
    308     using namespace chrono;
    309     __libcpp_thread_id __id = __libcpp_thread_get_current_id();
    310     unique_lock<mutex> lk(__m_);
    311     if (__libcpp_thread_id_equal(__id, __id_))
    312     {
    313         if (__count_ == numeric_limits<size_t>::max())
    314             return false;
    315         ++__count_;
    316         return true;
    317     }
    318     bool no_timeout = _Clock::now() < __t;
    319     while (no_timeout && __count_ != 0)
    320         no_timeout = __cv_.wait_until(lk, __t) == cv_status::no_timeout;
    321     if (__count_ == 0)
    322     {
    323         __count_ = 1;
    324         __id_ = __id;
    325         return true;
    326     }
    327     return false;
    328 }
    329 
    330 template <class _L0, class _L1>
    331 int
    332 try_lock(_L0& __l0, _L1& __l1)
    333 {
    334     unique_lock<_L0> __u0(__l0, try_to_lock);
    335     if (__u0.owns_lock())
    336     {
    337         if (__l1.try_lock())
    338         {
    339             __u0.release();
    340             return -1;
    341         }
    342         else
    343             return 1;
    344     }
    345     return 0;
    346 }
    347 
    348 #ifndef _LIBCPP_CXX03_LANG
    349 
    350 template <class _L0, class _L1, class _L2, class... _L3>
    351 int
    352 try_lock(_L0& __l0, _L1& __l1, _L2& __l2, _L3&... __l3)
    353 {
    354     int __r = 0;
    355     unique_lock<_L0> __u0(__l0, try_to_lock);
    356     if (__u0.owns_lock())
    357     {
    358         __r = try_lock(__l1, __l2, __l3...);
    359         if (__r == -1)
    360             __u0.release();
    361         else
    362             ++__r;
    363     }
    364     return __r;
    365 }
    366 
    367 #endif  // _LIBCPP_CXX03_LANG
    368 
    369 template <class _L0, class _L1>
    370 void
    371 lock(_L0& __l0, _L1& __l1)
    372 {
    373     while (true)
    374     {
    375         {
    376             unique_lock<_L0> __u0(__l0);
    377             if (__l1.try_lock())
    378             {
    379                 __u0.release();
    380                 break;
    381             }
    382         }
    383         __libcpp_thread_yield();
    384         {
    385             unique_lock<_L1> __u1(__l1);
    386             if (__l0.try_lock())
    387             {
    388                 __u1.release();
    389                 break;
    390             }
    391         }
    392         __libcpp_thread_yield();
    393     }
    394 }
    395 
    396 #ifndef _LIBCPP_CXX03_LANG
    397 
    398 template <class _L0, class _L1, class _L2, class ..._L3>
    399 void
    400 __lock_first(int __i, _L0& __l0, _L1& __l1, _L2& __l2, _L3& ...__l3)
    401 {
    402     while (true)
    403     {
    404         switch (__i)
    405         {
    406         case 0:
    407             {
    408                 unique_lock<_L0> __u0(__l0);
    409                 __i = try_lock(__l1, __l2, __l3...);
    410                 if (__i == -1)
    411                 {
    412                     __u0.release();
    413                     return;
    414                 }
    415             }
    416             ++__i;
    417             __libcpp_thread_yield();
    418             break;
    419         case 1:
    420             {
    421                 unique_lock<_L1> __u1(__l1);
    422                 __i = try_lock(__l2, __l3..., __l0);
    423                 if (__i == -1)
    424                 {
    425                     __u1.release();
    426                     return;
    427                 }
    428             }
    429             if (__i == sizeof...(_L3) + 1)
    430                 __i = 0;
    431             else
    432                 __i += 2;
    433             __libcpp_thread_yield();
    434             break;
    435         default:
    436             __lock_first(__i - 2, __l2, __l3..., __l0, __l1);
    437             return;
    438         }
    439     }
    440 }
    441 
    442 template <class _L0, class _L1, class _L2, class ..._L3>
    443 inline _LIBCPP_INLINE_VISIBILITY
    444 void
    445 lock(_L0& __l0, _L1& __l1, _L2& __l2, _L3& ...__l3)
    446 {
    447     __lock_first(0, __l0, __l1, __l2, __l3...);
    448 }
    449 
    450 template <class _L0>
    451 inline _LIBCPP_INLINE_VISIBILITY
    452 void __unlock(_L0& __l0) {
    453     __l0.unlock();
    454 }
    455 
    456 template <class _L0, class _L1>
    457 inline _LIBCPP_INLINE_VISIBILITY
    458 void __unlock(_L0& __l0, _L1& __l1) {
    459     __l0.unlock();
    460     __l1.unlock();
    461 }
    462 
    463 template <class _L0, class _L1, class _L2, class ..._L3>
    464 inline _LIBCPP_INLINE_VISIBILITY
    465 void __unlock(_L0& __l0, _L1& __l1, _L2& __l2, _L3&... __l3) {
    466     __l0.unlock();
    467     __l1.unlock();
    468     _VSTD::__unlock(__l2, __l3...);
    469 }
    470 
    471 #endif  // _LIBCPP_CXX03_LANG
    472 
    473 #if _LIBCPP_STD_VER > 14
    474 template <class ..._Mutexes>
    475 class _LIBCPP_TEMPLATE_VIS scoped_lock;
    476 
    477 template <>
    478 class _LIBCPP_TEMPLATE_VIS scoped_lock<> {
    479 public:
    480     explicit scoped_lock() {}
    481     ~scoped_lock() = default;
    482 
    483     _LIBCPP_INLINE_VISIBILITY
    484     explicit scoped_lock(adopt_lock_t) {}
    485 
    486     scoped_lock(scoped_lock const&) = delete;
    487     scoped_lock& operator=(scoped_lock const&) = delete;
    488 };
    489 
    490 template <class _Mutex>
    491 class _LIBCPP_TEMPLATE_VIS scoped_lock<_Mutex> {
    492 public:
    493     typedef _Mutex  mutex_type;
    494 private:
    495     mutex_type& __m_;
    496 public:
    497     explicit scoped_lock(mutex_type & __m) _LIBCPP_THREAD_SAFETY_ANNOTATION(acquire_capability(__m))
    498         : __m_(__m) {__m_.lock();}
    499 
    500     ~scoped_lock() _LIBCPP_THREAD_SAFETY_ANNOTATION(release_capability()) {__m_.unlock();}
    501 
    502     _LIBCPP_INLINE_VISIBILITY
    503     explicit scoped_lock(adopt_lock_t, mutex_type& __m) _LIBCPP_THREAD_SAFETY_ANNOTATION(requires_capability(__m))
    504         : __m_(__m) {}
    505 
    506     scoped_lock(scoped_lock const&) = delete;
    507     scoped_lock& operator=(scoped_lock const&) = delete;
    508 };
    509 
    510 template <class ..._MArgs>
    511 class _LIBCPP_TEMPLATE_VIS scoped_lock
    512 {
    513     static_assert(sizeof...(_MArgs) > 1, "At least 2 lock types required");
    514     typedef tuple<_MArgs&...> _MutexTuple;
    515 
    516 public:
    517     _LIBCPP_INLINE_VISIBILITY
    518     explicit scoped_lock(_MArgs&... __margs)
    519       : __t_(__margs...)
    520     {
    521         _VSTD::lock(__margs...);
    522     }
    523 
    524     _LIBCPP_INLINE_VISIBILITY
    525     scoped_lock(adopt_lock_t, _MArgs&... __margs)
    526         : __t_(__margs...)
    527     {
    528     }
    529 
    530     _LIBCPP_INLINE_VISIBILITY
    531     ~scoped_lock() {
    532         typedef typename __make_tuple_indices<sizeof...(_MArgs)>::type _Indices;
    533         __unlock_unpack(_Indices{}, __t_);
    534     }
    535 
    536     scoped_lock(scoped_lock const&) = delete;
    537     scoped_lock& operator=(scoped_lock const&) = delete;
    538 
    539 private:
    540     template <size_t ..._Indx>
    541     _LIBCPP_INLINE_VISIBILITY
    542     static void __unlock_unpack(__tuple_indices<_Indx...>, _MutexTuple& __mt) {
    543         _VSTD::__unlock(_VSTD::get<_Indx>(__mt)...);
    544     }
    545 
    546     _MutexTuple __t_;
    547 };
    548 
    549 #endif // _LIBCPP_STD_VER > 14
    550 #endif // !_LIBCPP_HAS_NO_THREADS
    551 
    552 struct _LIBCPP_TEMPLATE_VIS once_flag;
    553 
    554 #ifndef _LIBCPP_CXX03_LANG
    555 
    556 template<class _Callable, class... _Args>
    557 _LIBCPP_INLINE_VISIBILITY
    558 void call_once(once_flag&, _Callable&&, _Args&&...);
    559 
    560 #else  // _LIBCPP_CXX03_LANG
    561 
    562 template<class _Callable>
    563 _LIBCPP_INLINE_VISIBILITY
    564 void call_once(once_flag&, _Callable&);
    565 
    566 template<class _Callable>
    567 _LIBCPP_INLINE_VISIBILITY
    568 void call_once(once_flag&, const _Callable&);
    569 
    570 #endif  // _LIBCPP_CXX03_LANG
    571 
    572 struct _LIBCPP_TEMPLATE_VIS once_flag
    573 {
    574     _LIBCPP_INLINE_VISIBILITY
    575     _LIBCPP_CONSTEXPR
    576         once_flag() _NOEXCEPT : __state_(0) {}
    577 
    578 private:
    579     once_flag(const once_flag&); // = delete;
    580     once_flag& operator=(const once_flag&); // = delete;
    581 
    582     unsigned long __state_;
    583 
    584 #ifndef _LIBCPP_CXX03_LANG
    585     template<class _Callable, class... _Args>
    586     friend
    587     void call_once(once_flag&, _Callable&&, _Args&&...);
    588 #else  // _LIBCPP_CXX03_LANG
    589     template<class _Callable>
    590     friend
    591     void call_once(once_flag&, _Callable&);
    592 
    593     template<class _Callable>
    594     friend
    595     void call_once(once_flag&, const _Callable&);
    596 #endif  // _LIBCPP_CXX03_LANG
    597 };
    598 
    599 #ifndef _LIBCPP_CXX03_LANG
    600 
    601 template <class _Fp>
    602 class __call_once_param
    603 {
    604     _Fp& __f_;
    605 public:
    606     _LIBCPP_INLINE_VISIBILITY
    607     explicit __call_once_param(_Fp& __f) : __f_(__f) {}
    608 
    609     _LIBCPP_INLINE_VISIBILITY
    610     void operator()()
    611     {
    612         typedef typename __make_tuple_indices<tuple_size<_Fp>::value, 1>::type _Index;
    613         __execute(_Index());
    614     }
    615 
    616 private:
    617     template <size_t ..._Indices>
    618     _LIBCPP_INLINE_VISIBILITY
    619     void __execute(__tuple_indices<_Indices...>)
    620     {
    621         __invoke(_VSTD::get<0>(_VSTD::move(__f_)), _VSTD::get<_Indices>(_VSTD::move(__f_))...);
    622     }
    623 };
    624 
    625 #else
    626 
    627 template <class _Fp>
    628 class __call_once_param
    629 {
    630     _Fp& __f_;
    631 public:
    632     _LIBCPP_INLINE_VISIBILITY
    633     explicit __call_once_param(_Fp& __f) : __f_(__f) {}
    634 
    635     _LIBCPP_INLINE_VISIBILITY
    636     void operator()()
    637     {
    638         __f_();
    639     }
    640 };
    641 
    642 #endif
    643 
    644 template <class _Fp>
    645 void
    646 __call_once_proxy(void* __vp)
    647 {
    648     __call_once_param<_Fp>* __p = static_cast<__call_once_param<_Fp>*>(__vp);
    649     (*__p)();
    650 }
    651 
    652 _LIBCPP_FUNC_VIS void __call_once(volatile unsigned long&, void*, void(*)(void*));
    653 
    654 #ifndef _LIBCPP_CXX03_LANG
    655 
    656 template<class _Callable, class... _Args>
    657 inline _LIBCPP_INLINE_VISIBILITY
    658 void
    659 call_once(once_flag& __flag, _Callable&& __func, _Args&&... __args)
    660 {
    661     if (__libcpp_acquire_load(&__flag.__state_) != ~0ul)
    662     {
    663         typedef tuple<_Callable&&, _Args&&...> _Gp;
    664         _Gp __f(_VSTD::forward<_Callable>(__func), _VSTD::forward<_Args>(__args)...);
    665         __call_once_param<_Gp> __p(__f);
    666         __call_once(__flag.__state_, &__p, &__call_once_proxy<_Gp>);
    667     }
    668 }
    669 
    670 #else  // _LIBCPP_CXX03_LANG
    671 
    672 template<class _Callable>
    673 inline _LIBCPP_INLINE_VISIBILITY
    674 void
    675 call_once(once_flag& __flag, _Callable& __func)
    676 {
    677     if (__libcpp_acquire_load(&__flag.__state_) != ~0ul)
    678     {
    679         __call_once_param<_Callable> __p(__func);
    680         __call_once(__flag.__state_, &__p, &__call_once_proxy<_Callable>);
    681     }
    682 }
    683 
    684 template<class _Callable>
    685 inline _LIBCPP_INLINE_VISIBILITY
    686 void
    687 call_once(once_flag& __flag, const _Callable& __func)
    688 {
    689     if (__libcpp_acquire_load(&__flag.__state_) != ~0ul)
    690     {
    691         __call_once_param<const _Callable> __p(__func);
    692         __call_once(__flag.__state_, &__p, &__call_once_proxy<const _Callable>);
    693     }
    694 }
    695 
    696 #endif  // _LIBCPP_CXX03_LANG
    697 
    698 _LIBCPP_END_NAMESPACE_STD
    699 
    700 _LIBCPP_POP_MACROS
    701 
    702 #endif  // _LIBCPP_MUTEX
    703