blob: 753d50f512667fa8d43e5fdb4504add0d9fb27f5 [file] [log] [blame]
Olivier Giroux161e6e82020-02-18 09:58:34 -05001// -*- C++ -*-
Louis Dionne9bd93882021-11-17 16:25:01 -05002//===----------------------------------------------------------------------===//
Olivier Giroux161e6e82020-02-18 09:58:34 -05003//
4// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
5// See https://llvm.org/LICENSE.txt for license information.
6// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7//
8//===----------------------------------------------------------------------===//
9
10#ifndef _LIBCPP_SEMAPHORE
11#define _LIBCPP_SEMAPHORE
12
13/*
14 semaphore synopsis
15
16namespace std {
17
18template<ptrdiff_t least_max_value = implementation-defined>
19class counting_semaphore
20{
21public:
22static constexpr ptrdiff_t max() noexcept;
23
24constexpr explicit counting_semaphore(ptrdiff_t desired);
25~counting_semaphore();
26
27counting_semaphore(const counting_semaphore&) = delete;
28counting_semaphore& operator=(const counting_semaphore&) = delete;
29
30void release(ptrdiff_t update = 1);
31void acquire();
32bool try_acquire() noexcept;
33template<class Rep, class Period>
34 bool try_acquire_for(const chrono::duration<Rep, Period>& rel_time);
35template<class Clock, class Duration>
36 bool try_acquire_until(const chrono::time_point<Clock, Duration>& abs_time);
37
38private:
39ptrdiff_t counter; // exposition only
40};
41
42using binary_semaphore = counting_semaphore<1>;
43
44}
45
46*/
47
Louis Dionne73912b22020-11-04 15:01:25 -050048#include <__availability>
Arthur O'Dwyeref181602021-05-19 11:57:04 -040049#include <__config>
Louis Dionnecaf26832022-01-10 09:43:29 -050050#include <__thread/timed_backoff_policy.h>
Olivier Giroux161e6e82020-02-18 09:58:34 -050051#include <__threading_support>
52#include <atomic>
Mark de Weverce8f12c2021-12-22 18:14:14 +010053#include <version>
Olivier Giroux161e6e82020-02-18 09:58:34 -050054
55#if !defined(_LIBCPP_HAS_NO_PRAGMA_SYSTEM_HEADER)
Arthur O'Dwyer6eeaa002022-02-01 20:16:40 -050056# pragma GCC system_header
Olivier Giroux161e6e82020-02-18 09:58:34 -050057#endif
58
59#ifdef _LIBCPP_HAS_NO_THREADS
60# error <semaphore> is not supported on this single threaded system
61#endif
62
Arthur O'Dwyer2422fa22020-12-02 18:55:01 -050063_LIBCPP_PUSH_MACROS
64#include <__undef_macros>
65
Louis Dionne1ab95312020-02-24 18:12:44 -050066#if _LIBCPP_STD_VER >= 14
Olivier Giroux161e6e82020-02-18 09:58:34 -050067
68_LIBCPP_BEGIN_NAMESPACE_STD
69
70/*
71
Arthur O'Dwyer7a35d632021-09-20 18:03:49 -040072__atomic_semaphore_base is the general-case implementation.
Arthur O'Dwyerdf5df562020-12-12 11:57:32 -050073It is a typical Dijkstra semaphore algorithm over atomics, wait and notify
Olivier Giroux161e6e82020-02-18 09:58:34 -050074functions. It avoids contention against users' own use of those facilities.
75
76*/
77
78class __atomic_semaphore_base
79{
80 __atomic_base<ptrdiff_t> __a;
81
82public:
83 _LIBCPP_INLINE_VISIBILITY
Arthur O'Dwyer227e00b2021-09-16 23:14:57 -040084 constexpr explicit __atomic_semaphore_base(ptrdiff_t __count) : __a(__count)
Olivier Giroux161e6e82020-02-18 09:58:34 -050085 {
86 }
Louis Dionne3dde4ab2020-02-24 10:09:29 -050087 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -050088 void release(ptrdiff_t __update = 1)
89 {
90 if(0 < __a.fetch_add(__update, memory_order_release))
91 ;
92 else if(__update > 1)
93 __a.notify_all();
94 else
95 __a.notify_one();
96 }
Louis Dionne3dde4ab2020-02-24 10:09:29 -050097 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -050098 void acquire()
99 {
Louis Dionneaf6be622021-07-27 17:30:47 -0400100 auto const __test_fn = [this]() -> bool {
Olivier Giroux161e6e82020-02-18 09:58:34 -0500101 auto __old = __a.load(memory_order_relaxed);
102 return (__old != 0) && __a.compare_exchange_strong(__old, __old - 1, memory_order_acquire, memory_order_relaxed);
103 };
104 __cxx_atomic_wait(&__a.__a_, __test_fn);
105 }
106 template <class Rep, class Period>
Louis Dionne3dde4ab2020-02-24 10:09:29 -0500107 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -0500108 bool try_acquire_for(chrono::duration<Rep, Period> const& __rel_time)
109 {
Arthur O'Dwyera95b8402021-11-04 17:58:33 -0400110 if (__rel_time == chrono::duration<Rep, Period>::zero())
111 return try_acquire();
112 auto const __test_fn = [this]() { return try_acquire(); };
Olivier Giroux161e6e82020-02-18 09:58:34 -0500113 return __libcpp_thread_poll_with_backoff(__test_fn, __libcpp_timed_backoff_policy(), __rel_time);
114 }
Arthur O'Dwyera95b8402021-11-04 17:58:33 -0400115 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
116 bool try_acquire()
117 {
118 auto __old = __a.load(memory_order_acquire);
119 while (true) {
120 if (__old == 0)
121 return false;
122 if (__a.compare_exchange_strong(__old, __old - 1, memory_order_acquire, memory_order_relaxed))
123 return true;
124 }
125 }
Olivier Giroux161e6e82020-02-18 09:58:34 -0500126};
127
ogiroux945d52b2020-02-26 16:49:37 -0800128#define _LIBCPP_SEMAPHORE_MAX (numeric_limits<ptrdiff_t>::max())
129
Olivier Giroux161e6e82020-02-18 09:58:34 -0500130template<ptrdiff_t __least_max_value = _LIBCPP_SEMAPHORE_MAX>
131class counting_semaphore
132{
Arthur O'Dwyer7a35d632021-09-20 18:03:49 -0400133 __atomic_semaphore_base __semaphore;
Olivier Giroux161e6e82020-02-18 09:58:34 -0500134
135public:
136 static constexpr ptrdiff_t max() noexcept {
137 return __least_max_value;
138 }
139
140 _LIBCPP_INLINE_VISIBILITY
Arthur O'Dwyer227e00b2021-09-16 23:14:57 -0400141 constexpr explicit counting_semaphore(ptrdiff_t __count) : __semaphore(__count) { }
Olivier Giroux161e6e82020-02-18 09:58:34 -0500142 ~counting_semaphore() = default;
143
144 counting_semaphore(const counting_semaphore&) = delete;
145 counting_semaphore& operator=(const counting_semaphore&) = delete;
146
Louis Dionne3dde4ab2020-02-24 10:09:29 -0500147 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -0500148 void release(ptrdiff_t __update = 1)
149 {
150 __semaphore.release(__update);
151 }
Louis Dionne3dde4ab2020-02-24 10:09:29 -0500152 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -0500153 void acquire()
154 {
155 __semaphore.acquire();
156 }
157 template<class Rep, class Period>
Louis Dionne3dde4ab2020-02-24 10:09:29 -0500158 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -0500159 bool try_acquire_for(chrono::duration<Rep, Period> const& __rel_time)
160 {
161 return __semaphore.try_acquire_for(chrono::duration_cast<chrono::nanoseconds>(__rel_time));
162 }
Louis Dionne3dde4ab2020-02-24 10:09:29 -0500163 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -0500164 bool try_acquire()
165 {
Arthur O'Dwyera95b8402021-11-04 17:58:33 -0400166 return __semaphore.try_acquire();
Olivier Giroux161e6e82020-02-18 09:58:34 -0500167 }
168 template <class Clock, class Duration>
Louis Dionne3dde4ab2020-02-24 10:09:29 -0500169 _LIBCPP_AVAILABILITY_SYNC _LIBCPP_INLINE_VISIBILITY
Olivier Giroux161e6e82020-02-18 09:58:34 -0500170 bool try_acquire_until(chrono::time_point<Clock, Duration> const& __abs_time)
171 {
172 auto const current = Clock::now();
Arthur O'Dwyera95b8402021-11-04 17:58:33 -0400173 if (current >= __abs_time)
Olivier Giroux161e6e82020-02-18 09:58:34 -0500174 return try_acquire();
175 else
176 return try_acquire_for(__abs_time - current);
177 }
178};
179
180using binary_semaphore = counting_semaphore<1>;
181
182_LIBCPP_END_NAMESPACE_STD
183
Louis Dionne1ab95312020-02-24 18:12:44 -0500184#endif // _LIBCPP_STD_VER >= 14
185
Arthur O'Dwyer2422fa22020-12-02 18:55:01 -0500186_LIBCPP_POP_MACROS
187
Olivier Giroux161e6e82020-02-18 09:58:34 -0500188#endif //_LIBCPP_SEMAPHORE