Serve.cfg:global:run dir - Revision history

Anna at 09:35, 10 February 2012

2012-02-10T09:35:34Z

Anna at 09:35, 10 February 2012

2012-02-10T09:35:03Z

Anna: Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[serve..."

2012-02-10T09:33:19Z

Created page with "Навигация: Главная страница/Система ejudge/Использование/Конфигурационные файлы/[[serve..."

New page

Навигация: [[Main Page|Главная страница]]/[[Система ejudge]]/[[Использование]]/[[Конфигурационные файлы]]/[[serve.cfg]]/[[serve.cfg:global|Глобальные конфигурационные параметры]]/[[serve.cfg:global:run_dir|run_dir]]

{|
| '''Имя переменной''': || <tt>'''run_dir'''</tt> ||
|-
| '''Содержится в:''' || <tt>[[serve.cfg:global|global]]</tt> ||
|-
| '''Используется:''' || <tt>serve, run</tt> ||
|-
| '''Тип содержимого:''' || ''путь к каталогу'' ||
|-
|'''Может отсутствовать:''' || ''да'' ||
|-
| '''Значение по умолчанию:'''|| <tt>run</tt>
|-
|'''Может повторяться:''' || ''нет'' ||
|}
'''Описание.''' Данная переменная задаёт каталоги обмена между программами <tt>serve</tt> и <tt>run</tt>.
Полный путь к этому каталогу определяется по следующим правилам:

* Если значение переменной <tt>run_dir</tt> не задано, используется значение <tt>run</tt>.

* Если значение переменной <tt>run_dir</tt> начинается с символа ’/’, то есть значение переменной задаёт полный абсолютный путь к каталогу скриптов, этот путь используется без изменений.

* Если значение переменной <tt>run_dir</tt> не начинается с символа ’/’, полный путь к каталогу скриптов образуется конкатенацией значения переменной <tt>[[serve.cfg:global:var_dir|var_dir]]</tt> и значения переменной <tt>run_dir</tt>.

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

* Подкаталог queue используется для передачи информации от программы <tt>serve</tt> к программе <tt>run</tt>. Программа <tt>serve</tt> помещает в этот каталог небольшие файлы, содержащие служебную информацию о программе, которую необходимо протестировать (так называемый «пакет задания тестирования»). Программа <tt>run</tt> периодически просматривает этот каталог и при появлении в нём новых пакетов задания тестирования выполняет их. Этот каталог может использоваться совместно несколькими программами <tt>serve</tt>, обслуживающими разные турниры, и несколькими программами run, например, работающими на разных компьютерах в сети. Этот каталог имеет специальную структуру, чтобы предотвратить синхронизационные ошибки при одновременном доступенескольких программ.

* Подкаталог <tt>exe</tt> используется для передачи информации от программы <tt>serve</tt> к программе <tt>run</tt>. Программа <tt>serve</tt> помещает в этот каталог исполняемый файл программы, которую необходимо протестировать. Исполняемый файл программы имеет то же самое имя, что и пакет задания тестирования для этой программы. Программа <tt>run</tt> считывает исполняемый файл после файла пакета задания компиляции. Этот каталог может использоваться совместно несколькими программами <tt>serve</tt>, обслуживающими разные турниры, и несколькими программами <tt>run</tt>. Синхронизация доступа поддерживается в каталоге <tt>queue</tt>, поэтому никакой дополнительной синхронизации в каталоге <tt>exe</tt> не требуется.

* Подкаталог <tt>status</tt> используется для передачи информации от программы <tt>run</tt> к программе <tt>serve</tt>. В этот каталог программа <tt>run</tt> помещает небольшой файл с информацией о результате тестирования (так называемый «пакет результата тестирования»). Программа <tt>serve</tt> периодически просматривает данный каталог и при появлении в нём новых файлов обновляет своё внутреннее состояние. Поскольку каталог может использоваться одновременно несколькими программами <tt>run</tt> и одной программой <tt>serve</tt>, он имеет специальную структуру для предотвращения синхронизационных ошибок.

* Подкаталог <tt>report</tt> используется для передачи информации от программы <tt>run</tt> к программе <tt>serve</tt>. В этот каталог программа <tt>run</tt> помещает судейский вариант протокола тестирования. Каталог может использоваться одновременно несколькими программами <tt>run</tt> и одной программой </tt>serve</tt>, но синхронизация доступа ведётся с помощью каталога <tt>status</tt>, поэтому никакой дополнительной синхронизации в каталоге <tt>report</tt> не требуется.

* Подкаталог <tt>teamreport</tt> используется для передачи информации от программы </tt>run</tt> к программе </tt>serve</tt>. В этот каталог программа <tt>run</tt> помещает пользовательский вариант протокола тестирования, если эта опция включена в конфигурационном файле турнира.
Каталог может использоваться одновременно несколькими программами <tt>run</tt> и одной программой <tt>serve</tt>, но синхронизация доступа ведётся с помощью каталога status, поэтому никакой дополнительной синхронизации в каталоге <tt>teamreport</tt> не требуется.

* Символическая ссылка <tt><nowiki><номер></nowiki></tt>, где <tt><nowiki><номер></nowiki></tt> — четырёхзначный идентификатор турнира. Эта символическая ссылка создаётся в каталоге, задаваемом переменной <tt>run_dir</tt>, программы <tt>run</tt>, и указывает на каталог, задаваемый переменной <tt>compile_dir</tt>, программы <tt>serve</tt>. Если эти каталоги совпадают, символическая ссылка указывает на каталог, в котором она находится. С помощью этой символической ссылки программа <tt>run</tt> может обслуживать одновременно несколько турниров, записывая результаты тестирования в каталог обмена только соответствующего турнира.

'''Пример.''' С помощью задания каталога обмена можно добиться того, что несколько одновременно работающих серверов турнира будут использовать одну программу тестирования run. Для этого создаётся отдельный каталог для программы <tt>run</tt>, например
<tt>/var/ejudge/run</tt>. Этот каталог указывается в качестве корневого в конфигурационном
файле программы <tt>run</tt> c помощью строки
root_dir = /var/ejudge/run

Программа <tt>run</tt> запускается в каталоге <tt>/var/ejudge/run</tt>. Теперь во всех конфигурационных файлах серверов турниров для использования этой программы тестирования достаточно установить переменную <tt>run_dir</tt> в следующее значение:
run_dir = /var/ejudge/run/var/compile

@@ Line 35: / Line 35: @@
 * Подкаталог <tt>report</tt> используется для передачи информации от программы <tt>run</tt> к программе <tt>serve</tt>. В этот каталог программа <tt>run</tt> помещает судейский вариант протокола тестирования. Каталог может использоваться одновременно несколькими программами <tt>run</tt> и одной программой <tt>serve</tt>, но синхронизация доступа ведётся с помощью каталога <tt>status</tt>, поэтому никакой дополнительной синхронизации в каталоге <tt>report</tt> не требуется.
-* Подкаталог <tt>teamreport</tt> используется для передачи информации от программы </tt>run</tt> к программе </tt>serve</tt>. В этот каталог программа <tt>run</tt> помещает пользовательский вариант протокола тестирования, если эта опция включена в конфигурационном файле турнира. Каталог может использоваться одновременно несколькими программами <tt>run</tt> и одной программой <tt>serve</tt>, но синхронизация доступа ведётся с помощью каталога status, поэтому никакой дополнительной синхронизации в каталоге <tt>teamreport</tt> не требуется.
+* Подкаталог <tt>teamreport</tt> используется для передачи информации от программы <tt>run</tt> к программе <tt>serve</tt>. В этот каталог программа <tt>run</tt> помещает пользовательский вариант протокола тестирования, если эта опция включена в конфигурационном файле турнира. Каталог может использоваться одновременно несколькими программами <tt>run</tt> и одной программой <tt>serve</tt>, но синхронизация доступа ведётся с помощью каталога status, поэтому никакой дополнительной синхронизации в каталоге <tt>teamreport</tt> не требуется.
 * Символическая ссылка <tt><nowiki><номер></nowiki></tt>, где <tt><nowiki><номер></nowiki></tt> — четырёхзначный идентификатор турнира. Эта символическая ссылка создаётся в каталоге, задаваемом переменной <tt>run_dir</tt>, программы <tt>run</tt>, и указывает на каталог, задаваемый переменной <tt>compile_dir</tt>, программы <tt>serve</tt>. Если эти каталоги совпадают, символическая ссылка указывает на каталог, в котором она находится. С помощью этой символической ссылки программа <tt>run</tt> может обслуживать одновременно несколько турниров, записывая результаты тестирования в каталог обмена только соответствующего турнира.