NewMadeleine

declarations for MPI requests More...

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

Functions
Functions: Request-related functions
int	MPI_Cancel (MPI_Request *request)
	Marks for cancellation a pending, nonblocking communication operation (send or receive). More...

int	MPI_Request_free (MPI_Request *request)
	Marks the request object for deallocation and set request to MPI_REQUEST_NULL. More...

int	MPI_Wait (MPI_Request request, MPI_Status status)
	Returns when the operation identified by request is complete. More...

int	MPI_Waitall (int count, MPI_Request array_of_requests, MPI_Status array_of_statuses)
	Returns when all the operations identified by requests are complete. More...

int	MPI_Waitany (int count, MPI_Request array_of_requests, int index, MPI_Status *status)
	Blocks until one of the operations associated with the active requests in the array has completed. More...

int	MPI_Waitsome (int incount, MPI_Request array_of_requests, int outcount, int array_of_indices, MPI_Status array_of_statuses)

int	MPI_Test (MPI_Request request, int flag, MPI_Status *status)
	Returns flag = true if the operation identified by request is complete. More...

int	MPI_Testany (int count, MPI_Request array_of_requests, int index, int flag, MPI_Status status)
	Tests for completion of one communication operation associated with requests in the array. More...

int	MPI_Testsome (int count, MPI_Request array_of_requests, int outcount, int indices, MPI_Status statuses)
	Tests for completion of several communication operations associated with requests in the array. More...

int	MPI_Testall (int count, MPI_Request array_of_requests, int flag, MPI_Status *statuses)
	Tests for the completion of all previously initiated requests. More...

int	MPI_Test_cancelled (const MPI_Status status, int flag)

Functions: Persistent communications
int	MPI_Send_init (const void buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request request)
	Creates a persistent communication request for a standard mode send operation, and binds to it all the arguments of a send operation. More...

int	MPI_Send_init_c (const void buf, MPI_Count count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request request)

int	MPI_Rsend_init (const void buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request request)

int	MPI_Rsend_init_c (const void buf, MPI_Count count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request request)

int	MPI_Ssend_init (const void buf, int count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request request)

int	MPI_Ssend_init_c (const void buf, MPI_Count count, MPI_Datatype datatype, int dest, int tag, MPI_Comm comm, MPI_Request request)

int	MPI_Recv_init (void buf, int count, MPI_Datatype datatype, int source, int tag, MPI_Comm comm, MPI_Request request)
	Creates a persistent communication request for a receive operation. More...

int	MPI_Recv_init_c (void buf, MPI_Count count, MPI_Datatype datatype, int source, int tag, MPI_Comm comm, MPI_Request request)

int	MPI_Start (MPI_Request *request)
	Initiates a persistent request. More...

int	MPI_Startall (int count, MPI_Request *array_of_requests)
	Start all communications associated with requests in array_of_requests. More...

int	MPI_Grequest_start (MPI_Grequest_query_function query_fn, MPI_Grequest_free_function free_fn, MPI_Grequest_cancel_function cancel_fn, void extra_state, MPI_Request *request)

int	MPI_Grequest_complete (MPI_Request request)

int	MPI_Status_set_elements (MPI_Status *status, MPI_Datatype datatype, int count)

int	MPI_Status_set_elements_x (MPI_Status *status, MPI_Datatype datatype, MPI_Count count)

int	MPI_Status_set_elements_c (MPI_Status *status, MPI_Datatype datatype, MPI_Count count)

int	MPI_Status_set_cancelled (MPI_Status *status, int flag)

int	MPI_Get_count (MPI_Status status, MPI_Datatype datatype, int count)
	Computes the number of entries received. More...

int	MPI_Get_count_c (MPI_Status status, MPI_Datatype datatype, MPI_Count count)

int	MPI_Get_elements (const MPI_Status status, MPI_Datatype datatype, int count)

int	MPI_Get_elements_c (const MPI_Status status, MPI_Datatype datatype, MPI_Count count)

int	MPI_Get_elements_x (const MPI_Status status, MPI_Datatype datatype, MPI_Count count)

Detailed Description

declarations for MPI requests

Definition in file nm_mpi_req.h.

Function Documentation

◆ MPI_Cancel()

int MPI_Cancel ( MPI_Request * request )

Marks for cancellation a pending, nonblocking communication operation (send or receive).

Parameters

request communication request handle

Returns: MPI status

◆ MPI_Get_count()

int MPI_Get_count	(	MPI_Status *	status,
		MPI_Datatype	datatype,
		int *	count
	)

Computes the number of entries received.

Parameters

status	return status of receive operation
datatype	datatype of each receive buffer entry
count	number of received entries

Returns: MPI status

◆ MPI_Get_count_c()

int MPI_Get_count_c	(	MPI_Status *	status,
		MPI_Datatype	datatype,
		MPI_Count *	count
	)

◆ MPI_Get_elements()

int MPI_Get_elements	(	const MPI_Status *	status,
		MPI_Datatype	datatype,
		int *	count
	)

◆ MPI_Get_elements_c()

int MPI_Get_elements_c	(	const MPI_Status *	status,
		MPI_Datatype	datatype,
		MPI_Count *	count
	)

◆ MPI_Get_elements_x()

int MPI_Get_elements_x	(	const MPI_Status *	status,
		MPI_Datatype	datatype,
		MPI_Count *	count
	)

◆ MPI_Grequest_complete()

int MPI_Grequest_complete ( MPI_Request request )

◆ MPI_Grequest_start()

int MPI_Grequest_start	(	MPI_Grequest_query_function *	query_fn,
		MPI_Grequest_free_function *	free_fn,
		MPI_Grequest_cancel_function *	cancel_fn,
		void *	extra_state,
		MPI_Request *	request
	)

◆ MPI_Recv_init()

int MPI_Recv_init	(	void *	buf,
		int	count,
		MPI_Datatype	datatype,
		int	source,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

Creates a persistent communication request for a receive operation.

Parameters

buf	initial address of receive buffer
count	number of elements received
datatype	type of each element
source	rank of source or MPI_ANY_SOURCE
tag	message tag or MPI_ANY_TAG
comm	communicator
request	communication request handle

Returns: MPI status

◆ MPI_Recv_init_c()

int MPI_Recv_init_c	(	void *	buf,
		MPI_Count	count,
		MPI_Datatype	datatype,
		int	source,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

◆ MPI_Request_free()

int MPI_Request_free ( MPI_Request * request )

Marks the request object for deallocation and set request to MPI_REQUEST_NULL.

An ongoing communication that is associated with the request will be allowed to complete. The request will be deallocated only after its completion.

Parameters

request communication request handle

Returns: MPI status

◆ MPI_Rsend_init()

int MPI_Rsend_init	(	const void *	buf,
		int	count,
		MPI_Datatype	datatype,
		int	dest,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

◆ MPI_Rsend_init_c()

int MPI_Rsend_init_c	(	const void *	buf,
		MPI_Count	count,
		MPI_Datatype	datatype,
		int	dest,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

◆ MPI_Send_init()

int MPI_Send_init	(	const void *	buf,
		int	count,
		MPI_Datatype	datatype,
		int	dest,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

Creates a persistent communication request for a standard mode send operation, and binds to it all the arguments of a send operation.

Parameters

buf	initial address of send buffer
count	number of elements sent
datatype	type of each element
dest	rank of destination
tag	message tag
comm	communicator
request	communication request handle

Returns: MPI status

◆ MPI_Send_init_c()

int MPI_Send_init_c	(	const void *	buf,
		MPI_Count	count,
		MPI_Datatype	datatype,
		int	dest,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

◆ MPI_Ssend_init()

int MPI_Ssend_init	(	const void *	buf,
		int	count,
		MPI_Datatype	datatype,
		int	dest,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

◆ MPI_Ssend_init_c()

int MPI_Ssend_init_c	(	const void *	buf,
		MPI_Count	count,
		MPI_Datatype	datatype,
		int	dest,
		int	tag,
		MPI_Comm	comm,
		MPI_Request *	request
	)

◆ MPI_Start()

int MPI_Start ( MPI_Request * request )

Initiates a persistent request.

The associated request should be inactive. The request becomes active once the call is made. If the request is for a send with ready mode, then a matching receive should be posted before the call is made. The communication buffer should not be accessed after the call, and until the operation completes.

Parameters

request communication request handle

Returns: MPI status

◆ MPI_Startall()

int MPI_Startall	(	int	count,
		MPI_Request *	array_of_requests
	)

Start all communications associated with requests in array_of_requests.

Parameters

count	list length
array_of_requests	array of requests

Returns: MPI status

◆ MPI_Status_set_cancelled()

int MPI_Status_set_cancelled	(	MPI_Status *	status,
		int	flag
	)

◆ MPI_Status_set_elements()

int MPI_Status_set_elements	(	MPI_Status *	status,
		MPI_Datatype	datatype,
		int	count
	)

◆ MPI_Status_set_elements_c()

int MPI_Status_set_elements_c	(	MPI_Status *	status,
		MPI_Datatype	datatype,
		MPI_Count	count
	)

◆ MPI_Status_set_elements_x()

int MPI_Status_set_elements_x	(	MPI_Status *	status,
		MPI_Datatype	datatype,
		MPI_Count	count
	)

◆ MPI_Test()

int MPI_Test	(	MPI_Request *	request,
		int *	flag,
		MPI_Status *	status
	)

Returns flag = true if the operation identified by request is complete.

Parameters

request	communication request handle
flag	true if operation completed
status	status object

Returns: MPI status

◆ MPI_Test_cancelled()

int MPI_Test_cancelled	(	const MPI_Status *	status,
		int *	flag
	)

◆ MPI_Testall()

int MPI_Testall	(	int	count,
		MPI_Request *	array_of_requests,
		int *	flag,
		MPI_Status *	statuses
	)

Tests for the completion of all previously initiated requests.

Parameters

count	list length
array_of_requests	array of request handles
flag	True if all requests have completed; false otherwise (logical)
statuses	array of statuses of the completed operations

Returns: MPI status

◆ MPI_Testany()

int MPI_Testany	(	int	count,
		MPI_Request *	array_of_requests,
		int *	index,
		int *	flag,
		MPI_Status *	status
	)

Tests for completion of one communication operation associated with requests in the array.

Parameters

count	list length
array_of_requests	array of request handles
index	index of request handle that completed
flag	true if one has completed
status	status object

Returns: MPI status

◆ MPI_Testsome()

int MPI_Testsome	(	int	count,
		MPI_Request *	array_of_requests,
		int *	outcount,
		int *	indices,
		MPI_Status *	statuses
	)

Tests for completion of several communication operations associated with requests in the array.

Parameters

count	list length
array_of_requests	array of request handles
outcount	is the number of request handle completed
indices	are the indices or request handle completed in array_of_requests
statuses	array of statuses of the completed operations

Returns: MPI status

◆ MPI_Wait()

int MPI_Wait	(	MPI_Request *	request,
		MPI_Status *	status
	)

Returns when the operation identified by request is complete.

Parameters

request	request
status	status object

Returns: MPI status

◆ MPI_Waitall()

int MPI_Waitall	(	int	count,
		MPI_Request *	array_of_requests,
		MPI_Status *	array_of_statuses
	)

Returns when all the operations identified by requests are complete.

Parameters

count	lists length
array_of_requests	array of requests
array_of_statuses	array of status objects

Returns: MPI status

◆ MPI_Waitany()

int MPI_Waitany	(	int	count,
		MPI_Request *	array_of_requests,
		int *	index,
		MPI_Status *	status
	)

Blocks until one of the operations associated with the active requests in the array has completed.

If more then one operation is enabled and can terminate, one is arbitrarily chosen. Returns in index the index of that request in the array and returns in status the status of the completing communication. If the request was allocated by a nonblocking communication operation, then it is deallocated and the request handle is set to MPI_REQUEST_NULL.

Parameters

count	list length
array_of_requests	array of requests
index	index of handle for operation that completed
status	status object

Returns: MPI status

◆ MPI_Waitsome()

int MPI_Waitsome	(	int	incount,
		MPI_Request *	array_of_requests,
		int *	outcount,
		int *	array_of_indices,
		MPI_Status *	array_of_statuses
	)

Documentation

Functions

Detailed Description

Function Documentation

◆ MPI_Cancel()

◆ MPI_Get_count()

◆ MPI_Get_count_c()

◆ MPI_Get_elements()

◆ MPI_Get_elements_c()

◆ MPI_Get_elements_x()

◆ MPI_Grequest_complete()

◆ MPI_Grequest_start()

◆ MPI_Recv_init()

◆ MPI_Recv_init_c()

◆ MPI_Request_free()

◆ MPI_Rsend_init()

◆ MPI_Rsend_init_c()

◆ MPI_Send_init()

◆ MPI_Send_init_c()

◆ MPI_Ssend_init()

◆ MPI_Ssend_init_c()

◆ MPI_Start()

◆ MPI_Startall()

◆ MPI_Status_set_cancelled()

◆ MPI_Status_set_elements()

◆ MPI_Status_set_elements_c()

◆ MPI_Status_set_elements_x()

◆ MPI_Test()

◆ MPI_Test_cancelled()

◆ MPI_Testall()

◆ MPI_Testany()

◆ MPI_Testsome()

◆ MPI_Wait()

◆ MPI_Waitall()

◆ MPI_Waitany()

◆ MPI_Waitsome()