StarPU Handbook - StarPU Performances
Loading...
Searching...
No Matches
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
23extern "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
39enum 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
71static 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
103void starpu_heteroprio_set_use_locality(unsigned sched_ctx_id, unsigned use_locality);
104
106void starpu_heteroprio_set_nb_prios(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned max_prio);
107
109void starpu_heteroprio_set_mapping(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned source_prio, unsigned dest_bucket_id);
110
112void starpu_heteroprio_set_faster_arch(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned bucket_id);
113
115void starpu_heteroprio_set_arch_slow_factor(unsigned sched_ctx_id, enum starpu_worker_archtype arch, unsigned bucket_id, float slow_factor);
116
119
121void 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