nm_mpi_base.h File Reference

declarations for MPI environmental management More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
Functions: Environmental management
int	MPI_Init (int *argc, char ***argv)
	This routine must be called before any other MPI routine.
int	MPI_Init_thread (int *argc, char ***argv, int required, int *provided)
	The following function may be used to initialize MPI, and initialize the MPI thread environment, instead of MPI_Init().
int	MPI_Query_thread (int *provided)
	Return the level of thread support provided by the MPI library.
int	MPI_Initialized (int *flag)
	Indicates whether MPI_Init has been called.
int	MPI_Finalize (void)
	This routine must be called by each process before it exits.
int	MPI_Finalized (int *flag)
	Indicates whether MPI_Finalize has been called.
int	MPI_Abort (MPI_Comm comm, int errorcode)
	This routine makes a best attempt to abort all tasks in the group of comm.
int	MPI_Get_processor_name (char *name, int *resultlen)
	This routine returns the name of the processor on which it was called at the moment of the call.
double	MPI_Wtime (void)
	Returns a floating-point number of seconds, representing elapsed wall-clock time since some time in the past.
double	MPI_Wtick (void)
	Returns the resolution of MPI_Wtime() in seconds.
int	MPI_Get_version (int *version, int *subversion)
	Returns the version.
int	MPI_Get_library_version (char *version, int *resultlen)
	Returns the version of madmpi.
int	MPI_Pcontrol (const int level,...)
int	MPI_Get_address (const void *location, MPI_Aint *address)
	Returns the byte address of location.
int	MPI_Address (void *location, MPI_Aint *address)
	Returns the byte address of location.
int	MPI_Alloc_mem (MPI_Aint size, MPI_Info info, void *baseptr)
	Allocate memory for message passing.
int	MPI_Free_mem (void *base)
	Free memory allocated with MPI_Alloc_mem.

Detailed Description

declarations for MPI environmental management

Definition in file nm_mpi_base.h.

Function Documentation

MPI_Abort()

int MPI_Abort	(	MPI_Comm	comm,
		int	errorcode
	)

This routine makes a best attempt to abort all tasks in the group of comm.

Parameters

comm	communicator of tasks to abort
errorcode	error code to return to invoking environment

Returns

MPI status

MPI_Address()

int MPI_Address	(	void *	location,
		MPI_Aint *	address
	)

Returns the byte address of location.

Parameters

location	location in caller memory
address	address of location

Returns

MPI status

MPI_Alloc_mem()

int MPI_Alloc_mem	(	MPI_Aint	size,
		MPI_Info	info,
		void *	baseptr
	)

Allocate memory for message passing.

MPI_Finalize()

int MPI_Finalize

(

void

)

This routine must be called by each process before it exits.

The call cleans up all MPI state.

Returns

MPI status

MPI_Finalized()

int MPI_Finalized

(

int *

flag

)

Indicates whether MPI_Finalize has been called.

Parameters

flag	a pointer to an int set to 1 if MPI_Finalize has been called, 0 otherwise.

MPI_Free_mem()

int MPI_Free_mem

(

void *

base

)

Free memory allocated with MPI_Alloc_mem.

MPI_Get_address()

int MPI_Get_address	(	const void *	location,
		MPI_Aint *	address
	)

Returns the byte address of location.

Parameters

location	location in caller memory
address	address of location

Returns

MPI status

MPI_Get_library_version()

int MPI_Get_library_version	(	char *	version,
		int *	resultlen
	)

Returns the version of madmpi.

Parameters

version	madmpi version string
resultlen	resultlen size of version string

Returns

MPI status.

MPI_Get_processor_name()

int MPI_Get_processor_name	(	char *	name,
		int *	resultlen
	)

This routine returns the name of the processor on which it was called at the moment of the call.

Parameters

name	unique specifier for the actual (as opposed to virtual) node
resultlen	length (in printable characters) of the result returned in name

Returns

MPI status

MPI_Get_version()

int MPI_Get_version	(	int *	version,
		int *	subversion
	)

Returns the version.

Parameters

version	version number
subversion	subversion number

Returns

MPI status.

MPI_Init()

int MPI_Init	(	int *	argc,
		char ***	argv
	)

This routine must be called before any other MPI routine.

It must be called at most once; subsequent calls are erroneous.

Parameters

argc	a pointer to the process argc.
argv	a pointer to the process argv.

Returns

MPI status

MPI_Init_thread()

int MPI_Init_thread	(	int *	argc,
		char ***	argv,
		int	required,
		int *	provided
	)

The following function may be used to initialize MPI, and initialize the MPI thread environment, instead of MPI_Init().

Parameters

argc	a pointer to the process argc.
argv	a pointer to the process argv.
required	level of thread support (integer).
provided	level of thread support (integer).

Returns

MPI status

MPI_Initialized()

int MPI_Initialized

(

int *

flag

)

Indicates whether MPI_Init has been called.

Parameters

flag	a pointer to an int set to 1 if MPI_Init has been called, 0 otherwise.

MPI_Pcontrol()

int MPI_Pcontrol	(	const int	level,
			...
	)

MPI_Query_thread()

int MPI_Query_thread

(

int *

provided

)

Return the level of thread support provided by the MPI library.

MPI_Wtick()

double MPI_Wtick

(

void

)

Returns the resolution of MPI_Wtime() in seconds.

Returns

resolution of MPI_Wtime() in seconds

MPI_Wtime()

double MPI_Wtime

(

void

)

Returns a floating-point number of seconds, representing elapsed wall-clock time since some time in the past.

Returns

floating-point number of seconds