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

Службы предназначены для работы с файловой системой 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, содержащий произвольные программы и данные.
  • Получить доступ на чтение к некоторым объектам ядра.

В начало