Detailed Description

Functions to create the environment and launch the simulation.

This section describes the functions for initializing SimDag, launching the simulation and exiting SimDag.

Functions
void	SD_init (int argc, char *argv)
	Initializes SD internal data. More...

void	SD_config (const char key, const char value)
	set a configuration variable More...

void	SD_create_environment (const char *platform_file)
	Creates the environment. More...

xbt_dynar_t	SD_simulate (double how_long)
	Launches the simulation. More...

double	SD_get_clock ()
	Returns the current clock, in seconds. More...

void	SD_exit ()
	Destroys all SD internal data This function should be called when the simulation is over. More...

xbt_dynar_t	SD_daxload (const char *filename)
	loads a DAX file describing a DAG More...

xbt_dynar_t	SD_dotload (const char *filename)

xbt_dynar_t	SD_dotload_with_sched (const char *filename)

xbt_dynar_t	SD_PTG_dotload (const char *filename)

Function Documentation

◆ SD_init()

void SD_init	(	int *	argc,
		char **	argv
	)

Initializes SD internal data.

This function must be called before any other SD function. Then you should call SD_create_environment().

Parameters

argc	argument number
argv	argument list

See also: SD_create_environment(), SD_exit()

◆ SD_config()

void SD_config	(	const char *	key,
		const char *	value
	)

set a configuration variable

Do –help on any simgrid binary to see the list of currently existing configuration variables, and see Section Configure SimGrid.

Example: SD_config("host/model","default");

◆ SD_create_environment()

void SD_create_environment ( const char * platform_file )

Creates the environment.

The environment (i.e. the hosts and the links) is created with the data stored in the given XML platform file.

Parameters

platform_file name of an XML file describing the environment to create

See also: Hosts, Links

The XML file follows this DTD:

\include simgrid.dtd

Here is a small example of such a platform:

\include small_platform.xml

◆ SD_simulate()

xbt_dynar_t SD_simulate ( double how_long )

Launches the simulation.

The function will execute the SD_RUNNABLE runnable tasks. If how_long is positive, then the simulation will be stopped either when time reaches how_long or when a watch point is reached. A non-positive value for how_long means no time limit, in which case the simulation will be stopped either when a watch point is reached or when no more task can be executed. Then you can call SD_simulate() again.

Parameters

how_long maximum duration of the simulation (a negative value means no time limit)

Returns: a dynar of SD_task_t whose state has changed.

See also: SD_task_schedule(), SD_task_watch()

◆ SD_get_clock()

double SD_get_clock ( )

Returns the current clock, in seconds.

◆ SD_exit()

void SD_exit ( )

Destroys all SD internal data This function should be called when the simulation is over.

Don't forget to destroy too.

See also: SD_init(), SD_task_destroy()

◆ SD_daxload()

xbt_dynar_t SD_daxload ( const char * filename )

loads a DAX file describing a DAG

See https://confluence.pegasus.isi.edu/display/pegasus/WorkflowGenerator for more details.

◆ SD_dotload()

xbt_dynar_t SD_dotload ( const char * filename )

◆ SD_dotload_with_sched()

xbt_dynar_t SD_dotload_with_sched ( const char * filename )

◆ SD_PTG_dotload()

xbt_dynar_t SD_PTG_dotload ( const char * filename )