qemu-img

ПРОГРАММА:

ИМЯ

qemu-img - утилита создания образа диска QEMU

СИНТАКСИС

использование: команда qemu-img [параметры команды]

ОПИСАНИЕ

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

Внимание! Никогда не используйте qemu-img для изменения изображений, используемых работающей виртуальной машиной или любыми другими
другой процесс; это может испортить изображение. Также имейте в виду, что при запросе изображения, которое
изменение другим процессом может привести к несогласованному состоянию.

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ, НЕ ВКЛЮЧЕННЫЕ В ПАКЕТ

Поддерживаются следующие команды:

проверка [-Q] [-ф FMT] [--output =часто] [-р [утечки | все]] [-Т src_cache] имя файла
Создайте [-Q] [-ф FMT] [-или же кредита] имя файла [размер]
совершать [-Q] [-ф FMT] [-т кэш] [-б Использование темпера с изогнутым основанием] [-д] [-п] имя файла
сравнить [-ф FMT] [-Ф FMT] [-Т src_cache] [-п] [-Q] [-с] имя_файла1 имя_файла2
конвертировать [-с] [-п] [-Q] [-N] [-ф FMT] [-т кэш] [-Т src_cache] [-О выход_фмт] [-или же
кредита] [-с snapshot_id_or_name] [-л snapshot_param] [-С разреженный_размер] имя файла [имя_файла2
[...]] имя выходного файла
info [-ф FMT] [--output =часто] [--поддерживающая цепочка] имя файла
карта [-ф FMT] [--output =часто] имя файла
снимок [-Q] [-л | -a снимок | -c снимок | -d снимок] имя файла
перебазировать [-Q] [-ф FMT] [-т кэш] [-Т src_cache] [-п] [-у] -b резервный_файл [-Ф backing_fmt]
имя файла
изменить размер [-Q] имя файла [+ | -]размер
изменить [-п] [-Q] [-ф FMT] [-т кэш] -o кредита имя файла

Параметры команды:

имя файла
имя файла образа диска

FMT это формат образа диска. В большинстве случаев это угадывается автоматически. См. Ниже
описание поддерживаемых форматов дисков.

- опорная цепь
перечислит информацию о резервных файлах в цепочке образов диска. См. Ниже для
дальнейшее описание.

размер
размер образа диска в байтах. Необязательные суффиксы «k» или «K» (килобайт, 1024) «M»
(мегабайт, 1024 Кбайт) и "G" (гигабайт, 1024 Мбайт) и T (терабайт, 1024 Гбайт).
«b» игнорируется.

имя выходного файла
имя файла образа целевого диска

выход_фмт
формат назначения

кредита
- это список параметров формата, разделенных запятыми, в формате имя = значение. Используйте "-o"
? "для обзора опций, поддерживаемых используемым форматом, или посмотрите формат
описания ниже для деталей.

snapshot_param
- параметр, используемый для внутреннего снимка, формат: 'snapshot.id = [ID], snapshot.name = [NAME]'
или "[ID_OR_NAME]"

snapshot_id_or_name
устарело, используйте вместо него snapshot_param

-c указывает, что целевое изображение должно быть сжато (только формат qcow)

-h с командой или без нее показывает справку и перечисляет поддерживаемые форматы

-p отображать индикатор выполнения (только для команд сравнения, преобразования и переназначения). Если -p опция
не используется для команды, которая его поддерживает, о ходе выполнения сообщается, когда процесс
получает сигнал «SIGUSR1».

-q Тихий режим - не выводить никаких результатов (кроме ошибок). В случае, если нет индикатора выполнения
изоферменты печени -q , так и -p используются варианты.

-S размер
указывает последовательное количество байтов, которые должны содержать только нули для qemu-img, чтобы
создавать разреженное изображение во время преобразования. Это значение округляется до ближайшего 512.
байтов. Вы можете использовать суффиксы общего размера, такие как «k» для килобайт.

-t кэш
указывает режим кеширования, который следует использовать с (целевым) файлом. Увидеть
документация по параметру эмулятора "-drive cache = ..." для допустимых значений.

-T src_cache
определяет режим кеширования, который должен использоваться с исходным файлом (ами). Увидеть
документация по параметру эмулятора "-drive cache = ..." для допустимых значений.

Параметры для подкоманды моментального снимка:

снимок
это имя снимка, который нужно создать, применить или удалить

-a применяет снимок (вернуть диск в сохраненное состояние)

-c создает снимок

-d удаляет снимок

-l перечисляет все снимки в данном изображении

Параметры для сравнения подкоманды:

-f Формат первого изображения

-F Второй формат изображения

-s Строгий режим - сбой при другом размере изображения или выделении секторов

Параметры для преобразования подкоманды:

-n Пропустить создание целевого тома

Описание команды:

проверка [-ф FMT] [--output =часто] [-р [утечки | все]] [-Т src_cache] имя файла
Выполните проверку целостности образа диска имя файла. Команда может выводиться в
формат часто который имеет значение "human" или "json".

Если указан "-r", qemu-img пытается исправить любые несоответствия, обнаруженные во время
проверить. "-r leaks" устраняет только кластерные утечки, тогда как "-r all" исправляет все виды
ошибок, с повышенным риском выбрать неправильное исправление или скрыть повреждение, которое
уже произошло.

Только форматы qcow2, qed и vdi поддерживают проверку согласованности.

Если в образе нет несоответствий, отметьте выход с 0. Другой выход
коды указывают на вид обнаруженного несоответствия или возникновение другой ошибки. В
В следующей таблице приведены все коды выхода подкоманды check:

0 Проверка завершена, изображение (сейчас) соответствует

1 Проверка не завершена из-за внутренних ошибок

2 Проверка завершена, изображение повреждено

3 Проверка завершена, в образе просочились кластеры, но он не поврежден.

63 Проверки не поддерживаются форматом изображения

Если указан "-r", коды выхода, представляющие состояние изображения, относятся к состоянию после
(попытка) его починить. То есть успешное "-r all" даст код выхода.
0, независимо от предыдущего состояния изображения.

Создайте [-ф FMT] [-или же кредита] имя файла [размер]
Создайте новый образ диска имя файла размера размер и формат FMT. В зависимости от файла
формат, вы можете добавить один или несколько кредита которые включают дополнительные функции этого
формат.

Если вариант резервный_файл указано, то изображение будет записывать только
отличия от резервный_файл. В этом случае размер указывать не нужно.
резервный_файл никогда не будет изменен, если вы не используете команду монитора "commit" (или
коммит qemu-img).

Размер также можно указать с помощью размер вариант с "-o", это не обязательно
указывается отдельно в этом случае.

совершать [-Q] [-ф FMT] [-т кэш] [-б Использование темпера с изогнутым основанием] [-д] [-п] имя файла
Зафиксируйте изменения, записанные в имя файла в его базовом образе или резервном файле. Если
файл резервной копии меньше, чем снимок, тогда размер файла резервной копии будет изменен на
того же размера, что и снимок. Если снимок меньше файла резервной копии,
резервный файл не будет усечен. Если вы хотите, чтобы резервный файл соответствовал размеру
снимок меньшего размера, вы можете безопасно обрезать его самостоятельно после операции фиксации
успешно завершается.

Изображение имя файла очищается после успешного выполнения операции. Если тебе не нужно
имя файла после этого и собираетесь бросить, вы можете пропустить опорожнение имя файла by
указав флаг "-d".

Если цепочка поддержки данного файла изображения имя файла имеет более одного слоя,
резервный файл, в котором будут зафиксированы изменения, может быть указан как Использование темпера с изогнутым основанием (который
должен быть частью имя файлаподдерживающая цепочка). Если Использование темпера с изогнутым основанием не указано, немедленное
резервный файл верхнего изображения (который имя файла) будет использоваться. По причинам
согласованность с явным указанием Использование темпера с изогнутым основанием всегда будет означать "-d" (так как очистка
изображение после фиксации в файле косвенной поддержки приведет к тому, что другие данные будут
читать с изображения из-за содержимого в промежуточной цепочке поддержки, перекрывающей
цель фиксации).

сравнить [-ф FMT] [-Ф FMT] [-Т src_cache] [-п] [-с] [-Q] имя_файла1 имя_файла2
Убедитесь, что два изображения имеют одинаковое содержимое. Вы можете сравнивать изображения с разными
формат или настройки.

Формат проверяется, если вы не укажете его -f (используется для имя_файла1) и / или -F (используемый
для имя_файла2) вариант.

По умолчанию изображения разного размера считаются идентичными, если изображение большего размера
содержит только нераспределенные и / или обнуленные секторы в области после конца другого
изображение. Кроме того, если какой-либо сектор не выделен в одном изображении и содержит только ноль
байтов во втором, он оценивается как равный. Вы можете использовать строгий режим,
указав -s вариант. Когда сравнение выполняется в строгом режиме, оно не выполняется в случае, если изображение
размер отличается или сектор выделен на одном изображении и не выделен на втором
вариант.

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

Сравните выходы с 0, если изображения равны, и с 1, если изображения
различаются. Другие коды выхода означают, что во время выполнения произошла ошибка, и стандартная ошибка
вывод должен содержать сообщение об ошибке. В следующей таблице приведены все коды выхода.
подкоманды compare:

0 Изображения идентичны

1 Изображения различаются

2 Ошибка при открытии изображения

3 Ошибка при проверке распределения секторов

4 Ошибка чтения данных

конвертировать [-с] [-п] [-N] [-ф FMT] [-т кэш] [-Т src_cache] [-О выход_фмт] [-или же кредита] [-с
snapshot_id_or_name] [-л snapshot_param] [-С разреженный_размер] имя файла [имя_файла2 [...]]
имя выходного файла
Конвертируйте образ диска имя файла или снимок snapshot_param(snapshot_id_or_name is
устарело) в образ диска имя выходного файла используя формат выход_фмт, Может быть
возможно сжатие (опция "-c") или использование любых параметров конкретного формата, таких как шифрование
(опция "-o").

Только форматы «qcow» и «qcow2» поддерживают сжатие. Сжатие доступно только для чтения.
Это означает, что если сжатый сектор перезаписывается, то он перезаписывается как
несжатые данные.

Преобразование изображений также полезно для получения меньшего изображения при использовании расширяемого формата, такого как
как «qcow»: пустые секторы обнаруживаются и подавляются в целевом изображении.

разреженный_размер указывает последовательное количество байтов (по умолчанию 4 КБ), которые должны
содержат только нули для qemu-img для создания разреженного изображения во время преобразования. Если
разреженный_размер равно 0, источник не будет сканироваться на предмет незанятых или нулевых секторов, и
целевое изображение всегда будет полностью выделено.

Вы можете использовать резервный_файл опция для принудительного создания выходного изображения как копии
при записи образа указанного базового образа; в резервный_файл должно быть то же самое
содержимое в качестве базового изображения входных данных, однако путь, формат изображения и т. д. могут отличаться.

Если указан параметр «-n», создание целевого тома будет пропущено. Это
полезно для таких форматов, как "rbd", если целевой том уже был создан с помощью
специфичные для сайта параметры, которые не могут быть предоставлены через qemu-img.

info [-ф FMT] [--output =часто] [--поддерживающая цепочка] имя файла
Дайте информацию об образе диска имя файла. Используйте его, в частности, чтобы узнать размер
зарезервировано на диске, размер которого может отличаться от отображаемого. Если снимки ВМ
хранятся в образе диска, они тоже отображаются. Команда может выводить в формате
часто который имеет значение "human" или "json".

Если образ диска имеет цепочку резервных файлов, информация о каждом образе диска в
цепочку можно рекурсивно перечислить с помощью опции "--backing-chain".

Например, если у вас есть цепочка изображений вроде:

base.qcow2 <- snap1.qcow2 <- snap2.qcow2

Чтобы перечислить информацию о каждом образе диска в приведенной выше цепочке, начиная с вершины
к базе, сделать:

информация о qemu-img --backing-chain snap2.qcow2

карта [-ф FMT] [--output =часто] имя файла
Выгрузить метаданные изображения имя файла и его цепочка файлов поддержки. В частности, это
команды сбрасывают состояние распределения каждого сектора имя файлаВместе с
самый верхний файл, который размещает его в цепочке резервных файлов.

Возможны два варианта формата. Формат по умолчанию ("человеческий") выводит только известные -
ненулевые области файла. Известные нулевые части файла полностью опускаются, и
то же самое для частей, которые не распределены по всей цепочке. qemu-img выход будет
определить файл, из которого могут быть прочитаны данные, и смещение в файле. Каждый
Строка будет включать четыре поля, первые три из которых - шестнадцатеричные числа. Для
пример первой строки:

Длина смещения, сопоставленная с файлом
0 0x20000 0x50000 /tmp/overlay.qcow2
0x100000 0x10000 0x95380000 /tmp/backing.qcow2

означает, что 0x20000 (131072) байтов, начиная со смещения 0 в изображении, доступны в
/tmp/overlay.qcow2 (открыт в «сыром» формате), начиная со смещения 0x50000 (327680). Данные
сжатые, зашифрованные или недоступные в исходном формате по иным причинам, вызовет
ошибка, если используется "человеческий" формат. Обратите внимание, что имена файлов могут включать символы новой строки, поэтому
анализировать этот выходной формат в сценариях небезопасно.

Альтернативный формат «json» вернет массив словарей в формате JSON. Это
будет включать аналогичную информацию в поля «начало», «длина», «смещение»; Так и будет
также включите другую более конкретную информацию:

- содержат ли секторы актуальные данные или нет (логическое поле data; если false, то
секторы либо нераспределены, либо хранятся как оптимизированные нулевые кластеры);

- известно ли, что данные читаются как ноль (логическое поле «ноль»);

- чтобы сделать вывод короче, целевой файл выражается как «глубина»;
например, глубина 2 относится к резервному файлу резервного файла
имя файла.

В формате JSON поле «смещение» необязательно; отсутствует в случаях, когда "человеческий"
формат пропустил бы вход или выход с ошибкой. Если "данные" ложны и
поле "смещение" присутствует, соответствующие секторы в файле еще не используются,
но они размещены заранее.

Для получения дополнительной информации обратитесь к включить / блок / block.h в исходном коде QEMU.

снимок [-л | -a снимок | -c снимок | -d снимок ] имя файла
Список, применение, создание или удаление снимков в изображении имя файла.

перебазировать [-ф FMT] [-т кэш] [-Т src_cache] [-п] [-у] -b резервный_файл [-Ф backing_fmt]
имя файла
Изменяет файл поддержки изображения. Поддерживаются только форматы "qcow2" и "qed".
изменение файла резервной копии.

Файл резервной копии изменен на резервный_файл и (если формат изображения имя файла
поддерживает это) формат файла резервной копии изменен на backing_fmt. Если резервный_файл is
указано как "" (пустая строка), то изображение перебазируется без резервного файла
(т.е. он будет существовать независимо от любого файла резервной копии).

кэш определяет режим кеширования, который будет использоваться для имя файла, в то время как src_cache определяет
режим кеширования для чтения резервных файлов.

Есть два разных режима, в которых может работать "rebase":

Безопасно Режим
Это режим по умолчанию, который выполняет настоящую операцию перебазирования. Новая поддержка
файл может отличаться от старого, и qemu-img rebase позаботится о сохранении
видимый для гостей контент имя файла без изменений.

Для этого любые кластеры, различающиеся между резервный_файл и
старый резервный файл имя файла объединены в имя файла перед фактическим изменением
резервный файл.

Обратите внимание, что безопасный режим - дорогостоящая операция, сравнимая с преобразованием
изображение. Это работает только в том случае, если старый резервный файл все еще существует.

небезопасный Режим
qemu-img использует небезопасный режим, если указан "-u". В этом режиме только бэк
имя файла и формат имя файла изменяется без каких-либо проверок файла
содержание. Пользователь должен позаботиться об указании правильного нового файла резервной копии, или
видимое для гостей содержимое изображения будет повреждено.

Этот режим полезен для переименования или перемещения файла резервной копии в другое место. Это
может использоваться без доступного старого файла резервной копии, то есть вы можете использовать его для исправления
изображение, резервный файл которого уже был перемещен / переименован.

Вы можете использовать "rebase" для выполнения операции "diff" на двух образах дисков. Это может быть
полезно, когда вы скопировали или клонировали гостя и хотите вернуться к тонкому
изображение поверх шаблона или базового изображения.

Скажите, что "base.img" был клонирован как "modified.img" путем его копирования, и что
Гость "modified.img" был запущен, поэтому теперь есть некоторые изменения по сравнению с "base.img". К
создать тонкое изображение с именем "diff.qcow2", содержащее только различия, выполните:

qemu-img создать -f qcow2 -b модифицированный.img diff.qcow2
qemu-img rebase -b base.img diff.qcow2

На этом этапе от "modified.img" можно отказаться, так как "base.img + diff.qcow2" содержит
та же информация.

изменить размер имя файла [+ | -]размер
Измените образ диска, как если бы он был создан с помощью размер.

Прежде чем использовать эту команду для сжатия образа диска, вы ДОЛЖНЫ использовать файловую систему и
инструменты разделения внутри виртуальной машины для уменьшения выделенных файловых систем и размеров разделов
соответственно. Несоблюдение этого правила приведет к потере данных!

После использования этой команды для увеличения образа диска вы должны использовать файловую систему и
инструменты разбиения на разделы внутри виртуальной машины, чтобы фактически начать использовать новое пространство на устройстве.

изменить [-п] [-ф FMT] [-т кэш] -o кредита имя файла
Изменяет формат изображения кредита для файла изображения имя файла. Не весь файл
форматы поддерживают эту операцию.

ПРИМЕЧАНИЯ

Поддерживаемые форматы файлов изображений:

сырье Формат необработанного образа диска (по умолчанию). Этот формат имеет то преимущество, что он прост и
легко экспортируется во все другие эмуляторы. Если ваша файловая система поддерживает отверстий (для
пример в ext2 или ext3 в Linux или NTFS в Windows), тогда только записанные сектора
зарезервирую место. Используйте qemu-img info, чтобы узнать реальный размер изображения, или ls
-ls "в Unix / Linux.

Поддерживаемые варианты:

"предварительное размещение"
Режим предварительного выделения (допустимые значения: «выкл», «falloc», «полный»). режим "фаллок"
предварительно выделяет место для изображения, вызывая posix_fallocate (). "полный" режим
предварительно выделяет пространство для изображения, записывая нули в базовое хранилище.

qcow2
Формат изображения QEMU, наиболее универсальный формат. Используйте его, чтобы иметь изображения меньшего размера (полезно, если
ваша файловая система не поддерживает дыры, например в Windows), необязательный AES
шифрование, сжатие на основе zlib и поддержка нескольких снимков виртуальных машин.

Поддерживаемые варианты:

"совместимость"
Определяет версию qcow2 для использования. compat = 0.10 использует традиционное изображение.
формат, который может быть прочитан любым QEMU, начиная с 0.10. compat = 1.1 включает формат изображения
расширения, которые понимают только QEMU 1.1 и новее (это значение по умолчанию). Среди
другие, это включает в себя нулевые кластеры, которые обеспечивают эффективное копирование при чтении для разреженных
изображениями.

"backing_file"
Имя файла базового образа (см. Создайте подкоманда)

"backing_fmt"
Формат изображения базового изображения

"шифрование"
Если для этого параметра установлено значение «включено», изображение шифруется с помощью 128-битного AES-CBC.

Использование шифрования в образах qcow и qcow2 считается ошибочным из-за
современные стандарты криптографии, страдающие рядом конструктивных проблем:

-
по номеру сектора. Это делает его уязвимым для атак с выбранным открытым текстом.
который может выявить наличие зашифрованных данных.

-
выбранная или короткая кодовая фраза поставит под угрозу безопасность шифрования.

-
измените парольную фразу для защиты данных в любых изображениях qcow. Файлы должны быть
клонировано, используя другую парольную фразу шифрования в новом файле. Оригинал
файл должен быть надежно удален с помощью такой программы, как shred, хотя даже этот
неэффективен со многими современными технологиями хранения.

Таким образом, использование шифрования qcow / qcow2 категорически не рекомендуется. Пользователям рекомендуется
использовать альтернативную технологию шифрования, такую ​​как Linux dm-crypt / LUKS
системы.

"размер кластера"
Изменяет размер кластера qcow2 (должен быть от 512 до 2M). Меньшие размеры кластера
может улучшить размер файла изображения, тогда как большие размеры кластера обычно обеспечивают
лучшая производительность.

"предварительное размещение"
Режим предварительного выделения (допустимые значения: «выкл», «метаданные», «falloc», «полный»). Картинка
с предварительно выделенными метаданными изначально больше, но может повысить производительность, если
изображение должно расти. Предварительное выделение "falloc" и "full" похоже на одно и то же
варианты "сырого" формата, но также устанавливает метаданные.

"lazy_refcounts"
Если для этого параметра установлено значение «Вкл.», Обновления счетчика ссылок откладываются с целью
предотвращения ввода-вывода метаданных и повышения производительности. Это особенно
интересно с кеш = запись который не выполняет пакетные обновления метаданных. В
компромисс заключается в том, что после сбоя хоста таблицы счетчика ссылок должны быть перестроены,
т.е. при следующем открытии требуется (автоматическая) "qemu-img check -r all", что
может занять некоторое время.

Этот параметр можно включить, только если указано "compat = 1.1".

"сейчас"
Если для этого параметра установлено значение «on», он отключит COW файла. Это действительно только
на btrfs не влияет на другие файловые системы.

Btrfs имеет низкую производительность при размещении файла образа виртуальной машины, даже больше, когда гость
на виртуальной машине также с использованием btrfs в качестве файловой системы. Отключение COW - это способ уменьшить
это плохая работа. Обычно есть два способа отключить COW на btrfs: а)
Отключите его, смонтировав с помощью nodatacow, тогда все вновь созданные файлы будут NOCOW.
б) Для пустого файла добавьте атрибут файла NOCOW. Вот что делает этот вариант.

Примечание: эта опция действительна только для новых или пустых файлов. Если есть существующий
файл, который является COW и уже содержит блоки данных, его нельзя изменить на NOCOW с помощью
установка "nocow = on". Можно ввести "lsattr filename", чтобы проверить, установлен ли флаг NOCOW.
установлен или нет (заглавная буква C - это флаг NOCOW).

Другое
QEMU также поддерживает различные другие форматы файлов изображений для совместимости со старыми QEMU.
версии или другие гипервизоры, включая VMDK, VDI, VHD (vpc), VHDX, qcow1 и QED.
Полный список поддерживаемых форматов см. В «qemu-img --help». Для более подробного
Описание этих форматов см. в документации пользователя эмуляции QEMU.

Основное назначение блочных драйверов для этих форматов - преобразование изображений. Для
запущенных виртуальных машин, рекомендуется преобразовать образы дисков в raw или qcow2 в
чтобы добиться хорошей производительности.

Используйте qemu-img онлайн с помощью сервисов onworks.net