StarPU Handbook - StarPU Installation
starpu_heteroprio.h
Go to the documentation of this file.
1 /* StarPU --- Runtime system for heterogeneous multicore architectures.
2  *
3  * Copyright (C) 2015-2022 Université de Bordeaux, CNRS (LaBRI UMR 5800), Inria
4  *
5  * StarPU is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU Lesser General Public License as published by
7  * the Free Software Foundation; either version 2.1 of the License, or (at
8  * your option) any later version.
9  *
10  * StarPU is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13  *
14  * See the GNU Lesser General Public License in COPYING.LGPL for more details.
15  */
16 
17 #ifndef __STARPU_SCHEDULER_HETEROPRIO_H__
18 #define __STARPU_SCHEDULER_HETEROPRIO_H__
19 
20 #include <starpu.h>
21 
22 #ifdef __cplusplus
23 extern "C" {
24 #endif
25 
32 #define STARPU_HETEROPRIO_MAX_PREFETCH 2
33 #if STARPU_HETEROPRIO_MAX_PREFETCH <= 0
34 #error STARPU_HETEROPRIO_MAX_PREFETCH == 1 means no prefetch so STARPU_HETEROPRIO_MAX_PREFETCH must >= 1
35 #endif
36 
37 #define STARPU_AUTOHETEROPRIO_PRIORITY_ORDERING_POLICY_COUNT 28
38 
39 enum starpu_autoheteroprio_priority_ordering_policy
40 {
41  STARPU_HETEROPRIO_NOD_TIME_COMBINATION, // 0
42  STARPU_HETEROPRIO_BEST_NODS_SCORE,
43  STARPU_HETEROPRIO_BEST_NODS,
44  STARPU_HETEROPRIO_URT_PURE,
45  STARPU_HETEROPRIO_URT,
46  STARPU_HETEROPRIO_URT_2, // 5
47  STARPU_HETEROPRIO_URT_DOT_DIFF_PURE,
48  STARPU_HETEROPRIO_URT_DOT_DIFF_PURE_2,
49  STARPU_HETEROPRIO_URT_DOT_REL_DIFF_PURE,
50  STARPU_HETEROPRIO_URT_DOT_REL_DIFF_PURE_2,
51  STARPU_HETEROPRIO_URT_DOT_DIFF_2, // 10
52  STARPU_HETEROPRIO_URT_DOT_DIFF_3,
53  STARPU_HETEROPRIO_URT_DOT_DIFF_4,
54  STARPU_HETEROPRIO_URT_DOT_DIFF_5,
55  STARPU_HETEROPRIO_URT_DOT_DIFF_6,
56  STARPU_HETEROPRIO_URT_DOT_DIFF_7, // 15
57  STARPU_HETEROPRIO_URT_DOT_DIFF_8,
58  STARPU_HETEROPRIO_URT_DOT_DIFF_9,
59  STARPU_HETEROPRIO_URT_DOT_DIFF_10,
60  STARPU_HETEROPRIO_URT_DOT_DIFF_11,
61  STARPU_HETEROPRIO_URTS_PER_SECONDS, // 20
62  STARPU_HETEROPRIO_URTS_PER_SECONDS_2,
63  STARPU_HETEROPRIO_URTS_PER_SECONDS_DIFF,
64  STARPU_HETEROPRIO_URTS_TIME_RELEASED_DIFF,
65  STARPU_HETEROPRIO_URTS_TIME_COMBINATION,
66  STARPU_HETEROPRIO_NODS_PER_SECOND,
67  STARPU_HETEROPRIO_NODS_TIME_RELEASED,
68  STARPU_HETEROPRIO_NODS_TIME_RELEASED_DIFF
69 };
70 
71 static const char starpu_autoheteroprio_priority_ordering_policy_names[STARPU_AUTOHETEROPRIO_PRIORITY_ORDERING_POLICY_COUNT][64] = {
72  "STARPU_HETEROPRIO_NOD_TIME_COMBINATION",
73  "STARPU_HETEROPRIO_BEST_NODS_SCORE",
74  "STARPU_HETEROPRIO_BEST_NODS",
75  "STARPU_HETEROPRIO_URT_PURE",
76  "STARPU_HETEROPRIO_URT",
77  "STARPU_HETEROPRIO_URT_2",
78  "STARPU_HETEROPRIO_URT_DOT_DIFF_PURE",
79  "STARPU_HETEROPRIO_URT_DOT_DIFF_PURE_2",
80  "STARPU_HETEROPRIO_URT_DOT_REL_DIFF_PURE",
81  "STARPU_HETEROPRIO_URT_DOT_REL_DIFF_PURE_2",
82  "STARPU_HETEROPRIO_URT_DOT_DIFF_2",
83  "STARPU_HETEROPRIO_URT_DOT_DIFF_3",
84  "STARPU_HETEROPRIO_URT_DOT_DIFF_4",
85  "STARPU_HETEROPRIO_URT_DOT_DIFF_5",
86  "STARPU_HETEROPRIO_URT_DOT_DIFF_6",
87  "STARPU_HETEROPRIO_URT_DOT_DIFF_7",
88  "STARPU_HETEROPRIO_URT_DOT_DIFF_8",
89  "STARPU_HETEROPRIO_URT_DOT_DIFF_9",
90  "STARPU_HETEROPRIO_URT_DOT_DIFF_10",
91  "STARPU_HETEROPRIO_URT_DOT_DIFF_11",
92  "STARPU_HETEROPRIO_URTS_PER_SECONDS",
93  "STARPU_HETEROPRIO_URTS_PER_SECONDS_2",
94  "STARPU_HETEROPRIO_URTS_PER_SECONDS_DIFF",
95  "STARPU_HETEROPRIO_URTS_TIME_RELEASED_DIFF",
96  "STARPU_HETEROPRIO_URTS_TIME_COMBINATION",
97  "STARPU_HETEROPRIO_NODS_PER_SECOND",
98  "STARPU_HETEROPRIO_NODS_TIME_RELEASED",
99  "STARPU_HETEROPRIO_NODS_TIME_RELEASED_DIFF",
100 };
101 
103 void starpu_heteroprio_set_use_locality(unsigned sched_ctx_id, unsigned use_locality);
104 
106 void starpu_heteroprio_set_nb_prios(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned max_prio);
107 
109 void starpu_heteroprio_set_mapping(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned source_prio, unsigned dest_bucket_id);
110 
112 void starpu_heteroprio_set_faster_arch(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned bucket_id);
113 
115 void starpu_heteroprio_set_arch_slow_factor(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned bucket_id, float slow_factor);
116 
118 void starpu_heteroprio_map_wgroup_memory_nodes(unsigned sched_ctx_id);
119 
121 void starpu_heteroprio_print_wgroups(FILE *stream, unsigned sched_ctx_id);
122 
125 #ifdef __cplusplus
126 }
127 #endif
128 
129 #endif /* __STARPU_SCHEDULER_HETEROPRIO_H__ */
void starpu_heteroprio_print_wgroups(FILE *stream, unsigned sched_ctx_id)
void starpu_heteroprio_set_faster_arch(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned bucket_id)
void starpu_heteroprio_set_arch_slow_factor(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned bucket_id, float slow_factor)
void starpu_heteroprio_set_mapping(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned source_prio, unsigned dest_bucket_id)
void starpu_heteroprio_map_wgroup_memory_nodes(unsigned sched_ctx_id)
void starpu_heteroprio_set_use_locality(unsigned sched_ctx_id, unsigned use_locality)
void starpu_heteroprio_set_nb_prios(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned max_prio)
starpu_worker_archtype
Definition: starpu_worker.h:66