/usr/include/starpu_perfmodel.h is in libstarpu-dev 0.9.1-3build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 | /* StarPU --- Runtime system for heterogeneous multicore architectures.
*
* Copyright (C) 2010, 2011 Université de Bordeaux 1
* Copyright (C) 2010 Centre National de la Recherche Scientifique
*
* StarPU is free software; you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation; either version 2.1 of the License, or (at
* your option) any later version.
*
* StarPU is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
*
* See the GNU Lesser General Public License in COPYING.LGPL for more details.
*/
#ifndef __STARPU_PERFMODEL_H__
#define __STARPU_PERFMODEL_H__
#include <starpu_config.h>
#include <stdio.h>
#include <starpu.h>
#include <starpu_task.h>
#if ! defined(_MSC_VER)
# include <pthread.h>
#endif
#ifdef __cplusplus
extern "C" {
#endif
struct starpu_htbl32_node_s;
struct starpu_history_list_t;
struct starpu_buffer_descr_t;
/*
it is possible that we have multiple versions of the same kind of workers,
for instance multiple GPUs or even different CPUs within the same machine
so we do not use the archtype enum type directly for performance models
*/
enum starpu_perf_archtype {
STARPU_CPU_DEFAULT = 0,
/* CPU combined workers between 0 and STARPU_NMAXCPUS-1 */
STARPU_CUDA_DEFAULT = STARPU_NMAXCPUS,
STARPU_OPENCL_DEFAULT = STARPU_CUDA_DEFAULT + STARPU_MAXCUDADEVS,
/* STARPU_OPENCL_DEFAULT + devid */
STARPU_GORDON_DEFAULT = STARPU_OPENCL_DEFAULT + STARPU_MAXOPENCLDEVS
};
#define STARPU_NARCH_VARIATIONS (STARPU_GORDON_DEFAULT+1)
struct starpu_regression_model_t {
/* sum of ln(measured) */
double sumlny;
/* sum of ln(size) */
double sumlnx;
double sumlnx2;
/* sum of ln(size) ln(measured) */
double sumlnxlny;
/* y = alpha size ^ beta */
double alpha;
double beta;
unsigned valid;
/* y = a size ^b + c */
double a, b, c;
unsigned nl_valid;
unsigned nsample;
};
struct starpu_per_arch_perfmodel_t {
double (*cost_model)(struct starpu_buffer_descr_t *t); /* returns expected duration in µs */
/* internal variables */
double alpha;
struct starpu_htbl32_node_s *history;
struct starpu_history_list_t *list;
struct starpu_regression_model_t regression;
#ifdef STARPU_MODEL_DEBUG
FILE *debug_file;
#endif
};
typedef enum {
STARPU_PER_ARCH, /* Application-provided per-arch cost model function */
STARPU_COMMON, /* Application-provided common cost model function, with per-arch factor */
STARPU_HISTORY_BASED, /* Automatic history-based cost model */
STARPU_REGRESSION_BASED, /* Automatic linear regression-based cost model (alpha * size ^ beta) */
STARPU_NL_REGRESSION_BASED /* Automatic non-linear regression-based cost model (a * size ^ b + c) */
} starpu_perfmodel_type;
struct starpu_perfmodel_t {
/* which model is used for that task ? */
starpu_perfmodel_type type;
/* single cost model (STARPU_COMMON), returns expected duration in µs */
double (*cost_model)(struct starpu_buffer_descr_t *);
/* per-architecture model */
struct starpu_per_arch_perfmodel_t per_arch[STARPU_NARCH_VARIATIONS];
/* Name of the performance model, this is used as a file name when saving history-based performance models */
const char *symbol;
/* Internal variables */
unsigned is_loaded;
unsigned benchmarking;
#if defined(_MSC_VER)
void *model_rwlock;
#else
pthread_rwlock_t model_rwlock;
#endif
};
/* This function is intended to be used by external tools that should read the
* performance model files */
int starpu_load_history_debug(const char *symbol, struct starpu_perfmodel_t *model);
void starpu_perfmodel_debugfilepath(struct starpu_perfmodel_t *model,
enum starpu_perf_archtype arch, char *path, size_t maxlen);
void starpu_perfmodel_get_arch_name(enum starpu_perf_archtype arch,
char *archname, size_t maxlen);
int starpu_list_models(void);
void starpu_force_bus_sampling(void);
#ifdef __cplusplus
}
#endif
#endif /* __STARPU_PERFMODEL_H__ */
|