StarPU Internal Handbook
perfmodel.h
Go to the documentation of this file.
1/* StarPU --- Runtime system for heterogeneous multicore architectures.
2 *
3 * Copyright (C) 2008-2023 Université de Bordeaux, CNRS (LaBRI UMR 5800), Inria
4 * Copyright (C) 2011 Télécom-SudParis
5 * Copyright (C) 2013 Thibaut Lambert
6 *
7 * StarPU is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU Lesser General Public License as published by
9 * the Free Software Foundation; either version 2.1 of the License, or (at
10 * your option) any later version.
11 *
12 * StarPU is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
15 *
16 * See the GNU Lesser General Public License in COPYING.LGPL for more details.
17 */
18
19#ifndef __PERFMODEL_H__
20#define __PERFMODEL_H__
21
24#include <common/config.h>
25#include <starpu.h>
26#include <core/task_bundle.h>
27#include <stdio.h>
28
29#pragma GCC visibility push(hidden)
30
31#ifdef __cplusplus
32extern "C"
33{
34#endif
35
36void _starpu_init_perfmodel(void);
37
47#define _STARPU_PERFMODEL_VERSION 45
48#define PATH_LENGTH 256
49#define STR_SHORT_LENGTH 32
50#define STR_LONG_LENGTH 256
51#define STR_VERY_LONG_LENGTH 1024
52
54{
55 struct starpu_perfmodel_per_arch** per_arch; /*STARPU_MAXIMPLEMENTATIONS*/
56 int** per_arch_is_set; /*STARPU_MAXIMPLEMENTATIONS*/
57
58 starpu_pthread_rwlock_t model_rwlock;
59 int *nimpls;
60 int *nimpls_set;
62 int ncombs;
65 int *combs;
66};
67
68struct starpu_data_descr;
69struct _starpu_job;
70struct starpu_perfmodel_arch;
71
72extern unsigned _starpu_calibration_minimum;
73
74void _starpu_find_perf_model_codelet(const char *symbol, const char *hostname, char *path, size_t maxlen);
75void _starpu_find_perf_model_codelet_debug(const char *symbol, const char *hostname, const char *arch, char *path, size_t maxlen);
76void _starpu_set_default_perf_model_codelet(const char *symbol, const char *hostname, char *path, size_t maxlen);
77
78char *_starpu_get_perf_model_dir_default();
79char **_starpu_get_perf_model_dirs_codelet() STARPU_ATTRIBUTE_VISIBILITY_DEFAULT;
80char *_starpu_get_perf_model_dir_bus();
81
82double _starpu_history_based_job_expected_perf(struct starpu_perfmodel *model, struct starpu_perfmodel_arch* arch, struct _starpu_job *j, unsigned nimpl);
83double _starpu_history_based_job_expected_deviation(struct starpu_perfmodel *model, struct starpu_perfmodel_arch* arch, struct _starpu_job *j, unsigned nimpl);
84void _starpu_load_history_based_model(struct starpu_perfmodel *model, unsigned scan_history);
85void _starpu_init_and_load_perfmodel(struct starpu_perfmodel *model);
86void _starpu_initialize_registered_performance_models(void);
87void _starpu_deinitialize_registered_performance_models(void);
88void _starpu_deinitialize_performance_model(struct starpu_perfmodel *model);
89
90double _starpu_regression_based_job_expected_perf(struct starpu_perfmodel *model, struct starpu_perfmodel_arch* arch, struct _starpu_job *j, unsigned nimpl);
91double _starpu_non_linear_regression_based_job_expected_perf(struct starpu_perfmodel *model, struct starpu_perfmodel_arch* arch, struct _starpu_job *j, unsigned nimpl);
92double _starpu_multiple_regression_based_job_expected_perf(struct starpu_perfmodel *model, struct starpu_perfmodel_arch* arch, struct _starpu_job *j, unsigned nimpl);
93void _starpu_update_perfmodel_history(struct _starpu_job *j, struct starpu_perfmodel *model, struct starpu_perfmodel_arch * arch, unsigned cpuid, double measured, unsigned nimpl, unsigned number);
94int _starpu_perfmodel_create_comb_if_needed(struct starpu_perfmodel_arch* arch);
95
96int _starpu_create_bus_sampling_directory_if_needed(int location);
97void _starpu_create_codelet_sampling_directory_if_needed(int location);
98
99void _starpu_load_bus_performance_files(void);
100
101int _starpu_get_perf_model_bus();
102int _starpu_set_default_perf_model_bus();
103
104void _starpu_set_calibrate_flag(unsigned val);
105unsigned _starpu_get_calibrate_flag(void);
106
107#if defined(STARPU_USE_CUDA)
108unsigned *_starpu_get_cuda_affinity_vector(unsigned gpuid);
109#endif
110#if defined(STARPU_USE_OPENCL)
111unsigned *_starpu_get_opencl_affinity_vector(unsigned gpuid);
112#endif
113
114void _starpu_save_bandwidth_and_latency_disk(double bandwidth_write, double bandwidth_read, double latency_write, double latency_read, unsigned node, const char *name);
115
116void _starpu_write_double(FILE *f, const char *format, double val) STARPU_ATTRIBUTE_VISIBILITY_DEFAULT;
117int _starpu_read_double(FILE *f, char *format, double *val) STARPU_ATTRIBUTE_VISIBILITY_DEFAULT;
118void _starpu_simgrid_get_platform_path(int version, char *path, size_t maxlen);
119
120void _starpu_perfmodel_realloc(struct starpu_perfmodel *model, int nb);
121
122void _starpu_free_arch_combs(void);
123
124#if defined(STARPU_HAVE_HWLOC)
125hwloc_topology_t _starpu_perfmodel_get_hwtopology();
126#endif
127
128#ifdef __cplusplus
129}
130#endif
131
132#pragma GCC visibility pop
133
134#endif // __PERFMODEL_H__
#define struct
Definition: list.h:175
int ncombs_set
Definition: perfmodel.h:64
int ncombs
Definition: perfmodel.h:62
Definition: perfmodel.h:54
Definition: jobs.h:74