ARGOBOTS  1.1
randws.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 /* Random Work-stealing Scheduler Implementation */
9 
10 static int sched_init(ABT_sched sched, ABT_sched_config config);
11 static void sched_run(ABT_sched sched);
12 static int sched_free(ABT_sched);
13 
16  .init = sched_init,
17  .run = sched_run,
18  .free = sched_free,
19  .get_migr_pool = NULL,
20 };
21 
22 typedef struct {
23  uint32_t event_freq;
24  int num_pools;
25  ABT_pool *pools;
26 #ifdef ABT_CONFIG_USE_SCHED_SLEEP
27  struct timespec sleep_time;
28 #endif
29 } sched_data;
30 
32 {
33  return &sched_randws_def;
34 }
35 
36 static int sched_init(ABT_sched sched, ABT_sched_config config)
37 {
38  int abt_errno;
39  int num_pools;
40  ABTI_global *p_global = ABTI_global_get_global();
41 
42  ABTI_sched *p_sched = ABTI_sched_get_ptr(sched);
44  ABTI_sched_config *p_config = ABTI_sched_config_get_ptr(config);
45 
46  /* Default settings */
47  sched_data *p_data;
48  abt_errno = ABTU_malloc(sizeof(sched_data), (void **)&p_data);
49  ABTI_CHECK_ERROR(abt_errno);
50 #ifdef ABT_CONFIG_USE_SCHED_SLEEP
51  p_data->sleep_time.tv_sec = 0;
52  p_data->sleep_time.tv_nsec = p_global->sched_sleep_nsec;
53 #endif
54 
55  /* Set the default value by default. */
56  p_data->event_freq = p_global->sched_event_freq;
57  if (p_config) {
58  int event_freq;
59  /* Set the variables from config */
60  abt_errno = ABTI_sched_config_read(p_config, ABT_sched_basic_freq.idx,
61  &event_freq);
62  if (abt_errno == ABT_SUCCESS) {
63  p_data->event_freq = event_freq;
64  }
65  }
66 
67  /* Save the list of pools */
68  num_pools = p_sched->num_pools;
69  p_data->num_pools = num_pools;
70  abt_errno =
71  ABTU_malloc(num_pools * sizeof(ABT_pool), (void **)&p_data->pools);
72  if (ABTI_IS_ERROR_CHECK_ENABLED && abt_errno != ABT_SUCCESS) {
73  ABTU_free(p_data);
74  ABTI_HANDLE_ERROR(abt_errno);
75  }
76  memcpy(p_data->pools, p_sched->pools, sizeof(ABT_pool) * num_pools);
77 
78  p_sched->data = p_data;
79  return ABT_SUCCESS;
80 }
81 
82 static void sched_run(ABT_sched sched)
83 {
84  ABTI_global *p_global = ABTI_global_get_global();
85  ABTI_xstream *p_local_xstream =
87  uint32_t work_count = 0;
88  sched_data *p_data;
89  int num_pools;
90  ABT_pool *pools;
91  ABT_unit unit;
92  int target;
93  unsigned seed = time(NULL);
94  CNT_DECL(run_cnt);
95 
96  ABTI_sched *p_sched = ABTI_sched_get_ptr(sched);
97  ABTI_ASSERT(p_sched);
98 
99  p_data = (sched_data *)p_sched->data;
100  num_pools = p_sched->num_pools;
101  pools = p_data->pools;
102 
103  while (1) {
104  CNT_INIT(run_cnt, 0);
105 
106  /* Execute one work unit from the scheduler's pool */
107  ABT_pool pool = pools[0];
108  ABTI_pool *p_pool = ABTI_pool_get_ptr(pool);
109  unit = ABTI_pool_pop(p_pool);
110  if (unit != ABT_UNIT_NULL) {
111  ABTI_thread *p_thread = ABTI_unit_get_thread(p_global, unit);
112  ABTI_xstream_run_thread(p_global, &p_local_xstream, p_thread);
113  CNT_INC(run_cnt);
114  } else if (num_pools > 1) {
115  /* Steal a work unit from other pools */
116  target =
117  (num_pools == 2) ? 1 : (rand_r(&seed) % (num_pools - 1) + 1);
118  pool = pools[target];
119  p_pool = ABTI_pool_get_ptr(pool);
120  unit = ABTI_pool_pop(p_pool);
121  LOG_DEBUG_POOL_POP(p_pool, unit);
122  if (unit != ABT_UNIT_NULL) {
123  ABTI_thread *p_thread = ABTI_unit_get_thread(p_global, unit);
124  ABTI_xstream_run_thread(p_global, &p_local_xstream, p_thread);
125  CNT_INC(run_cnt);
126  }
127  }
128 
129  if (++work_count >= p_data->event_freq) {
130  ABTI_xstream_check_events(p_local_xstream, p_sched);
131  ABTI_local *p_local = ABTI_xstream_get_local(p_local_xstream);
132  if (ABTI_sched_has_to_stop(&p_local, p_sched) == ABT_TRUE)
133  break;
134  p_local_xstream = ABTI_local_get_xstream(p_local);
135  work_count = 0;
136  SCHED_SLEEP(run_cnt, p_data->sleep_time);
137  }
138  }
139 }
140 
141 static int sched_free(ABT_sched sched)
142 {
143  ABTI_sched *p_sched = ABTI_sched_get_ptr(sched);
144  ABTI_ASSERT(p_sched);
145 
146  sched_data *p_data = (sched_data *)p_sched->data;
147  ABTU_free(p_data->pools);
148  ABTU_free(p_data);
149  return ABT_SUCCESS;
150 }
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
ABTI_global::sched_sleep_nsec
uint64_t sched_sleep_nsec
Definition: abti.h:212
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_init
static int sched_init(ABT_sched sched, ABT_sched_config config)
Definition: randws.c:36
ABTI_CHECK_ERROR
#define ABTI_CHECK_ERROR(abt_errno)
Definition: abti_error.h:120
ABTI_sched::num_pools
size_t num_pools
Definition: abti.h:299
sched_data
Definition: basic.c:21
ABT_sched_config
struct ABT_sched_config_opaque * ABT_sched_config
Scheduler configuration handle type.
Definition: abt.h:815
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_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_HANDLE_ERROR
#define ABTI_HANDLE_ERROR(n)
Definition: abti_error.h:114
sched_randws_def
static ABT_sched_def sched_randws_def
Definition: randws.c:14
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
LOG_DEBUG_POOL_POP
#define LOG_DEBUG_POOL_POP(p_pool, unit)
Definition: abti_log.h:30
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
sched_run
static void sched_run(ABT_sched sched)
Definition: randws.c:82
ABTI_sched
Definition: abti.h:289
CNT_INIT
#define CNT_INIT(c, v)
Definition: abti_sched.h:79
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
CNT_DECL
#define CNT_DECL(c)
Definition: abti_sched.h:78
ABTI_local
struct ABTI_local ABTI_local
Definition: abti.h:110
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
SCHED_SLEEP
#define SCHED_SLEEP(c, t)
Definition: abti_sched.h:81
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
CNT_INC
#define CNT_INC(c)
Definition: abti_sched.h:80
ABTI_local_get_xstream
static ABTI_xstream * ABTI_local_get_xstream(ABTI_local *p_local)
Definition: abti_local.h:86
ABTI_sched_get_randws_def
ABT_sched_def * ABTI_sched_get_randws_def(void)
Definition: randws.c:31
sched_free
static int sched_free(ABT_sched)
Definition: randws.c:141
ABT_sched_config_var::idx
int idx
Definition: abt.h:1242