StarPU Handbook
|
Data Structures | |
struct | starpu_profiling_task_info |
struct | starpu_profiling_worker_info |
struct | starpu_profiling_bus_info |
Macros | |
#define | STARPU_PROFILING_DISABLE |
#define | STARPU_PROFILING_ENABLE |
#define | STARPU_NS_PER_S |
#define | starpu_timespec_cmp(a, b, CMP) |
Functions | |
void | starpu_profiling_init (void) |
void | starpu_profiling_set_id (int new_id) |
int | starpu_profiling_status_set (int status) |
int | starpu_profiling_status_get (void) |
int | starpu_profiling_worker_get_info (int workerid, struct starpu_profiling_worker_info *worker_info) |
int | starpu_bus_get_count (void) |
int | starpu_bus_get_id (int src, int dst) |
int | starpu_bus_get_src (int busid) |
int | starpu_bus_get_dst (int busid) |
void | starpu_bus_set_direct (int busid, int direct) |
int | starpu_bus_get_direct (int busid) |
void | starpu_bus_set_ngpus (int busid, int ngpus) |
int | starpu_bus_get_ngpus (int busid) |
int | starpu_bus_get_profiling_info (int busid, struct starpu_profiling_bus_info *bus_info) |
static __starpu_inline void | starpu_timespec_clear (struct timespec *tsp) |
static __starpu_inline void | starpu_timespec_add (struct timespec *a, struct timespec *b, struct timespec *result) |
static __starpu_inline void | starpu_timespec_accumulate (struct timespec *result, struct timespec *a) |
static __starpu_inline void | starpu_timespec_sub (const struct timespec *a, const struct timespec *b, struct timespec *result) |
double | starpu_timing_timespec_delay_us (struct timespec *start, struct timespec *end) |
double | starpu_timing_timespec_to_us (struct timespec *ts) |
void | starpu_profiling_bus_helper_display_summary (void) |
void | starpu_profiling_worker_helper_display_summary (void) |
void | starpu_data_display_memory_stats (void) |
struct starpu_profiling_task_info |
Information about the execution of a task. It is accessible from the field starpu_task::profiling_info if profiling was enabled.
struct starpu_profiling_worker_info |
Profiling information associated to a worker. The timing is provided since the previous call to starpu_profiling_worker_get_info().
The executing_time, callback_time, waiting_time, sleeping_time, and scheduling_time are exclusive to each other, i.e. they can be added up, their sum is smaller than total_time. The difference between total_time and the sum is the uncategorized runtime overhead.
struct starpu_profiling_bus_info |
#define STARPU_PROFILING_DISABLE |
Used when calling the function starpu_profiling_status_set() to disable profiling.
#define STARPU_PROFILING_ENABLE |
Used when calling the function starpu_profiling_status_set() to enable profiling.
void starpu_profiling_init | ( | void | ) |
Reset performance counters and enable profiling if the environment variable STARPU_PROFILING is set to a positive value. See Enabling On-line Performance Monitoring for more details.
void starpu_profiling_set_id | ( | int | new_id | ) |
Set the ID used for profiling trace filename. Has to be called before starpu_init(). See Tracing MPI applications for more details.
int starpu_profiling_status_set | ( | int | status | ) |
Set the profiling status. Profiling is activated by passing STARPU_PROFILING_ENABLE in status
. Passing STARPU_PROFILING_DISABLE disables profiling. Calling this function resets all profiling measurements. When profiling is enabled, the field starpu_task::profiling_info points to a valid structure starpu_profiling_task_info containing information about the execution of the task. Negative return values indicate an error, otherwise the previous status is returned. See Enabling On-line Performance Monitoring for more details.
int starpu_profiling_status_get | ( | void | ) |
Return the current profiling status or a negative value in case there was an error. See Enabling On-line Performance Monitoring for more details.
int starpu_profiling_worker_get_info | ( | int | workerid, |
struct starpu_profiling_worker_info * | worker_info | ||
) |
Get the profiling info associated to the worker identified by workerid
, and reset the profiling measurements. If the argument worker_info
is NULL
, only reset the counters associated to worker workerid
. Upon successful completion, this function returns 0. Otherwise, a negative value is returned. See Per-worker Feedback for more details.
int starpu_bus_get_count | ( | void | ) |
Return the number of buses in the machine. See Hardware Topology for more details.
int starpu_bus_get_id | ( | int | src, |
int | dst | ||
) |
Return the identifier of the bus between src
and dst
. See Hardware Topology for more details.
int starpu_bus_get_src | ( | int | busid | ) |
Return the source point of bus busid
. See Hardware Topology for more details.
int starpu_bus_get_dst | ( | int | busid | ) |
Return the destination point of bus busid
. See Hardware Topology for more details.
void starpu_bus_set_direct | ( | int | busid, |
int | direct | ||
) |
See Hardware Topology for more details.
int starpu_bus_get_direct | ( | int | busid | ) |
See Hardware Topology for more details.
void starpu_bus_set_ngpus | ( | int | busid, |
int | ngpus | ||
) |
See Hardware Topology for more details.
int starpu_bus_get_ngpus | ( | int | busid | ) |
See Hardware Topology for more details.
int starpu_bus_get_profiling_info | ( | int | busid, |
struct starpu_profiling_bus_info * | bus_info | ||
) |
See _starpu_profiling_bus_helper_display_summary in src/profiling/profiling_helpers.c for a usage example. Note that calling starpu_bus_get_profiling_info() resets the counters to zero. See Feedback Figures for more details.
double starpu_timing_timespec_delay_us | ( | struct timespec * | start, |
struct timespec * | end | ||
) |
Return the time elapsed between start
and end
in microseconds. See Per-task Feedback for more details.
double starpu_timing_timespec_to_us | ( | struct timespec * | ts | ) |
Convert the given timespec ts
into microseconds. See Per-task Feedback for more details.
void starpu_profiling_bus_helper_display_summary | ( | void | ) |
Display statistics about the bus on stderr
. if the environment variable STARPU_BUS_STATS is defined. The function is called automatically by starpu_shutdown(). See Data Statistics for more details.
void starpu_profiling_worker_helper_display_summary | ( | void | ) |
Display statistic about the workers on stderr
if the environment variable STARPU_WORKER_STATS is defined. The function is called automatically by starpu_shutdown(). See Data Statistics for more details.
void starpu_data_display_memory_stats | ( | void | ) |
Display statistics about the current data handles registered within StarPU. StarPU must have been configured with the configure option --enable-memory-stats (see Memory Feedback). See Memory Feedback for more details.