Просмтор этого файла доступен только зарегистрированным пользователям. Но у нас супер быстрая регистрация: достаточно только электронной почты!

Текст из файла (страница 2)

void dvm_FreeStruct (void *StructPtr);

The macrodefinition returns to the free memory the memory block, specified by StructPtr pointer, and assigns NULL to StructPtr pointer. The macrodefinition can be invoked with NULL value of StructPtr pointer.

3Requesting program execution time in the form, independent from hardware and software environment

double dvm_time (void);

The function returns program execution time in seconds. Note that a sense of execution time notion can be different for different environments.

4Requesting internal numbers of functionally provided processors

A user program startup on the processor system requires specifying (as startup parameters) the following characteristics of the processor system as multidimensional array: the processor system rank and sizes of all its dimensions. Let the rank of the processor system be n, and size of k-th dimension be PSSize_k (1  k  n). Then when Run-Time System is initialized an internal number ProcNumber_int will be assigned to the each processor:

where:

So the internal number is the linear index of the processor in index space of the processor system.

Each processor has also external number ProcNumber_ext (a processor number in hardware-software environment, where Run-Time System operates). When Run-Time System is initialized, it requests the external number using environment-dependent tools.

In interprocessor exchanges a processor identifier ProcIdent is used as the processor address. The correspondence

ProcNumber_int  ProcIdent

is defined by Message Passing System and returned to Run-Time System when it is initialized.

There are three functionally special processors: main processor, input/output processor and central processor among processors, assigned to a task.

The main processor is the first processor, where the parallel program was initialized (a subtask, executed on the processor, is considered as initiator of all other subtasks). The main processor has zero internal number.

Input/output processor is intended to deal with the file system directly and its internal number is zero.

The central processor computes the reduction functions and is defined by an index vector ([PSSize₁/2], ... ,[PSSize_n/2]).

int rtl_GetCurrentProc(void);

The function returns internal number of the current processor.

int rtl_GetMasterProc(void);

The function returns internal number of the main processor.

int rtl_GetIOProc(void);

The function returns internal number of the input/output processor.

int rtl_GetCentralProc(void);

The function returns internal number of the central processor.

5Message passing tools, independent from base system of message passing

A set of presented below functions serves as interface between Run-Time System itself and used message passing system (MPI, PVM and so on). This set is not belongs to the tools, provided by Run-Time System for user program. Nevertheless, minimal environment-independent set of message passing functions may be useful for test and environment-experimental programs, accompanied with Run-Time System.

The internal processor number is used as processor address in the functions, considered below. This number is substituted for processor identifier (see section 4) when the functions of message passing system are called. It is assumed that the logic of main message passing schemes (synchronous, asynchronous and “NO WAIT scheme) is known.

Memory area for sent or received message should be allocate dynamically by the functions, considered in section 2.

5.1Synchronous message exchange

5.1.1Synchronous sending

The function returns non-negative value in the case of success and negative value otherwise.

5.1.2Synchronous receiving

The function returns non-negative value in the case of success and negative value otherwise.

5.2Asynchronous message exchange

5.2.1Asynchronous sending

The function returns non-negative value in the case of success and negative value otherwise.

5.2.2Asynchronous receiving

The function returns non-negative value in the case of success and negative value otherwise.

5.3Message exchange in "NO-WAIT" mode

5.3.1Sending in "NO-WAIT" mode

The function returns non-negative value in the case of success and negative value otherwise.

5.3.2Receiving in "NO-WAIT" mode

The function returns non-negative value in the case of success and negative value otherwise.

5.3.3Waiting for sending or receiving completion

void rtl_Waitrequest(RTL_Request *ReqPtr);

ReqPtr  structure-flag, from which state "request has been performed" is awaited.

5.3.4Requesting sending or receiving completion

int rtl_Testrequest(RTL_Request *ReqPtr);

ReqPtr  structure-flag, from which state "request has been performed" is awaited.

The following values are returned:

5.4Passing message from specified processor to all other processors (broadcast passing)

Характеристики

Список файлов учебной работы