Управление QEMU

Копирование образа Kaspersky IoT Secure Gateway 1000 для запуска QEMU

Команда kosctl emu init [OPTIONS] FIRMWARE_NAME [TARGET_DIR] выполняет копирование образа Kaspersky IoT Secure Gateway 1000 с типом FIRMWARE_NAME для запуска в QEMU в директорию TARGET_DIR – по умолчанию установлено значение текущей директории. Вы можете получить список доступных типов образов с помощью команды kosclt emu list-firmware.

Запуск и остановка QEMU

Команда kosctl emu start [OPTIONS] запускает образ KasperskyOS в QEMU. Доступные параметры команды:

• --emu-binary, -eb

  Путь до бинарного файла QEMU. По умолчанию, поиск бинарного файла осуществляется в установленном SDK по пути /opt/KasperskyOS-SDK-KISG-Platform-<version>/toolchain/bin/qemu-system-[TARGET], где TARGET – целевая платформа для запуска, получаемая из файла с флагами запуска QEMU. Этот файл обычно находится в одной директории с образом KasperskyOS и обнаруживается автоматически.

• --os-image, -i

  Путь до QEMU образа KasperskyOS. Этот параметр является обязательным.

• --name, -n

  Имя запускаемого экземпляра QEMU. По умолчанию присваивается случайный идентификатор.

• --detach, -d

  Флаг для запуска QEMU в фоновом режиме.

• --emu-flags, -ef

  Дополнительные флаги QEMU.

• --kos-kds-port

  Порт для запуска сервера KDS в QEMU. По умолчанию устанавливается значение 25014.

• --preserve-disk

  Флаг, запрещающий модификацию образа диска, помещая изменения во временные файлы. По умолчанию все изменения вносятся в образ диска.

• --freeze, -S

  Флаг, запускающий эмулятор QEMU в остановленном на моменте запуска Kaspersky IoT Secure Gateway 1000 состоянии. Эмулятор ожидает подключения отладчика или ввода команды cont.

• --rm

  Флаг, включающий удаление этого экземпляра QEMU из списка kosctl emu list после остановки эмуляции.

• --port, -p

  Сопоставление портов хостовой и эмулируемой ОС в формате <порт_хостовой_ОС>:<порт_эмулироемой_ОС>[/протокол]. Может быть использован несколько раз для сопоставления нескольких портов.

• --cmd-file

  Путь до файла в формате TXT, содержащего команды запуска QEMU, разделенные символом ;. По умолчанию выполняется поиск в директории с QEMU образом с именем <os_image_path>.qemu.txt.

• --netdump

  Путь до директории, в которой требуется хранить журнал сетевой активности. По умолчанию журнал хранится в директории с эмулятором QEMU.

• --nographic, -ng

  Флаг, запускающий эмулятор QEMU без графического интерфейса.

• --playbook

  Путь до файла, содержащего набор KDS-команд для выполнения в KasperskyOS. Если в образе уже используется файл с набором KDS-команд, параметр --playbook заменит этот файл на указанный. Исключает использование параметра --no-playbook.

• --no-playbook

  Не использовать файл с набором KDS-команд. Исключает использование параметра --playbook.

• --kds-param

  Дополнительные параметры KDS в формате ключ=значение. Может быть использован несколько раз для передачи нескольких параметров KDS.

• --assume-yes, -y

  Флаг, отправляющий команду yes в случае запуска эмулятора QEMU с отключенным интерактивным взаимодействием.

Команда kosctl emu stop [OPTIONS] [NAME] останавливает запущенный экземпляр QEMU с именем NAME. Для этой команды доступны только общие параметры.

Вывод списка запущенных с помощь kosctl экземпляров QEMU

Команда kosctl emu list [OPTIONS] выводит список экземпляров QEMU, запущенных с помощью инструмента kosctl. Для этой команды доступен параметр --json – вывод информации об эмуляторах в формате JSON.

В результате работы команды kosctl emu list будет выведет список экземпляров QEMU в виде таблицы, содержащей следующую информацию:

• имя экземпляра QEMU;
• IP-адрес;
• номер порта;
• идентификатор;
• путь до образа QEMU;
• текущее состояние экземпляра QEMU – запущен или остановлен.

Вывод журнала работы QEMU

Команда kosctl emu log [OPTIONS] [NAME] выводит журнал работы экземпляра QEMU с именем NAME в терминал. Для этой команды доступны следующие параметры:

• --follow, -f

  Флаг для вывода журнала в реальном времени.

• --lines, -n

  Вывод указанного количества последних строк журнала. Вы можете указать значение 0 для вывода всех строк.

Удаление экземпляров QEMU

Команда kosctl emu rm [OPTIONS] [NAME] удаляет экземпляр QEMU с именем NAME. Доступные параметры команды:

• --force, -f

  Флаг, позволяющий остановить и удалить экземпляр QEMU, если он запущен.

• --stopped

  Удалить все остановленные экземпляры QEMU.