Введение

Настоящее руководство адресовано разработчикам программного обеспечения для программно-аппаратных систем на базе KasperskyOS. Основную часть руководства составляют следующие сведения:

• Практические руководства (англ. how-to guides), которые представляют собой сведения о действиях разработчика для получения конкретных практических результатов.

  Действия разработчика связаны с использованием:

  • функций и макросов API (язык C);
  • shell-, GDB-, CMake-команд;
  • специальных языков, используемых для автоматической генерации исходного кода.

  Практическое руководство может быть представлено в виде примера кода с пояснениями.

• Справочные материалы (англ. reference guides):
  • сведения об API;
  • синтаксис shell-, GDB-, CMake-команд;
  • синтаксис специальных языков, используемых для автоматической генерации исходного кода;
  • параметры запуска программ;
  • переменные окружения программ;
  • особенности поддержки POSIX;
  • сведения о методах ядра KasperskyOS, используемые при описании политики безопасности.
• Пояснительные материалы о базовых концепциях KasperskyOS (англ. conceptual guides).

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

Содержание разделов руководства

Название раздела	Содержание раздела
О KasperskyOS Community Edition	Общие сведения об SDK, включая системные требования для установки SDK.
Обзор KasperskyOS	Пояснительные материалы о базовых концепциях KasperskyOS: архитектура KasperskyOS; технология Kaspersky Security System; генерация исходного кода из кода на специальных языках; управление взаимодействием процессов между собой и с ядром KasperskyOS; управление доступом к ресурсам; состав загрузочного образа KasperskyOS.
Краткое руководство разработчика решений на базе KasperskyOS	Практическое руководство по разработке решений на базе KasperskyOS с краткими пояснениями и ссылками на другие разделы для быстрой подготовки к разработке под KasperskyOS.
Начало работы	Практические руководства, необходимые для начала работы с SDK: использование Docker-контейнера для установки SDK; установка и удаление SDK; настройка среды разработки; использование расширения KasperskyOS SDK Extension for Visual Studio Code; сборка и запуск примеров;
Разработка под KasperskyOS	Практические руководства: запуск процессов; использование файловых систем и сетевого стека; организация межпроцессного взаимодействия; работа с KPA-пакетами. Справочные материалы: синтаксис специального языка, используемого для настройки параметров запуска и переменных окружения программ, а также топологии межпроцессного взаимодействия; параметры запуска и переменные окружения системной программы, реализующей файловые системы и сетевой стек.
KasperskyOS API	Практические руководства: использование макросов, предназначенных для работы с кодами ошибок в системном и прикладном программном обеспечении; использование API, предоставляемых библиотекой libkos (базовой библиотекой KasperskyOS), в том числе управление доступом на основе модели мандатных ссылок; использование API системной программы, обеспечивающей динамическую настройку топологии межпроцессного взаимодействия. использование программы MessageBus, реализующей шину сообщений. использование программы LogRR для журналирования; использование компонента ExecutionManager для управления процессами; использование компонента PackageManager для управления KPA-пакетами. Справочные материалы: сведения о кодах возврата для системного и прикладного программного обеспечения; сведения об API, предоставляемых библиотекой libkos; особенности поддержки POSIX; сведения об API системной программы, обеспечивающей динамическую настройку топологии межпроцессного взаимодействия.
Сборка решения на базе KasperskyOS	Практические руководства: общая схема сборки; сборка с использованием CMake; использование динамических библиотек. Справочные материалы: синтаксис макросов, используемых при сборке для генерации конструкций на специальном языке, используемом для настройки параметров запуска и переменных окружения программ, а также топологии межпроцессного взаимодействия; синтаксис макроса, используемого при сборке для генерации конструкций на специальном языке, используемом для описания политики безопасности; синтаксис CMake-команд из библиотек CMake, поставляемых в составе SDK; синтаксис shell-команд запуска утилит и скриптов сборки.
Отладка программ в решении на базе KasperskyOS	Практические руководства: отладка с использованием GDB-сервера QEMU; отладка с использование GDB-сервера ядра KasperskyOS на QEMU и на аппаратной платформе; анализ данных обратной трассировки стека при аварийном завершении процесса. Справочные материалы о синтаксисе GDB-команд для работы с процессами и потоками исполнения.
Разработка политик безопасности	Практические руководства: создание спецификаций программ, исполняющихся под управлением KasperskyOS; описание политики безопасности; тестирование политики безопасности; журналирование политики безопасности. Справочные материалы: синтаксис специальных языков, используемых для создания спецификаций программ, исполняющихся под управлением KasperskyOS; синтаксис специального языка, используемого для описания политики безопасности (включая модели безопасности KasperskyOS); синтаксис специального языка, используемого для создания тестов политики безопасности; сведения о методах ядра KasperskyOS, используемые при описании политики безопасности.
Паттерны безопасности при разработке под KasperskyOS	Пояснительные материалы о типовых рисках и угрозах безопасности при разработке ПО, а также описание архитектурных паттернов, применение которых позволит повысить безопасность решения.
Приложения	Список и описание примеров, поставляемых в составе SDK. Справочные материалы о некоторых лимитах, установленных в системе.

В начало