Службы файловой системы

Службы предназначены для работы с файловой системой ROMFS, используемой ядром KasperskyOS.

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

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

Метод	Назначение и параметры метода	Потенциальная опасность метода
`Open`	Назначение Открывает файл. Параметры [in] `name` – имя файла. [out] `handle` – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует открытый файл. [out] `rc` – код возврата.	Позволяет исчерпать память ядра, создавая в ней множество объектов.
`Close`	Назначение Закрывает файл. Параметры [in] `handle` – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует открытый файл. [out] `rc` – код возврата.	Нет.
`Read`	Назначение Читает данные из файла. Параметры [in] `handle` – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует открытый файл. [in] `sectorNumber` – номер блока данных. Нумерация начинается с нуля. [out] `read` – размер считанных данных в байтах. [out] `data` – последовательность, содержащая считанные данные. [out] `rc` – код возврата.	Нет.
`GetSize`	Назначение Позволяет получить размер файла. Параметры [in] `handle` – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует открытый файл. [out] `size` – размер файла в байтах. [out] `rc` – код возврата.	Нет.
`GetId`	Назначение Позволяет получить уникальный идентификатор файла. Параметры [in] `handle` – значение, двоичное представление которого состоит из нескольких полей, включая поле дескриптора и поле маски прав дескриптора. Дескриптор идентифицирует открытый файл. [out] `id` – уникальный идентификатор файла. [out] `rc` – код возврата.	Нет.
`Count`	Назначение Позволяет получить число файлов в файловой системе. Параметры [out] `count` – число файлов в файловой системе. [out] `rc` – код возврата.	Нет.
`GetInfo`	Назначение Позволяет получить имя и уникальный идентификатор файла по индексу файла. Параметры [in] `index` – индекс файла. Нумерация начинается с нуля. [in] `nameLenMax` – размер буфера для сохранения имени файла. [out] `name` – имя файла. [out] `id` – уникальный идентификатор файла. [out] `rc` – код возврата.	Нет.
`GetFsSize`	Назначение Позволяет получить размер файловой системы. Параметры [out] `fsSize` – размер файловой системы в байтах. [out] `rc` – код возврата.	Нет.

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

Метод	Назначение и параметры метода	Потенциальная опасность метода
`Change`	Назначение Меняет образ файловой системы. Вместо образа ROMFS, созданного при сборке решения, будет использоваться другой образ ROMFS, загруженный в память процесса. Параметры [in] `base` – указатель на образ файловой системы. [in] `size` – размер образа файловой системы в байтах. [out] `rc` – код возврата.	Позволяет выполнить следующие действия: Использовать образ ROMFS, содержащий произвольные программы и данные. Получить доступ на чтение к некоторым объектам ядра.

Метод

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

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

Change

Назначение

Меняет образ файловой системы.

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

Параметры

[in] base – указатель на образ файловой системы.
[in] size – размер образа файловой системы в байтах.
[out] rc – код возврата.

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

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

В начало