DART Initialization and Finalization

Initialization and finalization of the DASH runtime backend. More...

Collaboration diagram for DART Initialization and Finalization:

Functions
dart_ret_t	dart_init (int *argc, char ***argv)
	Initialize the DART runtime. More...
dart_ret_t	dart_init_thread (int *argc, char ***argv, dart_thread_support_level_t *thread_safety)
	Initialize the DART runtime with support for thread-based concurrency. More...
dart_ret_t	dart_exit ()
	Finalize the DASH runtime. More...
bool	dart_initialized ()
	Whether the DASH runtime has been initialized. More...
void	dart_abort (int errorcode) __attribute__((noreturn))
	Abort the application run without performing any cleanup. More...
bool	dart_lock_initialized (struct dart_lock_struct const *lock)
	Whether the lock has been properly initialized. More...

Detailed Description

Initialization and finalization of the DASH runtime backend.

No other DART function may be called before dart_init or after dart_exit.

Function Documentation

dart_abort()

void dart_abort

(

int

errorcode

)

#include </tmp/tmporruphar/dart-if/include/dash/dart/if/dart_initialization.h>

Abort the application run without performing any cleanup.

dart_abort tries to call the underlying runtime's abort function (such as MPI_Abort) and is guaranteed to not return.

Thread safety

This function is not thread-safe.

dart_exit()

dart_ret_t dart_exit

(

)

#include </tmp/tmporruphar/dart-if/include/dash/dart/if/dart_initialization.h>

Finalize the DASH runtime.

Returns

DART_OK on sucess or an error code from dart_ret_t otherwise.

Thread safety

This function is not thread-safe.

dart_init()

dart_ret_t dart_init	(	int *	argc,
		char ***	argv
	)

#include </tmp/tmporruphar/dart-if/include/dash/dart/if/dart_initialization.h>

Initialize the DART runtime.

Parameters

argc	Pointer to the number of command line arguments.
argv	Pointer to the array of command line arguments.

Returns

DART_OK on sucess or an error code from

See also

dart_ret_t otherwise.

Thread safety

This function is not thread-safe.

dart_init_thread()

dart_ret_t dart_init_thread	(	int *	argc,
		char ***	argv,
		dart_thread_support_level_t *	thread_safety
	)

#include </tmp/tmporruphar/dart-if/include/dash/dart/if/dart_initialization.h>

Initialize the DART runtime with support for thread-based concurrency.

Parameters

	argc	Pointer to the number of command line arguments.
	argv	Pointer to the array of command line arguments.
[out]	thread_safety	The provided thread safety, one of dart_thread_support_level_t.

Returns

DART_OK on sucess or an error code from

See also

dart_ret_t otherwise.

Thread safety

This function is not thread-safe.

dart_initialized()

bool dart_initialized

(

)

#include </tmp/tmporruphar/dart-if/include/dash/dart/if/dart_initialization.h>

Whether the DASH runtime has been initialized.

Returns

false if DART has not been initialized or has been shut down already, true otherwise.

Thread safety

This function is safe to be called by multiple threads in parallel.

Referenced by dash::GlobLocalMemoryPool< dash::HostSpace >::flush_local().

dart_lock_initialized()

bool dart_lock_initialized

(

struct dart_lock_struct const *

lock

)

#include </tmp/tmporruphar/dart-if/include/dash/dart/if/dart_synchronization.h>

Whether the lock has been properly initialized.

Returns

true if the DART lock is properly initialized false otherwise.

Thread safety

This function is not thread-safe.