KasperskyOS Community Edition 1.3

Утилита cas-inspect

В составе KasperskyOS Community Edition поставляется утилита cas-inspect (исполняемый файл toolchain/bin/cas-inspect), позволяющая получать сведения о содержимом KPA-пакета при работе с SDK.

Синтаксис shell-команды для запуска утилиты cas-inspect:

cas-inspect [-h|--help] [--version] {-i|--input} <PACKAGE> --verify [<COMMAND>] [-o <path>]

Параметры:

  • {-i|--input} <PACKAGE>

    Путь к KPA-пакету (файлу *.kpa).

  • <COMMAND>

    Команды:

    • dump – направляет в стандартный вывод манифест KPA-пакета и сведения о компонентах KPA-пакета, включающие размер в байтах (Size), смещение в байтах (Offset – относительно окончания манифеста KPA-пакета, Absolute – относительно начала KPA-пакета) и контрольную сумму (Digest). Этот параметр применяется по умолчанию.
    • read {manifest|blobs|<hash>} – выводит манифест KPA-пакета (read manifest), содержимое всех компонентов KPA-пакета (read blobs) или одного компонента KPA-пакета с заданной контрольной суммой (read <hash>). При использовании параметра -o <path> осуществляется вывод в файл, иначе – в стандартный вывод.
    • list – направляет в стандартный вывод контрольную сумму, смещение в байтах (относительно начала KPA-пакета) и размер в байтах для всех компонентов KPA-пакета.
    • read-files <FILES>... – выводит содержание компонента KPA-пакета по имени файла компонента. Можно указать несколько имен файлов компонентов KPA-пакета, эти имена следует разделять знаком пробела. При использовании параметра -o <path> осуществляется вывод в файл.
    • list-files – направляет в стандартный вывод список всех имен файлов компонентов KPA-пакета, которые содержатся в манифесте KPA-пакета.
  • -o <path>

    Путь к файлу или директории для сохранения данных при использовании команд read {manifest|blobs|<hash>} и read-files <FILES>.... При выводе манифеста KPA-пакета (read manifest) или содержимого компонента KPA-пакета с заданной контрольной суммой (read <hash>) нужно указать путь к файлу. При выводе содержимого всех компонентов программы (read blobs) нужно указать путь к директории, где каждый компонент программы будет сохранен в отдельном файле с именем, соответствующим контрольной сумме этого компонента. При выводе содержимого всех компонентов KPA-пакета (read-files <FILES>...) нужно указать путь к директории, где каждый компонент KPA-пакета будет сохранен в отдельном файле с именем этого компонента.

  • --verify

    Проверка наличия всех компонентов KPA-пакета, указанных в его манифесте, и отсутствия неуказанных компонентов KPA-пакета, а также расчет контрольных сумм компонентов KPA-пакета и сравнение их с указанными в манифесте KPA-пакета.

  • -h|--help

    Текст справки.

  • --version

    Версия утилиты.

Примеры shell-команд для запуска утилиты cas-inspect:

# Выводит в консоль манифест KPA-пакета и сведения о компонентах # KPA-пакета. cas-inspect -i helloworld.kpa # Выводит в консоль манифест KPA-пакета и сведения о компонентах # KPA-пакета, а также проверяет наличие компонентов KPA-пакета, # указанных в его манифесте, и контрольные суммы компонентов # KPA-пакета. cas-inspect -i helloworld.kpa --verify # Выводит в файл манифест KPA-пакета. cas-inspect -i helloworld.kpa read manifest -o ./manifest # Выводит в файл содержимое компонента KPA-пакета с заданной # контрольной суммой. cas-inspect -i helloworld.kpa read 5d8071308518a7bb003aa084fc995 d2f09b79e9e52f8cd296cb3ee2644ad3951 -o ./comp # Выводит в отдельный файл содержимое каждого компонента KPA-пакета. cas-inspect -i helloworld.kpa read blobs -o . # Выводит в консоль сведения о компонентах KPA-пакета. cas-inspect -i helloworld.kpa list