8.1 Introduction

　

8.2 Generalized Request

　

이 MPI-2 extension의 목적은 사용자가 새로운 nonblocking operations를 정의하도록 하는데 있다. 이런 nonblocking operation은 generalized request에 의해 표현된다. nonblocking operation의 기본적인 특성은 이 operation의 완성으로의 진행은 asynchronous하게 발생한다는 것이다.

regular request에 대해서는 request에 관련된 operation이 MPI에 의해 수행되고 generalized request에 대해서는 어플리케이션에 의해 수행된다.

　

MPI_GREQUEST_START(query_fn, free_fn, cancel_fn, extra_state, request)

[IN query_fn] request status가 요청되었을때 발생하는callback function

[IN free_fn] request가 free되었을 때 발생하는 callback function

[IN cancel_fn] request가 cancel되었을 때 발생하는 callback function

[IN extra_state] extra state

[OUT request] generalized request(handle)

　

MPI_GREQUEST_COMPLETE(request)

[INOUT request] generalized request(handle)

이 호출은 MPI에게 generalized request에 의한 operation이 종료되었다는 것을 알려준다.

　

8.3 Status와 관련된 정보

　

MPI-1에서 MPI_{TEST|WAIT}{ANY|SOME|ALL}의 호출은 request에 관련된 정보를 return한다.

MPI-2에서 MPI_{TEST|WAIT}{ANY|SOME|ALL}의 호출은 status object의 어떤 field도 수정할 수 있다.

　

MPI_STATUS_SET_ELEMENTS(status, datatype, count)

[INOUT status] status to asociate count with(Status)

[IN datatype] datatype associated with count(handle)

[IN count] number of element to associate with status(integer)

이 호출은 MPI_GET_ELEMENTS에 대한 호출이 count를 return하도록 status의 불특정한 부분을 수정한다.

　

MPI_STATUS_SET_CANCELLED(status, flag)

[INPUT status] status to associate cancel flag with (Status)

[IN flag] if true indicates request was cancelled(logical)

flag이 true로 설정되었다면, 이어지는 MPI_TEST_CANCELLED(status, flag)에 대한 호출 또한 flag=true를 return할 것이다.

　

8.4 Naming Objects

　

error reporting, debugging 또는 profiling을 위하여 사용자가 MPI communicator와 함꼐 프린트할 수 있는 식별자를 사용할 수 있게 하는 것이 유용할 때가 있다. 이것은 아래의 두 function을 이용하여 달성된다.

　

MPI_COMM_SETNAME(comm, comm_name)

[INOUT comm] communicator whose identifier is to be set (handle)

[IN comm_name] the character string which is remembered as the name (string)

　

MPI_COMM_GET_NAME (comm, comm_name, resultlen)

[IN comm] communicator whose name is to be returned (handle)

[OUT comm_name] the name previously stored on the communicator, or an empty string if no such name exists (string)

[OUT resultlen] length of returned name (integer)

　

8.5 Erro Classes, Erro Codes, and Error Handler

　

Error에 관한 function은 다음과 같다.

　

  1. 새로운 error를 추가

  2. MPI_ERROR_CLASS가 동작하도록 error code를 error class와 결합시킨다.

  3. MPI_ERROR_STRING이 동작하도록 string을 error code와 결합시킨다.

  4. communicator, window, 또는 object와 결합된 error handler를 발생시킨다.

　

　

MPI_ADD_ERROR_CLASS(erroclass)

[OUT errorclass] value for the new error class(integer)

새로운 error class를 생성하고 값을 return

　

MPI_ADD_ERROR_CODE(errorclass, errorcode)

[IN errorclass] error class (integer)

[OUT errorcode] new error code to associated with errorclass(integer)

errorclass와 관련된 error code를 생성하고 errorcode안의 값을 return한다.

　

MPI_ADD_ERROR_STRING(errorcode, string)

[IN errorcode] error code or class(integer)

[IN string] text corresponding to errorcode(string)

error string과 error code나 class를 관련시킨다.

　

MPI_COMM_CALL_ERRHANDLER(comm, errorcode)

[IN comm] communicator with error handler(handle)

[IN errorcode] error code(integer)

공급된 error code와 함께 communicator에 할당된 error handler를 발생시킨다.

　

8.6 Decoding a Datatype

　

MPI-1에서는 datatype에 들어간 layout 정보는 datatype으로부터 decode될 수 없었다.

다음의 두 function은 datatype을 decode해서 그들의 초기 정의에 사용된 calling sequence를 재발생시킬 수 있다.

　

MPI_TYPE_GET_ENVELOPE(datatype, num_integers, num_addresses, num_ datatypes, combiner)

[IN datatype] datatype to access(handle)

[OUT num_integers] number of integers used in the call constructing combiner(nonnegative integer)

[OUT num_addresses] number of input addresses used in the call constructing combiner(nonnegative integer)

[OUT num_datatypes] number of input datatypes used in the call constructing combiner(nonnegative integer)

[OUT combiner] combiner(state)

datatype을 생성하는 호출에 사용된 input arguments의 수와 type에 관한 정보를 return한다.

　

MPI_TYPE_GET_CONTENTS(datatype, max_integers, max_addresses, max _datatyes, array_of_integers, array_of_addresses, array_of_datatypes)

[IN datatype] datatype to access(handle)

[IN max_integers] number of elements in array_of_integers(non-negative integers)

[IN max_addresses] number of elements in array_of_ addresses (non-negative integers)

[IN max_datatypes] number of elements in array_of_ datatypes (non-negative integers)

[OUT array_of_integers] contains integer arguments used in constructing datatype(array of integers)

[OUT array_of_ addresses] contains address arguments used in constructing datatype(array of integers)

[OUT array_of_ datatypes] contains datatype arguments used in constructing datatype(array of integers)

max_integers, max_addresses, max_datatypes의 값들은 상대적으로 num_integers, num_addresses, num_datatypes에서 return된 값들 이상이어야 한다.

　

8.7 MPI and Threads

　

이 장에서는 MPI call과 threads간의 상호작용을 정의하고 thread에 적합한 MPI implementation과 thread 환경을 초기화하기위해 사용될수 있는 정의된 함수를 위한 요구사항을 나열한다.

　

8.7.1 General

　

Thread에 적합한 implementation에서 MPI process는 multi-thread process일수도 있다. 각각의 thread는 MPI call을 할 수 있지만 thread는 각각 address할 수 없다.

　

8.7.2 Clarifications

　

Initialization, Completion, MPI_FINALIZE의 호출 등은 같은 thread에서 발생해야 하는데, 이것을 main thread라 한다. 그 호출은 모든 프로세스 thread가 MPI 호출을 끝내고, 미결된 통신이나 I/O operation이 없을 때 발생할 수 있다.

　

8.7.3 Initialization

　

아래의 function은 MPI_INIT대신에 MPI와, MPI thread 환경을 초기화할 때 사용된다.

　

MPI_INIT_THREAD(required, provided)

[IN required] desired level of thread support(integer)

[OUT provided] provided level of thread support(integer)

　

8.8 New Attribute Caching Functions

　

MPI-2에서는 windows와 datatypes에서의 caching이 추가된다.

caching은 모든 handler 또는 하나의 handler에 선택적으로 허용될 수 있다.

　

8.8.1 Communicators

　

새로운 function들은 다음과 같다.

　

MPI_COMM_CREATE_KEYVAL(comm_copy_attr_fn, comm_delete_attr_fn, comm_keyval, extra_state)

[ IN comm_copy_attr_fn] copy callback function for comm_keyval (function)

[ IN comm_delete_attr_fn] delete callback function for comm_keyval (function)

[ OUT comm_keyval] key value for future access (integer)

[ IN extra_state] extra state for callback functions

　

8.8.2 Windows

　

새로운 function들은 다음과 같다.

　

MPI_WIN_CREATE_KEYVAL(win_copy_attr_fn, win_delete_attr_fn, win_keyval, extra_state)

[ IN win_copy_attr_fn] copy callback function for win_keyval (function)

[ IN win_delete_attr_fn] delete callback function for win_keyval (function)

[ OUT win_keyval] key value for future access (integer)

[ IN extra_state] extra state for callback functions

　

8.8.3 Datatypes

　

새로운 function들은 다음과 같다.

　

MPI_TYPE_CREATE_KEYVAL(type_copy_attr_fn, type_delete_attr_fn, type_keyval, extra_state)

[ IN type_copy_attr_fn] copy callback function for type_keyval (function)

[ IN type_delete_attr_fn] delete callback function for type_keyval (function)

[ OUT type_keyval] key value for future access (integer)

[ IN extra_state] extra state for callback functions

　

8.9 Duplicating a Datatype

　

MPI_TYPE_DUP(type, newtype)

[ IN type] datatype (handle)

[ OUT newtype] copy of type (handle)

MPI_TYPE_DUP는 new type constructor로서 key 값과 관련된 존재하는 type을 복사한다.