Компонент ExecutionManager

API определен в заголовочных файлах, расположенных в директории sysroot-*-kos/include/component/execution_manager/ из состава SDK.

Сценарий использования компонента ExecutionManager описан в статье "Запуск процесса с помощью KasperskyOS API".

Интерфейс execution_manager_proxy.h

API определен в заголовочном файле sysroot-*-kos/include/component/execution_manager/kos_ipc/execution_manager_proxy.h

Интерфейс содержит фабричный метод CreateExecutionManager() для получения указателя на экземпляр интерфейса IExecutionManager, необходимого для работы с компонентом ExecutionManager.

Пример использования:

client.cpp

#include <component/execution_manager/kos_ipc/execution_manager_proxy.h>

...

namespace execmgr = execution_manager;

int main(int argc, const char *argv[])

{

// ...

execmgr::IExecutionManagerPtr ptr;

// имя IPC-канала для соединения с процессом ExecutionManager. Должно совпадать со значением MAIN_CONN_NAME в файле CMakeLists.txt для сборки ExecutionManager.

char mainConnection[] = "ExecMgrEntity";

execmgr::ipc::ExecutionManagerConfig cfg{mainConnection};

if (CreateExecutionManager(cfg, ptr) != eka::sOk)

{

std::cerr << "Cannot create execution manager" << std::endl;

return EXIT_FAILURE;

}

// ...

}

Интерфейс IExecutionManager

API определен в заголовочном файле sysroot-*-kos/include/component/execution_manager/i_execution_manager.h

Интерфейс IExecutionManager позволяет получить доступ к указателям на следующие интерфейсы:

Пример использования:

client.cpp

int main(int argc, const char *argv[])

{

// ...

execmgr::IApplicationControllerPtr ac;

if (ptr->GetApplicationController(ac) != eka::sOk)

{

std::cerr << "Cannot get application controller" << std::endl;

return EXIT_FAILURE;

}

execmgr::ISystemControllerPtr sc;

if (ptr->GetSystemController(sc) != eka::sOk)

{

std::cerr << "Cannot get system controller" << std::endl;

return EXIT_FAILURE;

}

// ...

}

Интерфейс IApplicationController

API определен в заголовочном файле sysroot-*-kos/include/component/execution_manager/i_application_control.h

Интерфейс IApplicationController предоставляет следующие методы, позволяющие изменять состояние процесса:

Метод StartEntity() принимает путь к исполняемому файлу, который нужно запустить, а также структуру с параметрами запуска процесса StartEntityInfo; а возвращает структуру с результатами запуска процесса StartEntityResultInfo. Все поля структуры StartEntityInfo являются опциональными для инициализации.

Остальные методы принимают структуру EntityId, идентифицирующую запущенный процесс.

struct IApplicationController

{

// Все поля структуры StartEntityInfo являются опциональными для инициализации.

struct StartEntityInfo

{

// Имя процесса. Если не указано, то будет использовано имя класса процесса.

// Если не указано имя класса процесса, то будет использовано имя исполняемого файла.

std::string entityName;

// Класс процесса. Если не указан, то будет использовано имя процесса. Если не указано имя процесса, то будет использовано имя исполняемого файла.

std::string eiid;

std::vector<std::string> args; // Аргументы командной строки.

std::vector<std::string> envs; // Переменные окружения.

// Политика перезапуска процесса при его аварийном завершении. Возможные значения:

// EntityRestartPolicy::DoNotRestart - не перезапускать.

// EntityRestartPolicy::AlwaysRestart - всегда перезапускать.

EntityRestartPolicy restartPolicy { EntityRestartPolicy::DoNotRestart };

};

struct StartEntityResultInfo

{

std::string eiid; // Класс безопасности, присвоенный процессу.

EntityId entId; // Структура, идентифицирующая запущенный процесс.

Uid sid; // Идентификатор безопасности запущенного процесса.

std::string taskName; // Имя запущенного процесса.

};

};

Пример использования:

client.cpp

int main(int argc, const char *argv[])

{

// ...

const fs::path appPath{"/application"};

execmgr::IApplicationController::StartEntityResultInfo result;

execmgr::IApplicationController::StartEntityInfo info;

info.entityName = std::string{"application.Application"};

info.eiid = std::string{"application.Application"};

info.args = std::vector<std::string>{"1", "ARG1", "ARG2" , "ARG3"};

info.envs = std::vector<std::string>{"ENV1=10", "ENV2=envStr"};

std::cout << "Starting application from elf\n";

if (ac->StartEntity(appPath, info, result) != eka::sOk)

{

std::cerr << "Can not start application from " << appPath << std::endl;

return EXIT_FAILURE;

}

std::cout << "Application started with process sid " << result.sid << "\n";

auto AppId = result.entId;

if (ac->StopEntity(AppId) != eka::sOk)

{

std::cerr << "Cannot stop process " << appPath << std::endl;

return EXIT_FAILURE;

}

// ...

}

Интерфейс ISystemController

API определен в заголовочном файле sysroot-*-kos/include/component/execution_manager/i_system_control.h

Интерфейс ISystemController предоставляет следующий метод для управления системой:

Пример использования:

client.cpp

int main(int argc, const char *argv[])

{

// ...

if (sc->StopAllEntities() != eka::sOk)

{

std::cerr << "Cannot stop all processes\n";

return EXIT_FAILURE;

}

// ...

}

В начало