Служба процессов

02 августа 2023

ID kernel_methods_processes

Скачать PDF

Служба предназначена для управления процессами.

Сведения о методах службы приведены в таблице ниже.

Методы службы task.Task (интерфейс kl.core.Task)

Метод

Назначение и параметры метода

Потенциальная опасность метода

Create

Назначение

Создает процесс.

Параметры

[in] name – имя процесса.
[in] eiid – имя класса процесса.
[in] path – имя исполняемого файла в ROMFS.
[in] stackSize – размер стека процесса в байтах.
[in] priority – значение, задающее приоритет начального потока исполнения.
[in] flags – флаги, задающие параметры создания процесса.
[out] child – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует созданный процесс.
[out] rc – код возврата.

Позволяет выполнить следующие действия:

Создать процесс, который будет привилегированным с точки зрения политики безопасности решения (указав имя класса процессов с привилегиями).
Зарезервировать имя процесса, чтобы другой процесс с таким именем нельзя было создать.
Создать процесс, при возникновении необработанного исключения в котором операционная система останавливается.
Загрузить в память процесса код из исполняемого файла для последующего исполнения.
Исчерпать оперативную память, создавая множество процессов.
Исчерпать память ядра, создавая в ней множество объектов.

LoadSeg

Назначение

Загружает сегмент образа программы в память процесса из буфера MDL.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] mdl – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует буфер MDL, содержащий сегмент образа программы.
[in] segAttr – структура, содержащая параметры загрузки сегмента образа программы.
[out] rc – код возврата.
[out] retaddr – базовый адрес региона виртуальной памяти процесса, куда загружен сегмент образа программы.

Позволяет загрузить в память процесса код для последующего исполнения.

SetEntry

Назначение

Задает точку входа процесса.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] entry – точка входа начального потока процесса.
[out] rc – код возврата.

Создает условия для запуска кода, загруженного в память процесса.

LoadElfSyms

Назначение

Загружает таблицу символов и таблицу строк из буферов MDL в память процесса.

Буферы MDL содержат таблицу символов и таблицу строк из незагружаемых сегментов файла ELF. Эти таблицы нужны для получения данных обратной трассировки стека (сведений о стеках вызовов).

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] relocBase – базовый адрес загрузки образа программы.
[in] symMdl – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует буфер MDL, содержащий таблицу символов.
[in] symSegAttr – структура, содержащая параметры загрузки таблицы символов.
[in] symSize – размер таблицы символов в байтах.
[in] strMdl – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует буфер MDL, содержащий таблицу строк.
[in] strSegAttr – структура, содержащая параметры загрузки таблицы строк.
[in] strSize – размер таблицы строк в байтах.
[out] rc – код возврата.

Нет.

SetEnv

Назначение

Загружает параметры процесса в его память.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] env – последовательность, содержащая параметры процесса.
[out] rc – код возврата.

Позволяет исчерпать память ядра, создавая в ней множество объектов.

FreeSelfEnv

Назначение

Освобождает память текущего процесса, занятую параметрами, загруженными методом SetEnv.

Параметры

[out] rc – код возврата.

Нет.

Resume

Назначение

Запускает процесс.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[out] rc – код возврата.

Позволяет выполнить следующие действия:

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

Exit

Назначение

Завершает текущий процесс.

Параметры

[in] status – код завершения текущего процесса.
[out] rc – код возврата.

Нет.

Terminate

Назначение

Завершает процесс.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[out] rc – код возврата.

Позволяет завершить другой процесс при наличии его дескриптора. (Маска прав дескриптора должна разрешать завершение процесса.)

GetExitInfo

Назначение

Позволяет получить сведения о завершенном процессе.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует завершенный процесс.
[out] status – код завершения процесса.
[out] info – объединение, содержащее сведения о завершенном процессе.
[out] rc – код возврата.

Нет.

GetThreadContext

Назначение

Позволяет получить контекст потока исполнения, входящего в процесс, который перешел в "замороженное" состояние в результате необработанного исключения.

В "замороженном" состоянии исполнение процесса прекращается, но его ресурсы не освобождаются, чтобы можно было собрать данные об этом процессе.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс, который находится в "замороженном" состоянии.
[in] index – индекс потока исполнения. Используется для перечисления потоков исполнения. Нумерация начинается с нуля. Нулевой индекс имеет поток исполнения, в котором возникло необработанное исключение.
[out] context – последовательность, содержащая контекст потока исполнения.
[out] rc – код возврата.

Позволяет нарушить изоляцию процесса, который перешел в "замороженное" состояние в результате необработанного исключения. Например, полученный контекст потока исполнения может содержать значения переменных.

GetNextVmRegion

Назначение

Позволяет получить сведения о регионе виртуальной памяти, принадлежащем процессу, который перешел в "замороженное" состояние в результате необработанного исключения.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс, который находится в "замороженном" состоянии.
[in] after – адрес, после которого размещен регион виртуальной памяти.
[out] next – базовый адрес региона виртуальной памяти.
[out] size – размер региона виртуальной памяти в байтах.
[out] flags – флаги, отражающие параметры региона виртуальной памяти.
[out] handle – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует буфер MDL, отображенный на регион виртуальной памяти.
[out] rc – код возврата.

Позволяет нарушить изоляцию процесса, который перешел в "замороженное" состояние в результате необработанного исключения. Изоляция нарушается, так как открывается доступ к региону памяти процесса.

TerminateAfterFreezing

Назначение

Завершает процесс, который перешел в "замороженное" состояние в результате необработанного исключения.

В "замороженном" состоянии исполнение процесса прекращается, но его ресурсы не освобождаются, чтобы можно было собрать данные об этом процессе. Процесс в "замороженном" состоянии не может быть повторно запущен, он может быть только завершен.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс, который находится в "замороженном" состоянии.
[out] rc – код возврата.

Позволяет завершить процесс, который перешел в "замороженное" состояние в результате необработанного исключения. Это не позволит собрать данные об этом процессе для диагностики.

GetName

Назначение

Позволяет получить имя текущего процесса.

Параметры

[out] name – имя процесса.
[out] rc – код возврата.

Нет.

GetPath

Назначение

Позволяет получить имя исполняемого файла, из которого запущен текущий процесс.

Параметры

[out] path – имя исполняемого файла в ROMFS.
[out] rc – код возврата.

Нет.

GetInitialThreadPriority

Назначение

Позволяет получить приоритет начального потока процесса.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[out] priority – значение, отражающее приоритет начального потока исполнения.
[out] rc – код возврата.

Нет.

SetInitialThreadPriority

Назначение

Задает приоритет начального потока процесса.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] priority – значение, задающее приоритет начального потока исполнения.
[out] rc – код возврата.

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

Рекомендуется контролировать приоритет начального потока исполнения.

GetTasksList

Назначение

Позволяет получить сведения о существующих процессах.

Параметры

[out] notice – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует приемник уведомлений, который настроен на получение уведомлений о завершении процессов.
[out] strings – последовательность, содержащая параметры процессов.
[out] sids – последовательность, содержащая идентификаторы безопасности процессов (SID каждого процесса).
[out] count – число процессов.
[out] rc – код возврата.

Позволяет исчерпать память ядра, создавая в ней множество объектов.

SetInitialThreadSchedPolicy

Назначение

Задает класс планирования и приоритет начального потока процесса.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] policy – значение, задающее класс планирования начального потока исполнения.
[in] priority – значение, задающее приоритет начального потока исполнения.
[in] params – объединение, содержащее параметры класса планирования начального потока исполнения.
[out] rc – код возврата.

Позволяет выполнить следующие действия:

Сделать начальный поток процесса потоком исполнения реального времени, который заберет все процессорное время у остальных потоков исполнения, в том числе из других процессов (рекомендуется контролировать класс планирования начального потока исполнения).
Повысить приоритет начального потока процесса, чтобы сократить процессорное время, доступное остальным потокам исполнения, в том числе из других процессов (рекомендуется контролировать приоритет начального потока исполнения).

ReseedAslr

Назначение

Задает начальный вектор в генераторе случайных чисел для поддержки ASLR.

Влияет на результаты вызова метода Allocate службы виртуальной памяти в контексте заданного процесса.

Параметры

[in] task – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует процесс.
[in] seed – последовательность, содержащая начальный вектор для генерации случайных чисел.
[out] rc – код возврата.

Нет.

Вам помогла эта статья?

Что нам нужно улучшить?

Спасибо за ваш отзыв, вы помогаете нам становиться лучше!