StarPU Internal Handbook
profiling.h File Reference
#include <starpu.h>
#include <starpu_profiling.h>
#include <starpu_util.h>
#include <common/config.h>

Go to the source code of this file.

Functions

struct starpu_profiling_task_info * _starpu_allocate_profiling_info_if_needed (struct starpu_task *task)
 
void _starpu_worker_update_profiling_info_executing (int workerid, struct timespec *executing_time, int executed_tasks, uint64_t used_cycles, uint64_t stall_cycles, double consumed_energy, double flops)
 
void _starpu_worker_restart_sleeping (int workerid)
 
void _starpu_worker_stop_sleeping (int workerid)
 
void _starpu_worker_register_executing_start_date (int workerid, struct timespec *executing_start)
 
void _starpu_worker_register_executing_end (int workerid)
 
void _starpu_initialize_busid_matrix (void)
 
int _starpu_register_bus (int src_node, int dst_node)
 
void _starpu_bus_update_profiling_info (int src_node, int dst_node, size_t size)
 
void _starpu_profiling_set_task_push_start_time (struct starpu_task *task)
 
void _starpu_profiling_set_task_push_end_time (struct starpu_task *task)
 
void _starpu_profiling_init (void)
 
void _starpu_profiling_start (void)
 
void _starpu_profiling_terminate (void)
 

Function Documentation

◆ _starpu_allocate_profiling_info_if_needed()

struct starpu_profiling_task_info* _starpu_allocate_profiling_info_if_needed ( struct starpu_task *  task)

Create a task profiling info structure (with the proper time stamps) in case profiling is enabled.

◆ _starpu_worker_update_profiling_info_executing()

void _starpu_worker_update_profiling_info_executing ( int  workerid,
struct timespec *  executing_time,
int  executed_tasks,
uint64_t  used_cycles,
uint64_t  stall_cycles,
double  consumed_energy,
double  flops 
)

Update the per-worker profiling info after a task (or more) was executed. This tells StarPU how much time was spent doing computation.

◆ _starpu_worker_restart_sleeping()

void _starpu_worker_restart_sleeping ( int  workerid)

Record the date when the worker started to sleep. This permits to measure how much time was spent sleeping.

◆ _starpu_worker_stop_sleeping()

void _starpu_worker_stop_sleeping ( int  workerid)

Record the date when the worker stopped sleeping. This permits to measure how much time was spent sleeping.

◆ _starpu_worker_register_executing_start_date()

void _starpu_worker_register_executing_start_date ( int  workerid,
struct timespec *  executing_start 
)

Record the date when the worker started to execute a piece of code. This permits to measure how much time was really spent doing computation at the end of the codelet.

◆ _starpu_worker_register_executing_end()

void _starpu_worker_register_executing_end ( int  workerid)

Record that the worker is not executing any more.

◆ _starpu_initialize_busid_matrix()

void _starpu_initialize_busid_matrix ( void  )

When StarPU is initialized, a matrix describing all the bus between memory nodes is created: it indicates whether there is a physical link between two memory nodes or not. This matrix should contain the identifier of the bus between two nodes or -1 in case there is no link.

◆ _starpu_register_bus()

int _starpu_register_bus ( int  src_node,
int  dst_node 
)

Tell StarPU that there exists a link between the two memory nodes. This function returns the identifier associated to the bus which can be used to retrieve profiling information about the bus activity later on.

◆ _starpu_bus_update_profiling_info()

void _starpu_bus_update_profiling_info ( int  src_node,
int  dst_node,
size_t  size 
)

Tell StarPU that "size" bytes were transferred between the two specified memory nodes.

◆ _starpu_profiling_init()

void _starpu_profiling_init ( void  )

This function needs to be called before other starpu_profile_* functions

◆ _starpu_profiling_start()

void _starpu_profiling_start ( void  )

This function starts profiling if the STARPU_PROFILING environment variable was set