deb_guid-r (1158374), страница 4

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

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

Все параметры базового набора снабжены комментариями. Полные списки параметров динамического контроля и пользовательской трассировки приведены в п.п. 11.1 и 11.2. Параметры вывода информационных сообщений системы поддержки и основные параметры управления системной трассировкой (как наиболее часто используемые при отладке программ) рассмотрены в п.п. 11.3 и 11.4.

11.1Параметры динамического контроля

Перечисленные ниже параметры содержатся в файлах с именем usrdebug.

• EnableDynControl — признак включенного динамического контроля.

• DebugOptions.ErrorToScreen — если значение не равно 0, то вся диагностика динамического контроля выводится на экран.

• DebugOptions.ErrorFile — имя файла с диагностикой об ошибках. В данный файл пишутся сообщения об ошибках, найденных при динамическом контроле, если значение параметра DebugOptions.ErrorToScreen равно 0. Если попытки открытия файла окажутся неуспешными, то диагностика будет выводиться на экран.

• DebugOptions.AppendErrorFile — определяет режим записи в файл диагностики при его использовании. Если значение равно 0, то при каждом запуске задачи содержимое этого файла обновляется.

• DebugOptions.MaxErrors — определяет максимальное число ошибок, после которого динамический контроль будет отключен.

• DebugOptions.PrintStatistic — если значение параметра не равно 0, то по окончании работы программы печатается статистика работы с таблицей переменных. Статистика выводится в файл с именем, заданным параметром DebugOptions.ErrorFile или на экран в зависимости от значения параметра DebugOptions.ErrorToScreen.

• DebugOptions.CheckVarInitialization — если значение равно 0, то отменяется проверка инициализации скалярных переменных.

• DebugOptions.CheckVarReadOnly — если значение равно 0, то отменяется проверка использования переменным с доступом только на чтение.

• DebugOptions.CheckReductionAccess — если значение равно 0, то отменяется проверка использования редукционных переменных.

• DebugOptions.CheckDisArrInitialization — если значение равно 0, то отменяется проверка инициализации элементов распределенных массивов.

• DebugOptions.CheckDisArrLimits — если значение равно 0, то отменяется проверка обращений к элементам распределенного массива за пределами его границ.

• DebugOptions.CheckDisArrEdgeExchange — если значение равно 0, то отменяется проверка обмена теневых граней распределенных массивов.

• DebugOptions.CheckDisArrSequentialAccess — если значение равно 0, то отменяется проверка использования элементов распределенных массивов в последовательной части программы.

• DebugOptions.CheckDisArrLocalElm — если значение равно 0, то отменяется проверка на принадлежность элемента распределенного массива его локальной части.

• DebugOptions.CheckDataDependence — если значение равно 0, то отменяется проверка на зависимость параллельных циклов по данным.

• DebugOptions.CheckRemoteBufferAccess — если значение равно 0, то отменяется проверка использования буферов удаленного доступа.

• HashMethod — определяет алгоритм вычисления хеш-значения. 0 — используется StandartHashCalc, 1 — используется OffsetHashCalc.

• HashOffsetValue — величина смещения для алгоритма OffsetHashCalc. Допускаются значения от 0 до 16.

• DebugOptions.HashIndexSize — размер индекса хеш-таблицы для таблицы переменных

• DebugOptions.HashTableSize — размер массивов хеш-таблиц.

• DebugOptions.VarTableSize — размер таблиц переменных.

11.2Параметры накопления и сравнения трассировки вычислений

Перечисленные ниже параметры содержатся в файлах с именем usrdebug.

• EnableTrace — признак включенной трассировки вычислений.

• DelUsrTrace — признак уничтожения “старых” (оставшихся от предыдущего запуска) файлов с трассировкой вычислений и обнаруженными ошибками. Уничтожение происходит лишь в том случае, если параметры EnableDynControl и EnableTrace заданы нулевыми.

• TraceOptions.TraceMode — задание режима трассировки:

0 — генерация файла описания циклов. Пишет только процессор с номером TraceOptions.WrtHeaderProc.

1 — сбор трассировки и запись в файл <номер процессора>.<TraceOptions.Ext>;

2 — объединение двух предыдущих режимов;

3 — сравнение трассировки с эталонной, заданной в файле TraceOptions.TraceFile.

• TraceOptions.TraceLevel — уровень накопления трассировки. Существенен только в режимах сбора трассировки и генерации файла описания циклов:

0 — трассировка не собирается;

1 — сбор информации только о циклах и итерациях;

2 — то же, что и предыдущее плюс сбор информации о модификациях переменных;

3 — сбор полной информации.

• ManualReductCalc —режим вычисления редукции. Обычный, если параметр равен 0, и эмуляция вычисления каждого витка цикла на своем процессоре в противном случае.

• TraceOptions.WriteEmptyIter — если равен 0, то из трассировки исключаются записи, соответствующие началу итерации, если внутри этой итерации нет обращений к переменным или вложенных циклов.

• TraceOptions.TracePath — путь для файлов трассировки.

• TraceOptions.TraceFile — имя файла с эталонной трассировкой. Файл берется из директории, указанной в TraceOptions.TracePath. Используется только в режиме сравнения трассировок.

• TraceOptions.Ext — расширения для файлов с накапливаемой трассировкой. Имя файла формируется по правилу:

<номер процессора>.<значение TraceOptions.Ext>. Файл с трассировкой создается в каталоге, указанном в TraceOptions.TracePath. Используется только в режиме накопления трассировки.

• TraceOptions.FileLoopInfo — имя файла описания циклов программы. Берется из каталога, заданного в параметре TraceOptions.TracePath.

• TraceOptions.ErrorToScreen — если значение не равно 0, то вся диагностика выводится на экран.

• TraceOptions.ErrorFile — имя файла с диагностикой об ошибках. В данный файл помещаются сообщения об ошибках, если значение параметра TraceOptions.ErrorToScreen равно 0. Если попытки открытия файла окажутся неуспешными, то диагностика будет выводиться на экран.

• TraceOptions.AppendErrorFile — определяет режим записи в файл диагностики при его использовании. Если значение равно 0, то при каждом запуске задачи содержимое этого файла обновляется.

• TraceOptions.MaxErrors — максимальное число ошибок, после которого будет отключено накопление или сравнение трассировки.

• TraceOptions.PrintStatistic — вывод статистики трассировки по окончании работы программы. Статистика выводится в файл TraceOptions.ErrorFile или на экран в зависимости от значения параметра TraceOptions.ErrorToScreen.

• TraceOptions.Exp — точность сравнения вещественных чисел в режиме сравнения трассировок.

• TraceOptions.WrtHeaderProc — номер процессора, который будет создавать файл описания циклов. Так как общая структура программы идентична для всех процессоров, то файл описания циклов будет одинаков для любого процесса. Отличаться они будут только значениями объема трассировки, т.к. эти значения вычисляются только для текущего процесса. Общий объем трассировки для всех процессов можно получить, запустив программу на одном процессоре.

• TraceOptions.SpaceIndent — размер отступа, используемый в файлах трассировки.

• TraceOptions.TableTraceSize — размер массивов для трассировки

• TraceOptions.HashIterIndex,
  TraceOptions.HashIterSize — параметры хеш-таблиц, используемых для поиска итераций.

• TraceOptions.ReductHashIndexSize,
  TraceOptions.ReductHashTableSize,
  TraceOptions.ReductVarTableSize — параметры таблицы переменных, используемой для хранения редукционных переменных

• TraceOptions.SaveThroughExec — если не равен 0, то трассировка пишется в файл в ходе выполнения программы (в память накопление не происходит). В противном случае трассировка записывается по окончании выполнения программы.

11.3Параметры перенаправления стандартных выходных потоков и управления выводом информационных сообщений системы поддержки

Перечисленные ниже параметры содержатся в файлах с именами syspar, statist, systrace и usrdebug. По умолчанию будем считать, что параметр задается в файлах с именем syspar.

• StdOutToFile – признак перевода стандартного выходного потока stdout в файл.

• StdOutFileName – путь, определяющий файл для перевода в него потока stdout. Если этот параметр не задан или задан пустой путь, то перенаправление потока stdout, если оно указано параметром StdOutToFile, будет произведено в файл stdout.out.

• StdErrToFile – признак перевода стандартного выходного потока stderr в файл.

• StdErrFileName – путь, определяющий файл для перевода в него потока stderr. Если этот параметр не задан или задан пустой путь, то перенаправление потока stderr, если оно указано параметром StdErrToFile, будет произведено в файл stderr.out.

• DelStdStream – признак уничтожения “старых” (оставшихся от предыдущего запуска) файлов с выходными потоками.

• SysInfoPrint - общий признак включенного вывода информационных сообщений системы поддержки.

• SysInfoStdOut - признак вывода информационных сообщений в поток stdout.

• SysInfoStdErr - признак вывода информационных сообщений в поток stderr.

• SysInfoFile - признак вывода информационных сообщений в файл.

• SysInfoFileName - имя файла для информационных сообщений.

• SysInfoSepFile - признак накопления информационных сообщений в отдельном для каждого процессора временном файле (при SysInfoFile=1), имеющем имя <внутренний номер процессора>.out. Перед завершением работы все временные файлы будут объединены в один, имя которого определено параметром SysInfoFileName , а затем уничтожены. При нулевом значении SysInfoSepFile каждый процессор направляет информационные сообщения непосредственно в файл, заданный параметром SysInfoFileName.

• FatInfoNoOpen - признак завершения работы при неудачном открытии файла для информационных сообщений. При нулевом значении этого параметра система поддержки выведет предупреждение в поток сообщений об ошибках и продолжит выполнение программы без вывода информационных сообщений в файл.

• DelSysInfo – признак уничтожения “старого” (оставшегося от предыдущего запуска) файла с информационными сообщениями.

• VersStartPrint – признак вывода номера версии системы поддержки перед началом работы программы.

• VersFullStartPrint – признак вывода номера версии системы поддержки и номеров версий всех файлов параметров перед началом работы программы.

• VersFinishPrint – признак вывода номера версии системы поддержки после окончания работы программы.

• VersFullFinishPrint – признак вывода номера версии системы поддержки и номеров версий всех файлов параметров после окончания работы программы.

• SysParPrint – признак вывода параметров инициализации системы поддержки перед началом работы программы.

• ProcListPrint – признак вывода таблицы процессоров перед началом работы программы. Для каждого процессора выводится его внутренний и внешний номера и идентификатор.

• WeightListPrint – признак вывода весов координат процессоров перед началом работы программы.

• ParamRunPrint – признак вывода информации о параметрах и режимах запуска системы поддержки перед началом работы программы (стандартный или нестандартный запуск, тип базовой системы передачи сообщений и т. д.).

• EndProgMemoryPrint – признак вывода информации о не освобожденной памяти при завершении работы.

• EndProgObjectPrint – признак вывода информации о не уничтоженных DVM-объектах при завершении работы.

• EndProgCheckSumPrint – признак вывода информации о состоянии контролируемых областей памяти при завершении работы.

• InputParPrint – признак вывода сообщений о начале ввода каждого файла параметров.

• EndReadParPrint – признак вывода сообщений о завершении ввода каждого файла параметров.

• TimeExpendPrint - режим вывода информации о расходе времени программой. При нулевом значении данного параметра информация о расходе времени не выводится. Единичное значение задает краткий режим вывода информации о расходе времени, большее единицы (2,3,4,5) – подробный. Параметр задается в файлах с именем statist.

• CallCountPrint – признак вывода статистики обращений к функциям системы подддержки, доступным программе пользователя (для каждой функции сообщается число обращений к ней). Параметр задается в файлах с именем statist. При единичном значении CallCountPrint выводится информация только о функциях, к которым было хотя бы одно обращение, а при значении, равном 2 – обо всех функциях.

• TraceClosePrint – признак вывода сообщений о завершении выгрузки каждого буфера с накопленной системной трассировкой в файл (при трассировке в буфер оперативной памяти). Параметр задается в файлах с именем systrace.

• DbgInfoPrint – признак вывода информационных сообщений подсистемы динамического контроля и трассировки вычислений. Параметр задается в файлах с именем usrdebug.

11.4Параметры управления системной трассировкой

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

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

• Is_DVM_TRACE — ненулевое значение этого параметра является общим признаком включенной трассировки.

• Is_ALL_TRACE — признак трассировки всех функций системы поддержки (кроме функций обращения к DVM-отладчику и к подсистеме сбора статистики).

• Is_DEB_TRACE — признак трассировки функций обращения к DVM-отладчику.

• Is_STAT_TRACE — признак трассировки функций обращения к подсистеме сбора информации для анализатора производительности.

• TraceProcList — список внутренних номеров процессоров с включенной трассировкой. При общем включении трассировки она функционирует только на тех процессорах, которые заданы в этом списке. Трассировка на главном процессоре накапливается всегда, вне зависимости от наличия его номера (нулевого) в списке TraceProcList.

• IsTraceProcList — признак включенного списка TraceProcList. При нулевом значении этого параметра трассировка накапливается на всех процессорах.

• IsEvent[<номер события>] — равное 1 или 2 значение этого параметра является признаком включенной трассировки события с номером <номер события>. Значение 2 задает трассировку заданного события в расширенном режиме вне зависимости от наличия общего режима расширенной трассировки. Нулевое значение параметра выключает трассировку заданного события. Параметр содержится в файлах trcevent.* .

• BlockTrace — признак отложенного включения трассировки. При общем включении трассировки накопление начинается только по специальному указанию, осуществляемому с помощью функции void tron(void). Включенная трассировка может быть выключена функцией void troff(void) (а затем снова включена и т. д.).

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

• TracePath - имя директории, в которую помещаются файлы с трассировкой (как при трассировке в буфер, так и при трассировке непосредственно в файл). Если задается не пустое имя директории, то оно должно заканчиваться символом '\' или '/'.

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

• BufferTrace - признак накопления трассировки в буфер оперативной памяти.

• TraceBufLength - длина буфера трассировки в байтах.

• TraceBufferExt - расширение файлов с трассировкой при трассировке в буфер.

• FileTrace - признак накопления трассировки непосредственно в файлах.

• FatTraceNoOpen - признак завершения работы при неудачном открытии файла для непосредственного накопления трассировки. При нулевом значении этого параметра неудачное открытие файла будет отмечено предупреждением.

• TraceFileExt - расширение файлов с трассировкой при трассировке непосредственно в файлы.

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

• DelSysTrace – признак уничтожения “старых” (оставшихся от предыдущего запуска) файлов с трассировкой при инициализации системы поддержки.

• FullTrace - общий признак расширенного режима трассировки.

• MaxTraceLevel - общая максимальная трассируемая глубина обращений к функциям. Нулевое значение этого параметра означает трассировку функций, непосредственно вызываемых программой пользователя.

• MaxEventLevel[<номер события>] - максимальная трассируемая глубина обращений к функциям для события с номером <номер события>. Данный параметр имеет приоритет над параметром MaxTraceLevel. Параметр содержится в файлах trcevent.*

• FullBufferStop - признак останова трассировки при исчерпании буфера. Нулевое значение этого параметра устанавливает сохранение последней информации при исчерпании буфера путем замещения ею наиболее старой информации.

• BufferTraceUnLoad – признак выгрузки в файлы накопленной в буферах трассировки перед завершением выполнения программы. При нулевом значении этого параметра система поддержки не выгружает в файлы накопленную в буферах трассировку, возлагая эту работу на запускаемую при необходимости автономную программу-дамп.

• LowDumpLevel – признак выгрузки в файлы накопленной в буферах трассировки с помощью функций ввода/вывода нижнего уровня. Выгрузка буферов с трассировкой функциями ввода/вывода верхнего уровня осуществляется несколько медленнее.

• SetTraceBuf - признак трассировки непосредственно в файлы с буферизацией, осуществляемой операционной системой. Режим трассировки с буферизацией устанавливается с помощью функции setbuf сразу после открытия потока трассировки.

• TraceFlush - признак выталкивания информации трассировки из буфера операционной системы в файл после каждого события (при трассировке непосредственно в файлы). Режим, задаваемый данным параметром, функционирует только в том случае, если трассировка осуществляется с буферизацией (параметр SetTraceBuf задан ненулевым).

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

• KeyWordName - признак вывода последовательности символов 'NAME=' перед именем каждого события.

• PreUnderLine - признак подчеркивания заголовка каждого события (заголовок события - это строка трассировки, содержащая имя события, время, имя файла и номер строки).

• PreUnderLining - строка подчеркивания заголовка каждого события.

• PostUnderLine - признак подчеркивания строки, завершающей выводимую по каждому событию информацию.

• PostUnderLining - строка подчеркивания выводимой по каждому событию информации.

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

• FileTraceShift - коэффициент сдвига вправо выводимой информации при трассировке непосредственно в файлы.

• TimePrecision – число знаков после запятой при выводе времени, прошедшего c предыдущего события.

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

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

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

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

• область памяти с программным кодом пользовательской программы и системы поддержки (память команд).

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

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

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