1 Функции и макроопределения общего назначения

1.1 Макроопределения выполнения некоторых математических операций

int dvm_mod(Op, D);

Макроопределение возвращает нулевое значение, если остаток от деления аргумента Op на аргумент D равен нулю, и единичное в противном случае. Аргументы Op и D должны иметь целый тип.

<TypeOfOp> dvm_abs(Op);

Макроопределение возвращает абсолютное значение аргумента Op. Аргумент Op может иметь целый или плавающий тип. Тип возвращаемого значения совпадает с типом аргумента Op.

int dvm_sign(Op);

Макроопределение возвращает 1, если Op > 0, и -1, если Op <= 0. Аргумент Op может иметь целый или плавающий тип.

<TypeOfOp> dvm_min(Op1, Op2);

Макроопределение возвращает минимальное из значений аргументов Op1 и Op2. Каждый из операндов Op1 и Op2 может иметь целый или плавающий тип. Тип возвращаемого значения определяется принятым в языке C правилам преобразования по умолчанию, примененным к операндам Op1 и Op2.

<TypeOfOp> dvm_max(Op1, Op2);

Макроопределение возвращает максимальное из значений аргументов Op1 и Op2. Каждый из операндов Op1 и Op2 может иметь целый или плавающий тип. Тип возвращаемого значения определяется принятым в языке C правилам преобразования по умолчанию, примененным к операндам Op1 и Op2.

1.2 Копирование массивов

1.3 Вывод верхнего уровня с префиксом в виде номера текущего процессора

Функции аналогичны функциям printf и fprintf библиотеки языка C, но выводу заданной информации предшествует вывод номера текущего процессора в виде:

ProcNumber_int (ProcNumber_ext) ,

где:

Вопрос о номерах процессоров решающего поля рассмотрен в п.4.

Функции аналогичны рассмотренным выше функциям rtl_printf и rtl_fprintf, но вывод осуществляется лишь в том случае, если внутренний номер текущего процессора совпадает с параметром ProcNumber.

Замечание. Функции rtl_printf и rtl_mprintf предназначены для вывода информационных сообщений системы поддержки, которые стандартно направлены в поток stdout (см.п.8).

2 Функции и макроопределения динамического распределения памяти

Рассматриваемые ниже функции и макроопределения отличаются от стандартных функций библиотеки языка C тем, что, во-первых, корректность осуществляемых с их помощью запросов и возвратов памяти контролируется системой поддержки и, во-вторых, выделяемые блоки памяти могут окаймляться слева и справа избыточными частями, расписанными определённым кодом. Последняя особенность предлагаемых функций и макроопределений дает возможность системе поддержки в процессе своего функционирования контролировать содержимое избыточных частей выделенных блоков, что облегчает нахождение ошибок, влекущих незапланированные записи в память.

void *dvm_getmem(unsigned long Size);

Функция выделяет блок памяти размером Size байтов и возвращает указатель на него. Если блок памяти заданного размера выделен быть не может, то выполнение пользовательской программы или системы поддержки завершается с выдачей соответствующей диагностики с помощью функции eprintf (см.п.7).

void *dvm_getmemnoerr(unsigned long Size);

Функция аналогична рассмотренной выше функции dvm_getmem, но при отсутствии блока памяти требуемого размера возвращает NULL.

void *dvm_getclearmem(unsigned long Size);

Функция аналогична рассмотренной выше функции dvm_getmem, но выделяемый блок памяти расписывается нулевым кодом.

Функция возвращает в свободную память блок памяти, определяемый указателем *Ptr, выделяет новый блок памяти размером NewSize байтов и присваивает его адрес указателю *Ptr. Содержимое старого блока будет сохранено в новом блоке (насколько это позволяет размер NewSize). Если новый блок памяти требуемого размера выделен быть не может, то выполнение задачи пользователя или системы поддержки завершается.

При нулевом значении параметра NewSize выделение нового блока памяти не производится, а указателю *Ptr присваивается значение NULL.

Функция аналогична рассмотренной выше функции dvm_realloc, но при отсутствии блока памяти требуемого размера возвращает NULL.

void dvm_freemem(void **Ptr);

Функция возвращает в свободную память блок памяти, определённый указателем *Ptr, и устанавливает значение этого указателя равным NULL. Допустимо обращение к функции с равным NULL значением указателя *Ptr.

Макроопределение выделяет блок памяти, состоящий из Size элементов типа Type, и присваивает его адрес указателю ArrayPtr. Если блок памяти требуемого размера выделен быть не может, то выполнение программы пользователя или системы поддержки будет прекращено.

Макроопределение возвращает в свободную память блок памяти, определённый указателем ArrayPtr, выделяет новый блок памяти из NewSize элементов типа Type и присваивает его адрес указателю ArrayPtr. Содержимое старого блока будет сохранено в новом блоке (насколько это позволяет размер NewSize). Если новый блок памяти требуемого размера выделен быть не может, то выполнение пользовательской задачи или системы поддержки будет завершено.

void dvm_FreeArray(void *ArrayPtr);

Макроопределение возвращает в свободную память блок памяти, заданный указателем ArrayPtr, и устанавливает значение этого указателя равным NULL. Допустимо обращение к макроопределению со значением указателя ArrayPtr равным NULL.

Макроопределение выделяет блок памяти размера sizeof(Type) байтов и присваивает его адрес указателю StructPtr. Если блок памяти требуемого размера выделен быть не может, то выполнение задачи пользователя или системы поддержки будет прекращено.

void dvm_FreeStruct(void *StructPtr);

Макроопределение возвращает в свободную память блок памяти, заданный указателем StructPtr, и устанавливает значение этого указателя равным NULL. Допустимо обращение к макроопределению со значением указателя StructPtr равным NULL.

3 Опрос времени выполнения программы в независимой от аппаратурно-программной среды форме

double dvm_time(void);

Функция возвращает время выполнения программы в секундах. Отметим, что содержание понятия времени выполнения может быть разным для различных сред.

4 Опрос внутренних номеров функционально выделенных процессоров

Запуск программы пользователя для выполнения на многопроцессорной системе требует задания (в качестве параметров запуска) характеристик многопроцессорной системы как многомерного массива: размерности и размеров по каждому измерению. Пусть размерность многопроцессорной системы задана равной n, а размер по измерению k - равным PSSize_k (1 <= k <= n). Тогда при инициализации системы поддержки каждому процессору будет присвоен внутренний номер ProcNumber_int:

где I_{k -} значение индекса процессора по измерению k индексного пространства многопроцессорной системы (0 <= I_k <= PSSize_k -1).

То есть, внутренний номер - это линейный индекс процессора в индексном пространстве многопроцессорной системы.

Каждый процессор имеет также внешний номер ProcNumber_ext (номер процессора в аппаратурно-программной среде, в которой функционирует система поддержки). Внешний номер опрашивается системой поддержки при ее инициализации с помощью средозависимых средств.

При межпроцессорных обменах в качестве адреса процессора используется его идентификатор ProcIdent. Соответствие

ProcNumber_int => ProcIdent

возвращается системе поддержки системой передачи сообщений (Message Passing System) при её инициализации.

Среди процессоров выделенного задаче решающего поля функционально выделены три: главный процессор, процессор ввода/вывода и центральный процессор задачи (или просто центральный процессор).

Главный процессор - это первый процессор, на котором была инициализирована параллельная программа (выполняющаяся на нём подзадача рассматривается как инициализатор всех остальных подзадач). Главный процессор имеет нулевой внутренний номер.

Процессор ввода/вывода предназначен для непосредственного общения с файловой системой и имеет нулевой внутренний номер.

Центральный процессор осуществляет вычисление редукционных функций и определяется индексным вектором ([PSSize₁ /2] , ... , [PSSize_n /2]).

int rtl_GetCurrentProc(void);

Функция возвращает внутренний номер текущего процессора.

int rtl_GetMasterProc(void);

Функция возвращает внутренний номер главного процессора.

int rtl_GetIOProc(void);

Функция возвращает внутренний номер процессора ввода/вывода.

int rtl_GetCentralProc(void);

Функция возвращает внутренний номер центрального процессора.

5 Средства передачи сообщений, независимые от базовой системы передачи сообщений

Совокупность представленных ниже функций является интерфейсным "срезом" между собственно системой поддержки и используемой ею системой передачи сообщений (MPI, PVM и т.д.) и выходит за рамки средств, предоставляемых системой поддержки программе пользователя. Тем не менее, минимальный средонезависимый набор функций передачи сообщений может оказаться полезным для тестовых и экспериментирующих со средой программ, сопровождающих систему поддержки.

В качестве адреса процессора в рассматриваемых ниже функциях используется внутренний номер процессора, который при непосредственном обращении к функциям системы передачи сообщений заменяется на идентификатор процессора (см.п.4). Логика основных схем передачи сообщений (синхронная, асинхронная и схема "NO WAIT") предполагается известной.

Область памяти, предназначенная для передаваемого или принимаемого сообщения, должна быть запрошена динамически с помощью рассмотренных в п. 2 функций.

5.1 Синхронный обмен сообщениями

5.1.1 Синхронная передача

Возвращается неотрицательное значение при успешном выполнении функции и отрицательное - в противном случае.

5.1.2 Синхронный прием

Возвращается неотрицательное значение при успешном выполнении функции и отрицательное - в противном случае.

5.2 Асинхронный обмен сообщениями

5.2.1 Асинхронная передача

Возвращается неотрицательное значение при успешном выполнении функции и отрицательное - в противном случае.

5.2.2 Асинхронный прием

Возвращается неотрицательное значение при успешном выполнении функции и отрицательное - в противном случае.

5.3 Обмен сообщениями в режиме "NO WAIT"

5.3.1 Передача в режиме "NO WAIT"

Возвращается неотрицательное значение при успешном выполнении функции и отрицательное - в противном случае.

5.3.2 Прием в режиме "NO WAIT"

Возвращается неотрицательное значение при успешном выполнении функции и отрицательное - в противном случае.

5.3.3 Ожидание завершения передачи или приема

void rtl_Waitrequest(RTL_Request *ReqPtr);

5.3.4 Опрос завершения передачи или приема

int rtl_Testrequest(RTL_Request *ReqPtr);

Возвращается значение:

5.4 Передача сообщения от заданного процессора всем остальным (широковещательная передача)

Функция осуществляет передачу, если внутренний номер текущего процессора равен SenderProcNum, и приём - в противном случае.

Все процессоры системы, заданной параметром PSRefPtr, должны принадлежать текущей процессорной системе. Равное NULL значение указателя PSRefPtr или нулевое значение ссылки *PSRefPtr задают текущую процессорную систему.

Процессор с номером SenderProcNum не обязан входить в состав процессорной системы, заданной ссылкой *PSRefPtr, но должен принадлежать текущей процессорной системе.

6 Синхронизация программ, выполняющихся на разных процессорах

long bsynch_(void);

Выполнение функции заключается в том, что центральный процессор (см.п.4) принимает синхросообщения от всех остальных процессоров, а затем рассылает им синхросообщения-ответы. Любой другой процессор передает синхросообщение центральному процессору, после чего принимает от него синхросообщение-ответ. Синхросообщение - это слово (integer), содержимое которого несущественно.

Функция возвращает нулевое значение.

long tsynch_(void);

Функция tsynch_, как и функция bsynch_, выполняет барьерную синхронизацию процессоров текущей процессорной системы, но дополнительно производит выравнивание времен процессоров. Под выравниванием времен понимаются такие действия системы поддержки, в результате которых функция dvm_time (см.п.3) в один и тот же момент астрономического времени будет возвращать на всех процессорах одно и то же время - время, возвращаемое функцией dvm_time на центральном процессоре задачи до выполнения функции tsynch_ .

Выравнивание времен осуществляется следующим образом. Пусть центральный процессор в момент времени t₁ (по своему датчику времени) посылает сообщение процессору P, находящемуся в состоянии приёма этого сообщения. Процессор P, получив сообщение от центрального, посылает ему время приёма этого сообщения T (по своему датчику времени). Центральный процессор, отослав сообщение процессору P, переходит к приёму от него сообщения со временем T и принимает его в момент времени t₂ по своему датчику времени. После этого центральный процессор отсылает процессору P время (t₁+t₂)/2 - T , которое при выполнении им функции dvm_time всегда будет добавляться к показанию его датчика времени.

Такая операция осуществляется центральным процессором со всеми остальными процессорами. Чтобы избежать случайных помех, операция выравнивания времен повторяется несколько раз, и для каждого процессора в качестве результата принимается та величина (t₁+t₂)/2 - T, для которой время передачи сообщения, равное (t₁-t₂)/2, минимально.

Функция возвращает нулевое значение.

7 Трассировка программы пользователя и системы поддержки

7.1 Общие сведения о накоплении информации трассировки

Будем называть внутренним событием (или просто событием) выполнение определённой точки или участка пользовательской программы или системы поддержки при определённых условиях. Системная трассировка является накоплением информации о происходящих событиях в их временной последовательности.

Событиями являются обращения ко всем функциям системы поддержки, доступным программе пользователя. Кроме того, прохождение некоторых внутренних участков системы поддержки и обращения к части ее внутренних функций также являются событиями. Примером трассируемых внутренних функций могут служить функции доступа к коммуникационным библиотекам. Трассируемое обращение к функции влечет трассировку и возврата из неё.

Полный список событий трассировки содержится в файле events.def исходных текстов системы поддержки, в котором имени каждого события сопоставлен его номер. Событие обращения к функции имеет имя call_<имя функции>, а событие возврата из неё - имя ret_<имя функции>.

Трассировка каждого события может быть включена и выключена по его номеру.

Накапливаемая при трассировке информация содержит также все информационные сообщения системы поддержки и все сообщения об обнаруженных ею ошибках (см. п.8).

Накопление трассировочной информации система поддержки осуществляет с помощью функций, рассмотренных в п.7.3. Информация, выводимая этими функциями в текстовом виде, может поступать в три независимо включаемых (открываемых) и выключаемых (закрываемых) потока трассировки:

• поток информационных сообщений системы поддержки (трассировка на "видеомонитор", стандартно - это поток stdout);
• буфер оперативной памяти;
• файл.

Трассировка в поток информационных сообщений осуществляется согласно общим правилам управления выводом информационных сообщений (см.п.8). Информация, поступающая в этот поток, не содержит информационных сообщений и сообщений об ошибках системы поддержки.

При трассировке в буфер оперативной памяти информация накапливается в буфере каждого процессора до завершения выполнения программы, а затем выгружается в файл (свой для каждого процессора). Инициализация буферов трассировки производится при инициализации системы поддержки.

Трассировка в буфер предусматривает два варианта. В первом исчерпание размера буфера влечет останов трассировки (вариант сохранения начала трассировки). Второй вариант обеспечивает сохранение последней информации за счет уничтожения наиболее старой (вариант трассировки "по кольцу").

Трассировка в файл осуществляется выводом информации непосредственно в свой для каждого процессора файл по мере ее поступления. Файлы для непосредственного вывода трассировки открываются при инициализации системы поддержки и закрываются при завершении выполнения программы.

Все файлы с накопленной трассировкой система поддержки помещает в одну директорию (как при трассировке в буфер, так и при трассировке непосредственно в файлы). Имя этой директории, а также расширения файлов для каждого потока задаются в файле параметров systrace.* (см. п.7.2.2). Имена файлов с трассировкой имет вид <внутренний номер процессора>_<внешний номер процессора>.

Состав накапливаемой при трассировке информации определяется режимом трассировки. При кратком режиме выводится:

• имя события;
• время, прошедшее с предыдущего события;
• имя файла пользовательской программы и номер строки в нём, определяющие точку произошедшего события в программе.

При подробном режиме трассировки сохраняемая информация расширяется и зависит от типа события. Если событием является обращение к функции, то выводятся ее входные параметры. При возврате из функции выводятся ее выходные параметры. Для каждого события может быть задан подробный режим трассировки вне зависимости от общего режима.

Замечание. Системная трассировка функционирует только при ненулевом значении параметра Is_DVM_TRACE, содержащегося в файлах systrace.* (см. п. 7.2.1). Часть функций, тем не менее, при этом не трассируется. К таким функциям относятся функции, требующие высокой эффективности выполнения из-за предполагаемой большой частоты обращений к ним (например, функция tstelm_ проверки принадлежности заданного элемента распределённого массива его локальной части). Включение трассировки такого рода функций осуществляется заданием ненулевого значения параметра Is_ALL_TRACE (файлы systrace.*). Кроме того, для трассировки функций обращения к DVM-отладчику необходимо задание ненулевого значения параметра Is_DEB_TRACE, а для трассировки функций обращения к подсистеме сбора инфомации для анализа производительности – ненулевого значения параметра Is_STAT_TRACE (см. п. 7.2.1).

7.2 Управление накоплением трассировки с помощью файлов параметров

Управление режимами трассировки и составом трассируемых событий осуществляется с помощью параметров, содержащихся в файлах systrace.* и trcevent.* . Рассмотрим основные из них. По умолчанию считается, что параметр содержится в файлах systrace.* .

7.2.1 Включение и выключение трассировки

• Is_DVM_TRACE - ненулевое значение этого параметра является общим признаком включенной трассировки.
• Is_ALL_TRACE – признак трассировки всех функций системы поддержки (кроме функций обращения к DVM-отладчику и подсистеме сбора статистики).
• Is_DEB_TRACE – признак трассировки функций обращения к DVM-отладчику.
• Is_STAT_TRACE – признак трассировки функций обращения к подсистеме сбора информации для анализатора производительности.
• TraceProcList - список внутренних номеров процессоров с включенной трассировкой. При общем включении трассировки она функционирует только на тех процессорах, которые заданы в этом списке. Трассировка на главном процессоре (см. п. 4) накапливается всегда, вне зависимости от наличия его номера (нулевого) в списке TraceProcList. Признаком конца списка TraceProcList является номер, равный -1.
• IsTraceProcList - признак включённого списка TraceProcList. При нулевом значении этого параметра трассировка накапливается на всех процессорах.
• IsEvent[<номер события>] - равное 1 или 2 значение этого параметра является признаком включённой трассировки события с номером <номер события>. Значение 2 задает трассировку заданного события в расширенном режиме вне зависимости от наличия общего режима расширенной трассировки. Нулевое значение параметра выключает трассировку заданного события. Параметр содержится в файлах trcevent.* . Стандартно (т. е. в базовых наборах параметров) трассировка всех событий включена, а трассировка событий с номерами 0, 1, 2 и 3 - включена в расширенном режиме.
• DisableTraceEvents - список номеров событий (через запятую), трассировка которых выключена. Список DisableTraceEvents отменяет трассировку заданных в нём событий, включённую ранее параметром IsEvent. Признаком конца списка DisableTraceEvents является номер события, равный -1. Отмена трассировки событий с номерами 0, 1, 2 и 3 не допускается.
• IsDisableTraceEvents - признак включённого списка DisableTraceEvents. При нулевом значении этого параметра отмена трассировки событий не производится.
• BlockTrace - признак отложенного включения трассировки. При общем включении трассировки накопление начинается только по специальному указанию, осуществляемому с помощью функции void tron(void). Включенная трассировка может быть выключена функцией void troff(void) (а затем снова включена и т. д.).

7.2.2 Задание открытых (включенных) потоков трассировки

• TracePath - имя директории, в которую помещаются файлы с трассировкой (как при трассировке в буфер, так и при трассировке непосредственно в файл). Если задается не пустое имя директории, то оно должно заканчиваться символом "\" или "/".
• ScreenTrace - ненулевое значение этого параметра означает вывод трассировки в поток информационных сообщений (признак вывода трассировки на "видеомонитор"). Трассировка, выводимая в поток информационных сообщений, не содержит информационных сообщений и сообщений об ошибках системы поддержки.
• BufferTrace - признак накопления трассировки в буфер оперативной памяти.
• TraceBufLength - длина буфера трассировки в байтах.
• TraceBufferExt - расширение файлов с трассировкой при трассировке в буфер.
• FileTrace - признак накопления трассировки непосредственно в файлах.
• FatTraceNoOpen - признак завершения работы при неудачном открытии файла для непосредственного накопления трассировки. При нулевом значении этого параметра неудачное открытие файла будет отмечено предупреждением.
• TraceFileExt - расширение файлов с трассировкой при трассировке непосредственно в файлы.

7.2.3 Задание режимов трассировки

• DelSysTrace – признак уничтожения "старых" (оставшихся от предыдущего запуска) файлов с трассировкой при инициализации системы поддержки.
• FullTrace - общий признак расширенного режима трассировки.
• FullTraceEvents - список номеров событий (через запятую), трассируемых в расширенном режиме (вне зависимости от общего признака расширенного режима трассироки, задаваемого параметром FullTrace). Признаком конца списка FullTraceEvents является номер события, равный -1. Список FullTraceEvents изменяет режим трассировки заданных в нём событий, но не включает ранее отменённую их трассировку.
• IsFullTraceEvents - признак включённого списка FullTraceEvents. При нулевом значении этого параметра изменение режима трассировки событий, заданных в списке FullTraceEvents, не производится.
• MaxTraceLevel - общая максимальная трассируемая глубина обращений к функциям. Нулевое значение этого параметра означает трассировку функций, непосредственно вызываемых программой пользователя.
• MaxEventLevel[<номер события>] - максимальная трассируемая глубина обращений к функциям для события с номером <номер события>. Данный параметр имеет приоритет над параметром MaxTraceLevel. Параметр содержится в файлах trcevent.*
• FullBufferStop - признак останова трассировки при исчерпании буфера. Нулевое значение этого параметра устанавливает сохранение последней информации при исчерпании буфера путем замещения ею наиболее старой информации.
• BufferTraceUnLoad – признак выгрузки в файлы накопленной в буферах трассировки перед завершением выполнения программы. При нулевом значении этого параметра система поддержки не выгружает в файлы накопленную в буферах трассировку, возлагая эту работу на запускаемую при необходимости автономную программу-дамп.
• LowDumpLevel – признак выгрузки в файлы накопленной в буферах трассировки с помощью функций ввода/вывода нижнего уровня. Выгрузка буферов с трассировкой функциями ввода/вывода верхнего уровня осуществляется несколько медленнее.
• SetTraceBuf - признак трассировки непосредственно в файлы с буферизацией, осуществляемой операционной системой. Режим трассировки с буферизацией устанавливается с помощью функции setbuf сразу после открытия потока трассировки.
• TraceFlush - признак выталкивания информации трассировки из буфера операционной системы в файл после каждого события (при трассировке непосредственно в файлы). Режим, задаваемый данным параметром, функционирует только в том случае, если трассировка осуществляется с буферизацией (параметр SetTraceBuf задан ненулевым). Параметр TraceFlush может принимать два ненулевых значения: 1 и 2. В первом случае выталкивание трассировки осуществляется с помощью функции fflush. Во втором случае дополнительно осуществляется закрытие файла с трассировкой и последующее его открытие в режиме записи с добавлением информации в конец файла.
• DisableTraceTime – признак вычитания времени работы программ трассировки из временного расстояния между выводимыми в трассировку событиями.

7.2.4 Управление формой накапливаемой информации

• KeyWordName - признак вывода последовательности символов "NAME=" перед именем каждого события.
• PreUnderLine - признак подчеркивания заголовка каждого события (заголовок события - это строка трассировки, содержащая имя события, время, имя файла и номер строки).
• PreUnderLining - строка подчеркивания заголовка каждого события.
• PostUnderLine - признак подчеркивания строки, завершающей выводимую по каждому событию информацию.
• PostUnderLining - строка подчеркивания выводимой по каждому событию информации.
• BufferTraceShift – коэффициент сдвига вправо выводимой информации при трассировке в буфер. Каждой выводимой строке будет предшествовать пробелы в количестве, равном произведению данного параметра на текущую глубину обращений к трассируемым функциям.
• FileTraceShift - коэффициент сдвига вправо выводимой информации при трассировке непосредственно в файлы.
• TimePrecision – число знаков после запятой при выводе времени, прошедшего c предыдущего события.

7.2.5 Управление механизмами внутреннего самоконтроля системы поддержки, функционирующими при накоплении трассировки

В процессе накопления трассировочной информации система поддержки может контролировать определённые области оперативной памяти, при изменении содержимого которых она завершает выполнение программы с выводом соответствующего сообщения об ошибке. К таким областям относятся:

• левые (нижние) и правые (верхние) контрольные части каждого динамически запрошенного блока памяти;
• область памяти, явно задаваемая в файлах параметров systrace.* своими начальным и конечным адресами;
• область памяти с программным кодом пользовательской программы и системы поддержки (память команд).

Контрольные части динамически запрашиваемых блоков памяти создаются при специальном указании в файлах параметров sysdebug.* и расписываются задаваемым там же кодом при выделении блока. Контроль их содержимого может осуществляться при каждом запросе и освобождении блока памяти, а также в процессе трассировки.

Явно задаваемая область памяти контролируется путем сравнения ее эталонной контрольной суммы с текущей. Эталонная контрольная сумма вычисляется при инициализации системы поддержки.

Начальный и конечный адреса области памяти с программным кодом задаются программой, запускающей на выполнение систему поддержки, посредством записи этих адресов в ее (системы поддержки) исполняемый модуль. Эта же программа вычисляет и записывает в исполняемый модуль системы поддержки эталонную контрольную сумму памяти команд. Система поддержки в процессе своего функционирования (в частности, по событиям трассировки) контролирует память команд, сравнивая ее текущую контрольную сумму с эталонной.

Управление механизмами контроля областей памяти осуществляется с помощью следующих параметров файлов systrace.* .

• EveryEventCheckBound - признак контроля всех динамически запрошенных блоков памяти по каждому трассируемому событию.
• EveryTraceCheckBound - признак контроля всех динамически запрошенных блоков памяти при каждом обращении к функциям вывода трассировки, описанным в п.7.3. Данный контроль включает в себя контроль, задаваемый параметром EveryEventCheckBound, поскольку осуществляется и по не трассируемым (выключенным) событиям.
• dvm_StartAddr - начальный адрес, контролируемый при трассировке области памяти.
• dvm_FinalAddr - конечный адрес контролируемой при трассировке области памяти.
• EveryEventCheckMem - признак контроля области памяти, заданной параметрами dvm_StartAddr и dvm_FinalAddr, при каждом трассируемом событии.
• EveryTraceCheckMem - признак контроля заданной параметрами dvm_StartAddr и dvm_FinalAddr области памяти при каждом обращении к описанным в п.7.3 функциям вывода трассировки. Данный контроль включает в себя контроль, задаваемый параметром EveryEventCheckMem, т.к. проводится и по выключенным событиям трассировки.
• EveryEventCheckCodeMem - признак контроля области памяти с программным кодом по каждому трассируемому событию.
• EveryTraceCheckCodeMem - признак контроля области памяти с программным кодом при каждом обращении к функциям вывода трассировки, рассмотренным в п.7.3. Данный контроль включает в себя контроль, задаваемый параметром EveryEventCheckCodeMem.

Кроме рассмотренных выше средств контроля заданных областей памяти, система поддержки предоставляет также возможность вывода в трассировку значения заданной переменной, управляемого следующими параметрами файлов systrace.* :

• TraceVarAddr = <адрес выводимой в трассировку переменной>;
• TraceVarType = <номер типа выводимой в трассировку переменной>;

Адрес переменной может задаваться в десятичном или шестнадцатеричном виде (по правилам языка C). При нулевом значении адреса вывод переменной в трассировку не осуществляется.

Номер типа переменной может принимать значения:

1. int;
2. long;
3. float;
4. double;
5. char;
6. short.

При указания номера типа, отличающегося от перечисленных выше, вывод переменной в трассировку не производится.

7.2.6 Управление выводом дополнительной информации при трассировке некоторых функций системы поддержки в расширенном режиме

• distr_Trace – признак вывода дополнительной информации при трассировке функции distr_. Выводится карта отображения представления абстрактной машины, диапазоны локальных значений индексов для каждого измерения представления абстрактной машины, признак размножения по всем измерениям процессорной подсистемы (Repl) и признак отображения на каждый процессор какого-либо (не обязательно одного и того же) элемента представления абстрактной машины (Every).
• align_Trace – признак вывода дополнительной информации при трассировке функции align_. Выводится карта отображения распределённого массива и диапазоны локальных значений индексов для каждого его измерения.
• mappl_Trace – режим вывода дополнительной информации при трассировке функции mappl_:

• dopl_Trace – признак вывода дополнительной информации при трассировке функции dopl_. Выводится очередная порция диапазонов локальных значений индексов для каждого измерения параллельного цикла.
• PLTimeTrace - признак вывода информации о времени выполнения групп витков параллельных циклов.
• RedVarTrace – признак вывода адресов, типов и значений всех переменных редукционной группы при выполнении функций saverv_ и strtrd_ , а также в начале и конце выполнения функции waitrd_ .
• OutIndexTrace – признак вывода выходных значений индексов для каждого измерения распределённого массива при выполнении внутренней функции системы поддержки GetIndexArray.
• diter_Trace – признак вывода массива индексов при трассировке функции взаимодействия с DVM-отладчиком diter_.
• drmbuf_Trace – признак вывода массива индексов при трассировке функции взаимодействия с DVM-отладчиком drmbuf_.
• dyn_GetLocalBlock_Trace – признак трассировки вспомогательной функции DVM-отладчика dyn_GetLocalBlock.
• LoadWeightTrace - признак трассировки массивов с координатными весами загрузки процессоров при вызове функции setelw_.
• WeightArrayTrace - признак трассировки массива с координатными весами загрузки при выходе из функции gettar_.

7.3 Функции вывода информации в потоки трассировки

Вывод информации в потоки трассировки осуществляется с помощью следующих функций (параметр format и следующие за ним параметры аналогичны соответствующим параметрам функции printf библиотеки языка C).

int tprintf (char *format, ... );

Функция осуществляет вывод информации во все открытые потоки трассировки. Возвращается число выведенных символов.

Функция выводит информацию в открытые потоки трассировки, направленные в буфер оперативной памяти и непосредственно в файл. Кроме того, вывод производится в потоки, предназначенные для вывода информационных сообщений системы поддержки (параметр prefix равен 0 или 1), либо в потоки, предназначенные для вывода сообщений об ошибках (prefix равен 2 или 3) (см.п.8).

При значении параметра prefix, равном 1 или 3, вывод осуществляет каждый процессор решающего поля, предваряя заданную информацию своим номером (см.п.1.3 и п.4). Если значение prefix равно 0 или 2, то вывод информации в потоки трассировки осуществляет каждый процессор решающего поля, а в остальные потоки - только главный процессор (см.п.4). Предварительный вывод номера процессора в этом случае не производится.

Возвращается число выведенных символов.

Функция выводит информацию о состоявшемся событии с номером number во все открытые потоки трассировки. Выводимая информация состоит из:

• стандартной информации для события трассировки с номером number;
• дополнительной информации, заданной параметром format и последующими параметрами, если таковые имеются.

Стандартная информация включает в себя:

• имя события трассировки с номером number;
• время выполнения программы, прошедшее с момента предыдущего фактического вывода информации в потоки трассировки с помощью функции dvm_trace;
• имя файла и номер строки, вместе определяющие точку произошедшего события с номером number.

Фактический вывод информации в потоки трассировки происходит лишь в том случае, если событие с номером number включено.

Вывод дополнительной информации осуществляется только в расширенном режиме трассировки или при задании такого режима отдельно для события с номером number.

Имя файла и номер строки, определяющие точку произошедшего события, сообщаются программе трассировки макровызовом DVM_CALL. Название макроса проистекает из того, что все события трассировки, за несколькими исключениями, - это вызовы функций системы поддержки. Если событие произошло внутри системы поддержки и событием является обращение к функции, то используется макровызов RTL_CALL. Макровызовы DVM_CALL и RTL_CALL должны исполнительно предшествовать событию и максимально к нему приближены (по расположению в файле с программой). Таким образом, трассировка событий осуществляется по следующей схеме:

DVM_CALL; (или RTL_CALL;)
……………………..
< точка наступившего события >
..................................
dvm_trace( ........ );

Трассировка функций системы поддержки организована таким образом, что обращение к dvm_trace происходит внутри трассируемой функции. Наиболее предпочтительным способом использования макровызовов DVM_CALL и RTL_CALL при трассировке функций является применение операции последовательного вычисления:

( DVM_CALL , < обращение к функции > )

или

( RTL_CALL , < обращение к функции > ) .

В этом случае номер строки, сообщаемый программе трассировки, будет точно равен номеру строки наступившего события (обращения к функции), а обращение к функции в любом выражении языка C может быть эквивалентно заменено на какую-либо из вышеприведенных конструкций.

Замечание. Имя файла и номер строки, определяющие точку наступившего события, могут быть сообщены системе поддержки также с помощью функций

При выполнении функции fname_ последнему байту строки с именем файла будет присвоено нулевое значение. Функции возвращают нулевые значения.

Данные функции могут быть использованы препроцессорными программами для "привязки" точки предполагаемого события к своему входному тексту.

Отметим, что последовательность обращений

long line;
..............................
..............................
line = __LINE__ ;
fname_ ( __FILE__ ,
strlen(__FILE__)+1 ) ;
lnumb_ ( &line ) ;

эквивалентна макровызову

DVM_CALL ; .

Функция выводит информацию в открытые потоки трассировки, направленные в буфер оперативной памяти и непосредственно в файл, а также в потоки, предназначенные для сообщений об ошибках (см.п.8), после чего завершает выполнение программы пользователя и системы поддержки. Информации, выводимой в потоки, предназначенные для сообщений об ошибках, предшествует вывод номера текущего процессора.

После вывода информации, заданной параметром format и последующими параметрами (если таковые имеются), выводятся строка, заданная указателем FileNamePtr и целое число, заданное параметром Line. Предполагается, что выводимые строка и число - это имя файла и номер строки, содержащие данное обращение к функции eprintf, то есть, что обращение к eprintf имеет вид:

eprintf(__FILE__ , __LINE__ , format , . . . );

Кроме того, функция eprintf выводит координаты точки программы пользователя, из которой произошло последнее обращение к системе поддержки (имя файла и номер строки).

Функция аналогична рассмотренной выше функции eprintf , но при нулевом значении параметра prefix вывод информации в потоки, предназначенные для сообщений об ошибках, осуществляет только главный процессор (см. п.4). Номер текущего процессора в этом случае не выводится.