Утилита qemu-img#

Утилита qemu-img используется для создания, конвертирования и изменения образов дисков в автономном режиме.

Синтаксис qemu-img:

qemu-img <options> <commands> <commands_options>

Где:

  • <options> - опции;

  • <commands> - команды;

  • <commands_options> - опции команд.

Часто используемые опции утилиты представлены в таблице ниже.

Опция

Описание

-h,  --help

Отображение справки и завершение работы

-V,  --version

Отображение информации о версии и завершение работы

-T,  --trace <<enable=>PATTERN><,events=FILE><,file=FILE>

Настройка параметров трассировки, где <enable=>PATTERN> - включение шаблона сопоставления событий, events=FILE - включение перечисленных в указанном файле событий, file=FILE - трассировка вывода журнала в файл

Примеры поддерживаемых команд:

  • Изменение или добавления опций к существующему в файловой системе объекту:

    amend [--object OBJECTDEF] [--image-opts] [-p] [-q] [-f FMT] [-t CACHE] [--force] -o OPTIONS FILENAME

    Где:

    • --object OBJECTDEF - созданный объект;

    • --image-opts - указание на то, что параметр FILENAME следует интерпретировать как полную строку параметров, а не как простое имя файла;

    • -p - отображение индикатора выполнения;

    • -q - «тихий режим» - без вывода выходных данных, кроме ошибок;

    • -f FMT - задание формата образа диска;

    • -t CACHE - режим кеширования;

    • --force - допущение небезопасных операций, которые могут привести к потере данных;

    • -o OPTIONS - параметры, применяемые к объекту;

    • FILENAME - имя файла образа диска.

  • Конвертация файлов из одного формата в другой:

    convert [--object OBJECTDEF] [--image-opts] [--target-image-opts] [--target-is-zero] [--bitmaps] [-U] [-C] [-c] [-p] [-q] [-n] [-f FMT] [-t CACHE] [-T SRC_CACHE] [-O OUTPUT_FMT] [-B BACKING_FILE [-F BACKING_FMT]] [-o OPTIONS] [-l SNAPSHOT_PARAM] [-S SPARSE_SIZE] [-r RATE_LIMIT] [-m NUM_COROUTINES] [-W] [--salvage] FILENAME [FILENAME2 [...]] OUTPUT_FILENAME

    Где:

    • --target-image-opts - указание, что параметры OUTPUT_FILENAME следует интерпретировать как полные строки параметров, а не как простое имя файла;

    • --target-is-zero - указание, что целевой образ должен быть нулевым;

    • --bitmaps - дополнительное копирование всех постоянных матриц бит с верхнего уровня источника;

    • -U - режим общего доступа для образа;

    • -C - использование разгрузки копирования для перемещения данных из исходного образа в целевой;

    • -c - создание моментального снимка;

    • -n - пропуск создания целевого тома;

    • -T SRC_CACHE - определение режима кеширования для исходных файлов;

    • -O OUTPUT_FMT - указание формата вывода;

    • -B BACKING_FILE [-F BACKING_FMT] - указание на файл, используемый в качестве основы для вывода;

    • -l SNAPSHOT_PARAM - указание на параметры снимка;

    • -S SPARSE_SIZE - указание размера разреженного образа;

    • -r RATE_LIMIT - ограничение скорости конвертации;

    • -m NUM_COROUTINES - количество подпрограмм;

    • -W - разрешение неупорядоченной записи в назначение;

    • --salvage - игнорирование ошибок ввода-вывода при чтении;

    • OUTPUT_FILENAME - имя файла образа диска назначения.

  • Создание нового файла образа диска:

    create [--object OBJECTDEF] [-q] [-f FMT] [-b BACKING_FILE [-F BACKING_FMT]] [-u] [-o OPTIONS] FILENAME [SIZE]

    Где:

    • -b BACKING_FILE [-F BACKING_FMT] - указание файла, используемого в качестве основы для создания нового образа;

    • -u - включение режима небезопасного файла резервной копии - образ будет создан, даже если соответствующий файл резервной копии не может быть открыт;

    • SIZE - размер создаваемого образа.

  • Отображение информации об образе диска FILENAME:

    info [--object OBJECTDEF] [--image-opts] [-f FMT] [--output=OFMT] [--backing-chain] [-U] FILENAME

    Где:

    • --output=OFMT - указание формата вывода;

    • --backing-chain - предоставление информации о резервных копиях файлов в цепочке образов дисков.

Примеры использования#

  • Для создания образа диска image_name.img размером 10 Гб введите команду:

    qemu-img create image_name.img 10G

  • Для отображения информации об образе диска image_name.img введите команду:

    qemu-img info image_name.img

  • Для преобразования образа диска VMware .vmdk в образ диска KVM .qcow2 введите команду:

    qemu-img convert -f vmdk -O qcow2 path/to/file/file.vmdk path/to/file/file.qcow2

    Где path/to/file/file.vmdk и path/to/file/file.qcow2 - файлы - цель и назначение соответственно.