Описание

Модуль spawner (sp.exe) предназначен для запуска решений и контроля ограничений по ресурсам и правам доступа.

Запуск

sp [опции] имя_приложения [параметры_приложения]

Опция	Переменная окружения	Описание
-ml:[n]	SP_MEMORY_LIMIT	Максимальный объём виртуальной памяти, выделенный процессу (в Mb).
-tl:[n]	SP_TIME_LIMIT	Максимальное время выполнения процесса в пользовательском режиме (в сек).
-d:[n]	SP_DEADLINE	Лимит физического времени, выделенного процессу (в сек).
-wl:[n]	SP_WRITE_LIMIT	Максимальный объём данных, который может быть записан процессом (в Mb).
-u:[user@domain]	SP_USER	Имя пользователя в формате: User[@Domain]
-p:[password]	SP_PASSWORD	Пароль.
-runas:[0|1]	SP_RUNAS	Использовать сервис RunAs для запуска процесса.
-s:[n]	SP_SECURITY_LEVEL	Уровень безопасности. Может принимать значения 0 или 1.
-hr:[0|1]	SP_HIDE_REPORT	Не показывать отчёт.
-ho:[0|1]	SP_HIDE_OUTPUT	Не показывать выходной поток (STDOUT) приложения.
-sr:[file]	SP_REPORT_FILE	Сохранить отчёт в файл.
-so:[file]	SP_OUTPUT_FILE	Сохранить выходной поток в файл.
-i:[file]	SP_INPUT_FILE	Получить входной поток из файла.

Параметры командной строки перекрывают значения переменных окружения.

Формат файла отчёта

[пустая строка]
--------------- Spawner report ---------------
Application:            [Application]
Parameters:             [Parameters]
SecurityLevel:          [SecurityLevel]
CreateProcessMethod:    [CreateProcessMethod]
UserName:               [UserName]
UserTimeLimit:          [UserTimeLimit]
Deadline:               [Deadline]
MemoryLimit:            [MemoryLimit]
WriteLimit:             [WriteLimit]
----------------------------------------------
UserTime:               [UserTime]
PeakMemoryUsed:         [PeakMemoryUsed]
Written:                [Written]
TerminateReason:        [TerminateReason]
ExitStatus:             [ExitStatus]
----------------------------------------------
SpawnerError:           [SpawnerError]

Application - Имя приложения

Parameters - Параметры приложения

SecurityLevel - Уровень защиты. Может быть 0 (по умолчанию) или 1. Уровень 1 включает защиту от:

• Выхода из системы, завершения её работы, перезагрузки или выключения компьютера
• Чтения, записи, стирания буфера обмена
• Изменения системных параметров через SystemParametersInfo
• Изменения параметров экрана через ChangeDisplaySettings
• Создания новых рабочих столов или переключения между ними
• Использования USER-объектов (например, HWND), созданных внешними процессами
• Доступа к общей таблице атомов (global atom table)

CreateProcessMethod - Метод создания процесса. Может быть:

• "CreateProcess" - процесс запускается от текущего пользователя
• "CreateProcessAsUser" - процесс запускается от заданного пользователя.
• "RunAs service" - процесс запускается при помощи сервиса RunAs.

Запуск процесса от другого пользователя требует важных привилегий, а именно:

• SeTcbPrivilege (Работа в режиме операционной системы)
• SeAssignPrimaryTokenPrivilege (Замена маркера уровня процесса)
• SeIncreaseQuotaPrivilege (Увеличение квот)

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

UserName - Имя пользователя, под которым был запущен дочерний процесс, в формате: User[@Domain]

UserTimeLimit - максимальное время в сек. выполнения процесса в пользовательском режиме по истечении

которого процесс прерывается. По умолчанию: "Infinity".

Deadline - Время в сек., которое выделено процессу. По умолчанию: "Infinity". Отличается от TimeLimit тем, что это физическое время. Если процесс непрерывно осуществляет ввод/вывод, находится в состоянии ожидания или система перегружена, то процесс может выполняться неограниченно долго, несмотря на TimeLimit. Для предотвращения данной ситуации нужно установить DeadLine.

MemoryLimit - Максимальный объём выделяемой памяти процессу в Mb. По умолчанию: "Infinity"

WriteLimit - Максимальный объём информации, который может быть записан процессом в Mb. По умолчанию: "Infinity"

UserTime - Фактическое время выполнения процесса в секундах с точностью до 0.01

PeakMemoryUsed - Максимальное использование виртуальной памяти процессом в Mb.

Written - Объём информации, который был записан процессом в Mb.

TerminateReason - Причина завершения процесса. Может быть: "ExitProcess" - процесс завершился нормально "MemoryLimitExceeded" - превышен лимит памяти "TimeLimitExceeded" - превышен лимит времени выполнения (либо TimeLimit, либо Deadline) "WriteLimitExceeded" - превышен лимит записи "AbormalExitProcess" - процесс завершился с исключением (список исключений см. ниже) Если процесс не был завершён, то данному полю соответствует значение ""

ExitStatus - Статус завершения процесса. Может принимать значение кода возврата процесса, либо одной из следующих констант: "AccessViolation" "ArrayBoundsExceeded" "Breakpoint" "Control_C_Exit" "DatatypeMisalignment" "FloatDenormalOperand" "FloatInexactResult" "FloatInvalidOperation" "FloatMultipleFaults" "FloatMultipleTraps" "FloatOverflow" "FloatStackCheck" "FloatUnderflow" "GuardPageViolation" "IllegalInstruction" "InPageError" "InvalidDisposition" "IntegerDivideByZero" "IntegerOverflow" "NoncontinuableException" "PrivilegedInstruction" "RegNatConsumption" "SingleStep" "StackOverflow"

SpawnerError - Текст ошибки при работе spawner'а. Если ошибка не произошла, то полю соотвествует значение ""