Утилита cas-inspect

В составе Kaspersky IoT Secure Gateway 1000 SDK поставляется утилита cas-inspect (исполняемый файл toolchain/bin/cas-inspect), позволяющая получать сведения о содержимом KPA-пакетов программ. KPA-пакет программы состоит из манифеста программы и компонентов программы. Компонентом программы может быть исполняемый файл, динамическая библиотека, текстовые данные с параметрами, а также любые другие данные, которые требуются для работы программы.

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

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

[COMMAND] [-o <path>]

Параметры:

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

  Путь к KPA-пакету программы (файлу *.kpa). KPA-пакет программы должен быть в несжатом формате. KPA-пакет программы в сжатом формате (файл *.kpac) нужно предварительно преобразовать в несжатый формат архиватором.

• COMMAND

  Команды:

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

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

• --verify

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

• -h|--help

  Выводит текст справки.

• --version

  Выводит версию утилиты.

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

# Выводит в консоль манифест программы и сведения о компонентах

# программы.

cas-inspect -i helloworld.kpa

# Выводит в консоль манифест программы и сведения о компонентах

# программы, а также проверяет наличие компонентов программы,

# указанных в манифесте программы, и контрольные суммы

# компонентов программы.

cas-inspect -i helloworld.kpa --verify

# Выводит в файл манифест программы.

cas-inspect -i helloworld.kpa read manifest -o ./manifest

# Выводит в файл содержимое компонента программы с заданной

# контрольной суммой.

cas-inspect -i helloworld.kpa read 5d8071308518a7bb003aa084fc995

d2f09b79e9e52f8cd296cb3ee2644ad3951 -o ./comp

# Выводит в отдельный файл содержимое каждого компонента программы.

cas-inspect -i helloworld.kpa read blobs -o .

# Выводит в консоль сведения о компонентах программы.

cas-inspect -i helloworld.kpa list