Модуль разрабатывается как часть системы организации соревнований Cats. Модуль поддерживает различные режимы совместимости. Режим совместимости задается ключом --legacy или переменной окружения SP_LEGACY. Доступные значения можно посмотреть в списке поддерживаемых систем. Значение по-умолчанию sp00. Справку по каждой из них можно получить запустив модуль с ключом --help или -h.

git clone git@github.com:klenin/Spawner.git
cd Spawner
git submodule init
git submodule update
mkdir build
cd build
cmake ..
sp.sln

Visual Studio 2013+ solution sp.sln will be generated in ./Spawner/build.

There are numerous gcc distributions for windows.

• MinGW has not been updated for long and has this bug which prevents project from being compiled.
• MinGW-w64 has not been tested
• Nuwen MinGW is supported
• MSYS2 is supported

Basic steps are the same:

git clone git@github.com:klenin/Spawner.git
cd Spawner
git submodule init
git submodule update
mkdir build
cd build

Now g++ and make must be in your PATH.

With Nuwen-MinGW you might need to use

set LIB=C:\Nuwen-MinGW\MinGW\x86_64-w64-mingw32\lib

in order for cmake to find libuserenv.

With MinGW use:

cmake -G "MinGW Makefiles" -D CMAKE_CXX_COMPILER=g++.exe -D CMAKE_MAKE_PROGRAM=make.exe ..
make

And with MSYS2:

cmake -G "MSYS Makefiles"  -D CMAKE_CXX_COMPILER=g++ -D CMAKE_MAKE_PROGRAM=make ..
make

Изначальная версия sp взятая за основу этого проекта.

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

                                                                                                                  |

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

Формат файла отчета.

[пустая строка]
--------------- 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" * "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 - Фактическое время выполнения процесса в сек. с точностью до 10e-3.

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

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

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

• 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'а. Если ошибка не произошла, то полю соответствует значение ""

Examples:

  sp -t 10s -m 32M -i 10s a.exe
  sp -d "C:\My Directory" a.exe
  sp -l invoker -p password a.exe
  sp -i input.txt -o output.txt -e error.txt a.exe