cdvm_guid-r (1158371)
Текст из файла
10
Компилятор CDVM
(Руководство пользователя)
Октябрь, 1999
Институт прикладной математики им. М.В.Келдыша
Российская Академия наук
Оглавление
1 Назначение компилятора 3
2 Запуск компилятора 3
3 Диагностики компилятора 4
3.1 Фатальные ошибки 4
3.2 Диагностики сканнера и парсера 4
3.3 Ошибки файлового уровня и операторов 4
3.4 Описания 5
3.5 Объявление и использование DVM-объектов 6
3.6 DISTRIBUTE, ALIGN, TEMPLATE 7
3.7 malloc и доступ к распределенным данным 7
3.8 Цикл PARALLEL 8
3.9 SHADOW 9
3.10 REDUCTION 9
3.11 Процедуры 9
3.12 Трассировка данных 10
3.13 Разное 10
1Назначение компилятора
Язык C-DVM это расширение ANSI-C специальными аннотациями для спецификации параллельного выполнения программы. Эти аннотации называются DVM-директивами.
Компилятор (конвертор) C-DVM - это инструмент DVM-системы, который преобразует аннотированную CDVM программу в ANSI-C программу в SPMD стиле, которая содержит обращения к системе поддержки (Lib-DVM). Затем полученная программа (c INCLUDE-файлом cdvm_c.h) может быть оттранслирована любым Cи-компилятором и слинкована с библиотекой Lib-DVM.
Кроме чисто параллельного кода компилятор может создавать «расширенный» отладочный код, использующий возможности анализатора производительности параллельных программ (PPPA) и отладчика, а так же «последовательную» версию программы (без вызовов Lib-DVM) с такими отладочными расширениями, которая может использоваться для получения характеристик выполнения исходной (нераспараллеленной) программы и для получения «эталонной» трассировки для отладки в режиме сравнения трассировки.
2Запуск компилятора
Компилятор запускается следующей командной строкой:
dvm сdv [<options>] <infile>
где
| <infile> | - имя файла (без расширения), который содержит текст исходной программы на языке C-DVM. Файл должен иметь расширение .cdv. Поиск входного файла производится только в текущей директории. Предполагается, что он является правильным с точки зрения синтаксиса C и транслируется стандартным C-компилятором (конвертор не делает стандартной проверки синтаксиса и семантики C); |
| -o <outfile> | - имя выходного файла конвертированной программы. Если опция не указана, то по умолчанию, выходной файл получает имя <infile>.c. Выходной файл записывается в текущую директорию. Если конвертор обнаружил ошибки, то этот файл не создается. Сообщения об ошибках записываются в файл cdvm_msg. |
<options> - одна или более опций из следующего списка:
-s – генерировать «последовательную» программу (для получения трассировки и характеристик эффективности); если этот параметр не указан, генерируется параллельная программа;
-p – генерировать параллельную программу;
Режимы трассировки:
-d1 – трассировать запись в DVM-массивы,
-d2 – трассировать все обращения к DVM-массивам,
-d3 – трассировать запись во все переменные,
-d4 – трассировать все обращения ко всем данным;
Замечание1. В любом указанном режиме трассируется выполнение витков циклов.
Режимы анализа производительности:
-e1 – замеры параллельных циклов и объемлющих последовательных,
-e2 – замеры только на пользовательских INTERVAL’ах,
-e3 = e1 + e2,
-e4 = e3 + все другие параллельные циклы;
Замечание2. Из последовательных циклов учитываются только те, которые заданы макросами DO и FOR. Стандартные циклы C (for, while, do) не замеряются.
Прочие:
-v – вывод информационных сообщений на терминал,
-w – включить все предупреждения,
-w- – выключить все предупреждения,
-xN – размер системных таблиц (по умолчанию: -x16).
3Диагностики компилятора
3.1Фатальные ошибки
При фатальных ошибках выполнение прекращается. К ним относятся:
-
Ошибки в параметрах командной строки;
-
Ошибки открытия необходимых файлов – Проверьте, что файл существует и доступен, и есть права на запись выходных файлов;
-
Переполнение системных таблиц – Попробуйте увеличить размер (опция -x).
3.2Диагностики сканнера и парсера
Сканнер останавливается с сообщением при:
-
Незакрытой символьной или строковой константе.
-
Незакрытом комментарии.
Недопустимые символы и “/*” внутри комментария пропускаются с соответствующим сообщением.
Парсер останавливается с сообщением:
-
“Unexpected <token>” – нет допустимого терминального сисмвола;
-
“<construct> expected” – нет требуемой конструкции;
-
“<construct> syntax” – ошибка в конструкции.
3.3Ошибки файлового уровня и операторов
"The 'main' should get the command line parameters"
В командной строке передаются параметры запуска Lib-DVM. Поэтому требуется заголовок
int main (int argn, char ** args)
"The 'main' should 'return <rc>;' for the Lib-DVM"
Lib-DVM ожидает пользовательский код возврата, чтобы передать операционной системе.
"Implicitly created objects must precede 'main'"
«Неявно создаваемые объекты должны предшествовать ‘main’ ». К таким объектам относятся распределяемые массивы с константными размерностями и т.п. Они автоматически создаются в самом начале ‘main’, поэтому должны быть все известны в этой точке.
"'main' required for implicitly created objects"
«’main’ требуется в файле в неявно создаваемыми объектами.» См. предыдущее сообщение.
"DVM-operator outside function"
«DVM-оператор вне функции.»
"Misplaced declarative DVM-directive"
«Описательная директива в неподходящем месте» – после операторов или при операторе.
"DVM-directive requires a non-empty operator"
«DVM-директива требует непустого оператора». -Эта директива -- спецификация при операторе. Не должна отделяться от него ‘;”.
"Should be followed by the ';'"
«Должна сопровождаться ‘;’» – Эта директива сама является оператором.
"TASK_REGION must be a sequence of ON-blocks or ON-loop"
«TASK_REGION должен быть последовательностью ON-блоков или ON-циклом».
"Not allowed in a PARALLEL loop"
«Недопустимо в параллельном цикле».
3.4Описания
"DVM-object should be defined as 'void * '"
«DVM объекты должны иметь тип void*.»
"DVM-arrays may be int, long, float, or double only"
«DVM-массивы могут быть только типов int, long, float и double ».
"Scalar can not be distributed"
«Скалярные переменные не могут быть распределенными».
"DVM-pointer should be a C-pointer"
«DVM-указателем должен быть описан как указатель в C».
"'*' is valid only with DISTRIBUTE and ALIGN"
«’*’ допустима только с директивами DISTRIBUTE и ALIGN ».
"Only 1D-arrays of ptrs to DVM-arrays supported"
«Только одномерные массивы указателей на распределенные массивы допустимы».
"Unsupported declarator for distributed data"
«Недопустимый декларатор для распределенных данных».
"Can not initialize DVM-objects"
«Нельзя указывать инициализатор для DVM объектов и массивов».
"DVM declarator syntax error"
«Синтаксическая ошибка в деклараторе».
3.5Объявление и использование DVM-объектов
"Undefined"
«Не определен» -- Последовательная программа при этом могла транслироваться, если идентификатор используется только в DVM-директивах.
"This is not a DVM-object"
«Это не DVM-объект».
"Rank error"
«Несоответствие ранга» – использования и описания и т.п.
"This is not a REDUCTION_GROUP"
«Это не REDUCTION_GROUP ».
"This is not a SHADOW_GROUP"
«Это не SHADOW_GROUP ».
"This is not a REMOTE_GROUP"
«Это не REMOTE_GROUP ».
"This is not a TASK"
«Это не TASK ».
"An array of void* required."
«Требуется массив указателей void*.»
"MAP-target must be a processors section"
«MAP требует секции процессоров».
"ON-target must be an element of task array"
«ON требует элемента массива задач».
3.6DISTRIBUTE, ALIGN, TEMPLATE
"'[*]' is only allowed in DVM( * DISTRIBUTE...)"
«’[*]’ допустимо только в DVM( * DISTRIBUTE…).»
"Array should be defined as DVM(DISTRIBUTE...)"
«Массив должен быть описан как DVM(DISTRIBUTE…).»
"GENBLOCK requires non-distributed 1D integer array"
«GENBLOCK требует нераспределенного одномерного массива типа int.»
"ONTO target must be a TASK or a PROCESSORS"
«ONTO требует DVM-объект типа TASK или PROCESSORS.»
"ONTO target must be an element of task array"
«ONTO требует элемент массива задач.»
"Align-expression syntax: [-][A*]var[+B|-B]"
«Выражение выравнивания: линейное относительно var.»
"Already used align|do variable"
«Эта переменная выравнивания цикла уже использована».
"The base of a static should be a (known) static"
«Базовый массив для выравнивания ‘статического' сам должен быть (уже определенным) ‘статическим’». (‘Статический’ – это массив с константными размерностями.)
"The parameter should be a (non-static) TEMPLATE"
«Параметр должен быть (не ‘статическим’) TEMPLATE.»
3.7malloc и доступ к распределенным данным
"DVM-malloc requires (dim1*...*sizeof(...))"
«malloc для распределенного массива требует параметра в виде (dim1*…*sizeof(…)).»
"Is it 'sizeof(<element type>)' ?"
«Это sizeof(<element>) ?» -- Последний сомножитель записан не в такой форме; может быть, потерян?
"Only DVM-arrays may be malloc'ed"
«Только DVM-массивы могут создаваться с помощью malloc » – не указатели!
"Static DVM-array can not be malloc'ed"
«’Статические’ массивы нельзя создавать malloc » – и не нужно: они создаются автоматически в начале ‘main’
"Only DVM-pointers may be assigned"
«Только DVM указателям можно присваивать значения» – других указателей и DVM-массивов.
"REDISTRIBUTE|REALIGN must follow this malloc"
«После этого malloc требуется REDISTRIBUTE или REALIGN » – т.к. в описании массива нужной информации нет!
"Can not assign to REMOTE"
«Нельзя присваивать данным, описанным в REMOTE_ACCESS.»
"Can not get REMOTE address"
«Нельзя брать адрес от данных REMOTE_ACCESS » – т.е. применять оператор &.
"Possible non-local assignement. Use DVM(OWN)"
«Возможно нелокальное присваивание. Используйте директиву OWN.»
"Only 1..4-D arrays may be distributed"
«Размерность распределенных массивов не более 4.»
"Too many distributed dimensions"
«Слишком много распределенных размерностей.»
"Not all distributed dimensions"
Характеристики
Тип файла документ
Документы такого типа открываются такими программами, как Microsoft Office Word на компьютерах Windows, Apple Pages на компьютерах Mac, Open Office - бесплатная альтернатива на различных платформах, в том числе Linux. Наиболее простым и современным решением будут Google документы, так как открываются онлайн без скачивания прямо в браузере на любой платформе. Существуют российские качественные аналоги, например от Яндекса.
Будьте внимательны на мобильных устройствах, так как там используются упрощённый функционал даже в официальном приложении от Microsoft, поэтому для просмотра скачивайте PDF-версию. А если нужно редактировать файл, то используйте оригинальный файл.
Файлы такого типа обычно разбиты на страницы, а текст может быть форматированным (жирный, курсив, выбор шрифта, таблицы и т.п.), а также в него можно добавлять изображения. Формат идеально подходит для рефератов, докладов и РПЗ курсовых проектов, которые необходимо распечатать. Кстати перед печатью также сохраняйте файл в PDF, так как принтер может начудить со шрифтами.















