ARGOBOTS  1.1
basic_wait.c
Go to the documentation of this file.
1 /* -*- Mode: C; c-basic-offset:4 ; indent-tabs-mode:nil ; -*- */
2 /*
3  * See COPYRIGHT in top-level directory.
4  */
5 
6 #include "abti.h"
7 
8 static int sched_init(ABT_sched sched, ABT_sched_config config);
9 static void sched_run(ABT_sched sched);
10 static int sched_free(ABT_sched);
11 static void sched_sort_pools(int num_pools, ABT_pool *pools);
12 
15  .init = sched_init,
16  .run = sched_run,
17  .free = sched_free,
18  .get_migr_pool = NULL,
19 };
20 
21 typedef struct {
22  uint32_t event_freq;
23  int num_pools;
24  ABT_pool *pools;
25 } sched_data;
26 
28 {
29  return &sched_basic_wait_def;
30 }
31 
32 static inline sched_data *sched_data_get_ptr(void *data)
33 {
34  return (sched_data *)data;
35 }
36 
37 static int sched_init(ABT_sched sched, ABT_sched_config config)
38 {
39  int abt_errno;
40  int num_pools;
41  ABTI_global *p_global = ABTI_global_get_global();
42 
43  ABTI_sched *p_sched = ABTI_sched_get_ptr(sched);
45  ABTI_sched_config *p_config = ABTI_sched_config_get_ptr(config);
46 
47  /* Default settings */
48  sched_data *p_data;
49  abt_errno = ABTU_malloc(sizeof(sched_data), (void **)&p_data);
50  ABTI_CHECK_ERROR(abt_errno);
51 
52  /* Set the default value by default. */
53  p_data->event_freq = p_global->sched_event_freq;
54  if (p_config) {
55  int event_freq;
56  /* Set the variables from config */
57  abt_errno = ABTI_sched_config_read(p_config, ABT_sched_basic_freq.idx,
58  &event_freq);
59  if (abt_errno == ABT_SUCCESS) {
60  p_data->event_freq = event_freq;
61  }
62  }
63 
64  /* Save the list of pools */
65  num_pools = p_sched->num_pools;
66  p_data->num_pools = num_pools;
67  abt_errno =
68  ABTU_malloc(num_pools * sizeof(ABT_pool), (void **)&p_data->pools);
69  if (ABTI_IS_ERROR_CHECK_ENABLED && abt_errno != ABT_SUCCESS) {
70  ABTU_free(p_data);
71  ABTI_CHECK_ERROR(abt_errno);
72  }
73  memcpy(p_data->pools, p_sched->pools, sizeof(ABT_pool) * num_pools);
74 
75  /* Sort pools according to their access mode so the scheduler can execute
76  work units from the private pools. */
77  if (num_pools > 1) {
78  sched_sort_pools(num_pools, p_data->pools);
79  }
80 
81  p_sched->data = p_data;
82  return ABT_SUCCESS;
83 }
84 
85 static void sched_run(ABT_sched sched)
86 {
87  ABTI_global *p_global = ABTI_global_get_global();
88  ABTI_xstream *p_local_xstream =
90  uint32_t work_count = 0;
91  sched_data *p_data;
92  uint32_t event_freq;
93  int num_pools;
94  ABT_pool *pools;
95  int i;
96  int run_cnt_nowait;
97 
98  ABTI_sched *p_sched = ABTI_sched_get_ptr(sched);
99  ABTI_ASSERT(p_sched);
100 
101  p_data = sched_data_get_ptr(p_sched->data);
102  event_freq = p_data->event_freq;
103  num_pools = p_data->num_pools;
104  pools = p_data->pools;
105 
106  while (1) {
107  run_cnt_nowait = 0;
108 
109  /* Execute one work unit from the scheduler's pool */
110  for (i = 0; i < num_pools; i++) {
111  ABT_pool pool = pools[i];
112  ABTI_pool *p_pool = ABTI_pool_get_ptr(pool);
113  /* Pop one work unit */
114  ABT_unit unit = ABTI_pool_pop(p_pool);
115  if (unit != ABT_UNIT_NULL) {
116  ABTI_thread *p_thread = ABTI_unit_get_thread(p_global, unit);
117  ABTI_xstream_run_thread(p_global, &p_local_xstream, p_thread);
118  run_cnt_nowait++;
119  break;
120  }
121  }
122 
123  /* Block briefly on pop_wait() if we didn't find work to do in main loop
124  * above. */
125  if (!run_cnt_nowait) {
126  ABTI_pool *p_pool = ABTI_pool_get_ptr(pools[0]);
127  ABT_unit unit;
128  if (p_pool->p_pop_wait) {
129  unit = ABTI_pool_pop_wait(p_pool, 0.1);
130  } else if (p_pool->p_pop_timedwait) {
131  unit = ABTI_pool_pop_timedwait(p_pool, ABTI_get_wtime() + 0.1);
132  } else {
133  /* No "wait" pop, so let's use a normal one. */
134  unit = ABTI_pool_pop(p_pool);
135  }
136  if (unit != ABT_UNIT_NULL) {
137  ABTI_thread *p_thread = ABTI_unit_get_thread(p_global, unit);
138  ABTI_xstream_run_thread(p_global, &p_local_xstream, p_thread);
139  break;
140  }
141  }
142 
143  /* If run_cnt_nowait is zero, that means that no units were found in
144  * first pass through pools and we must have called pop_wait above. We
145  * should check events regardless of work_count in that case for them to
146  * be processed in a timely manner. */
147  if (!run_cnt_nowait || (++work_count >= event_freq)) {
148  ABTI_xstream_check_events(p_local_xstream, p_sched);
149  ABTI_local *p_local = ABTI_xstream_get_local(p_local_xstream);
150  if (ABTI_sched_has_to_stop(&p_local, p_sched) == ABT_TRUE)
151  break;
152  p_local_xstream = ABTI_local_get_xstream(p_local);
153  work_count = 0;
154  }
155  }
156 }
157 
158 static int sched_free(ABT_sched sched)
159 {
160  ABTI_sched *p_sched = ABTI_sched_get_ptr(sched);
161  ABTI_ASSERT(p_sched);
162 
163  sched_data *p_data = sched_data_get_ptr(p_sched->data);
164  ABTU_free(p_data->pools);
165  ABTU_free(p_data);
166  return ABT_SUCCESS;
167 }
168 
169 static int pool_get_access_num(ABT_pool *p_pool)
170 {
171  ABT_pool_access access;
172  int num = 0;
173 
174  access = ABTI_pool_get_ptr(*p_pool)->access;
175  switch (access) {
177  num = 0;
178  break;
181  num = 1;
182  break;
185  num = 2;
186  break;
187  default:
188  ABTI_ASSERT(0);
190  }
191 
192  return num;
193 }
194 
195 static int sched_cmp_pools(const void *p1, const void *p2)
196 {
197  int p1_access, p2_access;
198 
199  p1_access = pool_get_access_num((ABT_pool *)p1);
200  p2_access = pool_get_access_num((ABT_pool *)p2);
201 
202  if (p1_access > p2_access) {
203  return 1;
204  } else if (p1_access < p2_access) {
205  return -1;
206  } else {
207  return 0;
208  }
209 }
210 
211 static void sched_sort_pools(int num_pools, ABT_pool *pools)
212 {
213  qsort(pools, num_pools, sizeof(ABT_pool), sched_cmp_pools);
214 }
ABTI_CHECK_NULL_SCHED_PTR
#define ABTI_CHECK_NULL_SCHED_PTR(p)
Definition: abti_error.h:177
ABTI_sched::data
void * data
Definition: abti.h:301
ABTI_sched_get_ptr
static ABTI_sched * ABTI_sched_get_ptr(ABT_sched sched)
Definition: abti_sched.h:11
sched_data::event_freq
uint32_t event_freq
Definition: basic.c:22
ABT_sched_def::type
ABT_sched_type type
Unused value.
Definition: abt.h:1309
ABTI_global_get_global
static ABTI_global * ABTI_global_get_global(void)
Definition: abti_global.h:9
sched_run
static void sched_run(ABT_sched sched)
Definition: basic_wait.c:85
sched_init
static int sched_init(ABT_sched sched, ABT_sched_config config)
Definition: basic_wait.c:37
ABTI_CHECK_ERROR
#define ABTI_CHECK_ERROR(abt_errno)
Definition: abti_error.h:120
data
Definition: fifo.c:29
ABTI_sched::num_pools
size_t num_pools
Definition: abti.h:299
sched_data
Definition: basic.c:21
ABT_POOL_ACCESS_MPMC
@ ABT_POOL_ACCESS_MPMC
Definition: abt.h:541
ABT_sched_config
struct ABT_sched_config_opaque * ABT_sched_config
Scheduler configuration handle type.
Definition: abt.h:815
sched_data_get_ptr
static sched_data * sched_data_get_ptr(void *data)
Definition: basic_wait.c:32
pool_get_access_num
static int pool_get_access_num(ABT_pool *p_pool)
Definition: basic_wait.c:169
sched_data::num_pools
int num_pools
Definition: basic.c:23
ABTI_thread
Definition: abti.h:371
ABTI_IS_ERROR_CHECK_ENABLED
#define ABTI_IS_ERROR_CHECK_ENABLED
Definition: abti.h:20
ABTI_xstream
Definition: abti.h:264
ABTI_sched_config
Definition: abti.h:323
ABT_pool
struct ABT_pool_opaque * ABT_pool
Pool handle type.
Definition: abt.h:841
ABTI_sched_has_to_stop
ABT_bool ABTI_sched_has_to_stop(ABTI_local **pp_local, ABTI_sched *p_sched)
Definition: sched.c:871
ABT_POOL_ACCESS_MPSC
@ ABT_POOL_ACCESS_MPSC
Definition: abt.h:535
ABT_POOL_ACCESS_PRIV
@ ABT_POOL_ACCESS_PRIV
Definition: abt.h:526
ABT_sched
struct ABT_sched_opaque * ABT_sched
Scheduler handle type.
Definition: abt.h:808
ABT_SCHED_TYPE_ULT
@ ABT_SCHED_TYPE_ULT
Definition: abt.h:492
ABTI_pool
Definition: abti.h:327
abti.h
ABTI_pool::p_pop_wait
ABT_pool_pop_wait_fn p_pop_wait
Definition: abti.h:347
sched_free
static int sched_free(ABT_sched)
Definition: basic_wait.c:158
sched_basic_wait_def
static ABT_sched_def sched_basic_wait_def
Definition: basic_wait.c:13
ABTU_malloc
static ABTU_ret_err int ABTU_malloc(size_t size, void **p_ptr)
Definition: abtu.h:262
ABTI_global::sched_event_freq
uint32_t sched_event_freq
Definition: abti.h:211
sched_data::pools
ABT_pool * pools
Definition: basic.c:24
ABTI_sched_config_read
ABTU_ret_err int ABTI_sched_config_read(const ABTI_sched_config *p_config, int idx, void *p_val)
Definition: config.c:259
ABT_unit
struct ABT_unit_opaque * ABT_unit
Work unit handle type for scheduling.
Definition: abt.h:869
ABTI_ASSERT
#define ABTI_ASSERT(cond)
Definition: abti_error.h:12
ABTI_sched::pools
ABT_pool * pools
Definition: abti.h:298
ABTI_local_get_local
static ABTI_local * ABTI_local_get_local(void)
Definition: abti_local.h:41
ABT_SUCCESS
#define ABT_SUCCESS
Error code: the routine returns successfully.
Definition: abt.h:92
ABTI_xstream_check_events
void ABTI_xstream_check_events(ABTI_xstream *p_xstream, ABTI_sched *p_sched)
Definition: stream.c:1568
ABTI_xstream_get_local
static ABTI_local * ABTI_xstream_get_local(ABTI_xstream *p_xstream)
Definition: abti_stream.h:68
ABT_TRUE
#define ABT_TRUE
True constant for ABT_bool.
Definition: abt.h:748
ABTI_pool_get_ptr
static ABTI_pool * ABTI_pool_get_ptr(ABT_pool pool)
Definition: abti_pool.h:11
ABTI_pool_pop
static ABT_unit ABTI_pool_pop(ABTI_pool *p_pool)
Definition: abti_pool.h:96
ABT_POOL_ACCESS_SPMC
@ ABT_POOL_ACCESS_SPMC
Definition: abt.h:539
sched_cmp_pools
static int sched_cmp_pools(const void *p1, const void *p2)
Definition: basic_wait.c:195
ABTI_sched
Definition: abti.h:289
ABTI_pool::access
ABT_pool_access access
Definition: abti.h:328
ABT_POOL_ACCESS_SPSC
@ ABT_POOL_ACCESS_SPSC
Definition: abt.h:531
ABTU_free
static void ABTU_free(void *ptr)
Definition: abtu.h:217
ABT_sched_def
A struct that defines a scheduler.
Definition: abt.h:1302
ABTI_xstream_run_thread
void ABTI_xstream_run_thread(ABTI_global *p_global, ABTI_xstream **pp_local_xstream, ABTI_thread *p_thread)
Definition: stream.c:1554
ABTI_unit_get_thread
static ABTI_thread * ABTI_unit_get_thread(ABTI_global *p_global, ABT_unit unit)
Definition: abti_unit.h:43
ABTI_sched_get_basic_wait_def
ABT_sched_def * ABTI_sched_get_basic_wait_def(void)
Definition: basic_wait.c:27
ABTI_pool_pop_wait
static ABT_unit ABTI_pool_pop_wait(ABTI_pool *p_pool, double time_secs)
Definition: abti_pool.h:75
ABTI_local
struct ABTI_local ABTI_local
Definition: abti.h:110
ABTI_pool_pop_timedwait
static ABT_unit ABTI_pool_pop_timedwait(ABTI_pool *p_pool, double abstime_secs)
Definition: abti_pool.h:85
ABTI_sched_config_get_ptr
static ABTI_sched_config * ABTI_sched_config_get_ptr(ABT_sched_config config)
Definition: abti_config.h:12
ABTI_global
Definition: abti.h:196
ABT_sched_basic_freq
ABT_sched_config_var ABT_sched_basic_freq
Predefined ABT_sched_config_var to configure the frequency for checking events of the basic scheduler...
Definition: config.c:34
ABT_UNIT_NULL
#define ABT_UNIT_NULL
Definition: abt.h:1061
ABTI_local_get_xstream
static ABTI_xstream * ABTI_local_get_xstream(ABTI_local *p_local)
Definition: abti_local.h:86
ABTU_unreachable
static ABTU_noreturn void ABTU_unreachable(void)
Definition: abtu.h:126
sched_sort_pools
static void sched_sort_pools(int num_pools, ABT_pool *pools)
Definition: basic_wait.c:211
ABTI_pool::p_pop_timedwait
ABT_pool_pop_timedwait_fn p_pop_timedwait
Definition: abti.h:348
ABTI_get_wtime
static double ABTI_get_wtime(void)
Definition: abti_timer.h:11
ABT_sched_config_var::idx
int idx
Definition: abt.h:1242
ABT_pool_access
ABT_pool_access
Pool access type.
Definition: abt.h:522