qemu-img

ПРОГРАМА:

ІМ'Я

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

СИНТАКСИС

використання: команда qemu-img [параметри команди]

ОПИС

qemu-img дозволяє створювати, конвертувати та змінювати зображення в автономному режимі. Він може обробляти всі зображення
формати, які підтримує QEMU.

Увага! Ніколи не використовуйте qemu-img для зміни зображень, які використовуються запущеною віртуальною машиною або будь-якою іншою
інший процес; це може зруйнувати зображення. Також майте на увазі, що запитувати зображення, яке є
модифікація іншим процесом може зіткнутися з несумісним станом.

ВАРІАНТИ

Підтримуються такі команди:

перевірка [-q] [-f fmt] [--вихід=ofmt] [-р [витоки | всі]] [-Т src_cache] ім'я файлу
створювати [-q] [-f fmt] [-або опції] ім'я файлу [розмір]
commit [-q] [-f fmt] [-т cache] [-б база] [-d] [-p] ім'я файлу
порівняти [-f fmt] [-Ф fmt] [-Т src_cache] [-p] [-q] [-s] ім'я файлу1 ім'я файлу2
конвертувати [-c] [-p] [-q] [-n] [-f fmt] [-т cache] [-Т src_cache] [-О output_fmt] [-або
опції] [-с Ідентифікатор_або_ім’я знімка] [-л snapshot_param] [-С sparse_size] ім'я файлу [ім'я файлу2
[...]] вихідний_файл
info [-f fmt] [--вихід=ofmt] [--backing-chain] ім'я файлу
карта [-f fmt] [--вихід=ofmt] ім'я файлу
знімок [-q] [-л | -a знімок | -c знімок | -d знімок] ім'я файлу
ребаза [-q] [-f fmt] [-т cache] [-Т src_cache] [-p] [-у] -b резервний_файл [-Ф backing_fmt]
ім'я файлу
змінити розмір [-q] ім'я файлу [+ | -]розмір
змінити [-p] [-q] [-f fmt] [-т cache] -o опції ім'я файлу

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

ім'я файлу
це ім'я файлу образу диска

fmt це формат образу диска. У більшості випадків він вгадується автоматично. Дивіться нижче для а
опис підтримуваних форматів дисків.

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

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

вихідний_файл
це ім'я файлу образу диска призначення

output_fmt
це формат призначення

опції
це розділений комами список параметрів для певного формату у форматі ім’я=значення. Використовуйте «-o
?" для огляду параметрів, які підтримує використовуваний формат, або перегляньте формат
описи нижче для детальної інформації.

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

Ідентифікатор_або_ім’я знімка
не підтримується, замість нього використовуйте snapshot_param

-c вказує, що цільове зображення має бути стиснуте (лише формат qcow)

-h з командою або без неї показує довідку та перелічує підтримувані формати

-p відображати індикатор виконання (лише команди порівняння, перетворення та перебазування). Якщо -p опція
не використовується для команди, яка його підтримує, прогрес повідомляється під час виконання процесу
отримує сигнал "SIGUSR1".

-q Тихий режим - не друкуйте жодного результату (окрім помилок). Індикатора прогресу немає
обидва -q та -p використовуються варіанти.

-S розмір
вказує послідовну кількість байтів, які повинні містити лише нулі для qemu-img to
створити розріджене зображення під час перетворення. Це значення округляється до найближчого 512
байтів. Ви можете використовувати звичайні суфікси розміру, такі як "k" для кілобайтів.

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

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

Параметри підкоманди знімка:

знімок
— ім’я знімка, який потрібно створити, застосувати або видалити

-a застосовує знімок (повернути диск до збереженого стану)

-c створює знімок

-d видаляє знімок

-l перелічує всі знімки на даному зображенні

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

-f Перший формат зображення

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

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

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

-n Пропустіть створення цільового тому

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

перевірка [-f fmt] [--вихід=ofmt] [-р [витоки | всі]] [-Т src_cache] ім'я файлу
Виконайте перевірку відповідності образу диска ім'я файлу. Команда може виводити в
формат ofmt який є або "людиною", або "json".

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

Перевірку відповідності підтримують лише формати "qcow2", "qed" і "vdi".

Якщо зображення не має невідповідностей, перевірте вихід 0. Інший вихід
коди вказують на тип знайденої невідповідності або на те, що сталася інша помилка. The
У наступній таблиці підсумовуються всі коди виходу підкоманди перевірки:

0 Перевірка завершена, зображення (зараз) узгоджене

1 Перевірка не завершена через внутрішні помилки

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

3 Перевірка завершена, зображення має витік кластерів, але не пошкоджено

63 Формат зображення не підтримує перевірки

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

створювати [-f fmt] [-або опції] ім'я файлу [розмір]
Створіть новий образ диска ім'я файлу розміру розмір і формат fmt. Залежно від файлу
формат, ви можете додати один або кілька опції які надають додаткові функції цього
Формат.

Якщо опція резервний_файл вказано, то зображення буде записувати лише те
відмінності від резервний_файл. Розмір у цьому випадку вказувати не потрібно.
резервний_файл ніколи не буде змінено, якщо ви не скористаєтеся командою моніторингу "commit" (або
qemu-img фіксація).

Розмір також можна вказати за допомогою розмір опція з "-o", це не обов'язково
в цьому випадку вказується окремо.

commit [-q] [-f fmt] [-т cache] [-б база] [-d] [-p] ім'я файлу
Зафіксуйте зміни, записані в ім'я файлу у його базовому зображенні або резервному файлі. Якщо
резервний файл менший за знімок, тоді розмір резервного файлу буде змінено до
такого ж розміру, як знімок. Якщо знімок менший за резервний файл, файл
резервний файл не буде скорочено. Якщо ви хочете, щоб резервний файл відповідав розміру
менший знімок, ви можете безпечно обрізати його самостійно після операції фіксації
успішно завершується.

Зображення ім'я файлу спорожняється після успішного завершення операції. Якщо не потрібно
ім'я файлу після того, як ви маєте намір кинути його, ви можете пропустити спорожнення ім'я файлу by
вказуючи прапор "-d".

Якщо резервний ланцюжок даного файлу зображення ім'я файлу має більше одного шару,
резервний файл, у який будуть зафіксовані зміни, може бути вказаний як база (котрий
має бути частиною ім'я файлуопорний ланцюг). Якщо база не вказано, негайне
резервний файл верхнього зображення (який є ім'я файлу) буде використано. З причин
послідовність, явно вказуючи база завжди означатиме "-d" (оскільки спустошення an
image після фіксації до непрямого резервного файлу призведе до появи інших даних
зчитування із зображення через вміст у проміжному ланцюжку підтримки, що переважає
фіксувати ціль).

порівняти [-f fmt] [-Ф fmt] [-Т src_cache] [-p] [-s] [-q] ім'я файлу1 ім'я файлу2
Перевірте, чи два зображення мають однаковий вміст. Ви можете порівнювати зображення з різними
формат або налаштування.

Формат перевіряється, якщо ви не вкажете його за допомогою -f (використовуваний для ім'я файлу1) та / або -F (використовується
та цінності ім'я файлу2) варіант.

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

За замовчуванням порівняння друкує повідомлення результату. Це повідомлення відображає інформацію
що обидва зображення однакові або позиція першого байта відрізняється. В додаток,
Повідомлення результату може повідомляти про інший розмір зображення, якщо використовується строгий режим.

Порівняйте вихід з 0, якщо зображення рівні, і з 1, якщо зображення однакові
відрізнятися. Інші коди виходу означають помилку, що сталася під час виконання, і стандартну помилку
вихід має містити повідомлення про помилку. У наступній таблиці наведено всі коди виходу
підкоманди порівняння:

0 Зображення ідентичні

1 Зображення відрізняються

2 Помилка під час відкриття зображення

3 Помилка під час перевірки розподілу сектора

4 Помилка під час читання даних

конвертувати [-c] [-p] [-n] [-f fmt] [-т cache] [-Т src_cache] [-О output_fmt] [-або опції] [-с
Ідентифікатор_або_ім’я знімка] [-л snapshot_param] [-С sparse_size] ім'я файлу [ім'я файлу2 [...]]
вихідний_файл
Перетворіть образ диска ім'я файлу або знімок snapshot_param(Ідентифікатор_або_ім’я знімка is
не підтримується) на образ диска вихідний_файл використовуючи формат output_fmt. Це може бути
за бажанням стиснутий (опція "-c") або використовувати будь-які параметри, специфічні для формату, як-от шифрування
(опція "-o").

Лише формати "qcow" і "qcow2" підтримують стиснення. Стиснення доступне лише для читання.
Це означає, що якщо стиснутий сектор перезаписується, то він переписується як
нестиснені дані.

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

sparse_size вказує послідовну кількість байтів (за замовчуванням 4k), які повинні
містять лише нулі для qemu-img для створення розрідженого зображення під час перетворення. Якщо
sparse_size дорівнює 0, джерело не буде перевірено на наявність нерозподілених або нульових секторів, і
цільове зображення завжди буде повністю виділено.

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

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

info [-f fmt] [--вихід=ofmt] [--backing-chain] ім'я файлу
Надайте інформацію про образ диска ім'я файлу. Використовуйте його, зокрема, щоб дізнатися розмір
зарезервовано на диску, розмір якого може відрізнятися від відображеного. Якщо знімки віртуальної машини є
Збережені в образі диска, вони також відображаються. Команда може виводити у форматі
ofmt який є або "людиною", або "json".

Якщо образ диска має резервний ланцюжок файлів, інформація про кожен образ диска в файлі
ланцюжок можна рекурсивно перерахувати за допомогою параметра "--backing-chain".

Наприклад, якщо у вас є ланцюжок зображень, наприклад:

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

Щоб перерахувати інформацію про кожен образ диска у наведеному вище ланцюжку, починаючи зверху
базувати, робити:

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

карта [-f fmt] [--вихід=ofmt] ім'я файлу
Дамп метаданих зображення ім'я файлу і його резервний ланцюжок файлів. Зокрема, це
команди дампують стан виділення кожного сектора ім'я файлуРазом з
верхній файл, який виділяє його в ланцюжку резервних файлів.

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

Довжина зміщення зіставляється з файлом
0 0x20000 0x50000 /tmp/overlay.qcow2
0x100000 0x10000 0x95380000 /tmp/backing.qcow2

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

Альтернативний формат «json» поверне масив словників у форматі JSON. Це
буде включати подібну інформацію в полях «початок», «довжина», «зміщення»; це буде
також включати іншу більш конкретну інформацію:

- чи містять сектори фактичні дані чи ні (логічне поле "дані"; якщо false,
сектори або нерозподілені, або зберігаються як оптимізовані нульові кластери);

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

- щоб зробити вихід коротшим, цільовий файл виражається як «глибина»;
наприклад, глибина 2 відноситься до резервного файлу резервного файлу
ім'я файлу.

У форматі JSON поле "offset" необов'язкове; він відсутній у випадках, коли "людський"
формат пропустив би вхід або вихід із помилкою. Якщо "дані" хибні, і
поле "offset" присутнє, відповідні сектори у файлі ще не використовуються,
але вони попередньо розподілені.

За додатковою інформацією звертайтеся include/block/block.h у вихідному коді QEMU.

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

ребаза [-f fmt] [-т cache] [-Т src_cache] [-p] [-у] -b резервний_файл [-Ф backing_fmt]
ім'я файлу
Змінює резервний файл зображення. Підтримуються лише формати "qcow2" і "qed".
зміна резервного файлу.

Резервний файл змінено на резервний_файл і (якщо формат зображення ім'я файлу
підтримує це) формат резервного файлу змінено на backing_fmt. Якщо резервний_файл is
вказано як "" (порожній рядок), то зображення буде перебазовано на файл без підкладки
(тобто він існуватиме незалежно від будь-якого резервного файлу).

cache визначає режим кешу, який буде використовуватися ім'я файлу, тоді як src_cache вказує
режим кешу для читання резервних файлів.

Існує два різних режими, в яких може працювати "rebase":

Безпечний режим
Це режим за замовчуванням і виконує реальну операцію перебазування. Нова підкладка
файл може відрізнятися від старого, і qemu-img rebase подбає про збереження файлу
вміст, видимий для гостей ім'я файлу незмінний.

Щоб досягти цього, будь-які кластери, які відрізняються між собою резервний_файл і
старий резервний файл ім'я файлу об'єднані в ім'я файлу перед фактичною зміною
резервний файл.

Зауважте, що безпечний режим є дорогою операцією, порівнянною з перетворенням an
зображення. Це працює, лише якщо старий резервний файл все ще існує.

Небезпечно режим
qemu-img використовує небезпечний режим, якщо вказано "-u". У цьому режимі тільки підкладка
ім'я файлу та формат ім'я файлу змінюється без будь-яких перевірок файлу
зміст. Користувач повинен подбати про те, щоб указати правильний новий резервний файл, або
видимий для гостей вміст зображення буде пошкоджено.

Цей режим корисний для перейменування або переміщення резервного файлу в інше місце. Це
можна використовувати без доступного старого резервного файлу, тобто ви можете використовувати його для виправлення файлу
зображення, резервний файл якого вже переміщено/перейменовано.

Ви можете використовувати "rebase", щоб виконати операцію "diff" на двох образах дисків. Це може бути
корисно, коли ви скопіювали або клонували гостя і хочете повернутися до тонкого
зображення поверх шаблону або основного зображення.

Скажімо, що "base.img" було клоновано як "modified.img", скопіювавши його, і що
Гість "modified.img" запущено, тому тепер є деякі зміни порівняно з "base.img". До
побудуйте тонке зображення під назвою "diff.qcow2", яке містить лише відмінності, виконайте:

qemu-img create -f qcow2 -b modified.img diff.qcow2
qemu-img rebase -b base.img diff.qcow2

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

змінити розмір ім'я файлу [+ | -]розмір
Змініть образ диска так, ніби він був створений за допомогою розмір.

Перш ніж використовувати цю команду для скорочення образу диска, ви ПОВИННІ використовувати файлову систему і
інструменти розділення всередині віртуальної машини, щоб зменшити виділені файлові системи та розміри розділів
відповідно. Якщо цього не зробити, це призведе до втрати даних!

Після використання цієї команди для збільшення образу диска ви повинні використовувати файлову систему і
інструменти розділення всередині віртуальної машини, щоб фактично почати використовувати новий простір на пристрої.

змінити [-p] [-f fmt] [-т cache] -o опції ім'я файлу
Вносить зміни до конкретного формату зображення опції для файлу зображення ім'я файлу. Не всі файли
формати підтримують цю операцію.

ПРИМІТКИ

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

сировина Формат необробленого образу диска (за замовчуванням). Цей формат має перевагу в тому, що він простий і
легко експортується до всіх інших емуляторів. Якщо ваша файлова система підтримує отворів (Для
наприклад в ext2 або ext3 в Linux або NTFS у Windows), тоді тільки записані сектори
зарезервує місце. Використовуйте «qemu-img info», щоб дізнатися реальний розмір зображення, або «ls
-ls" на Unix/Linux.

Підтримувані параметри:

"попередній розподіл"
Режим попереднього розподілу (дозволені значення: "off", "falloc", "full"). режим "falloc".
попередньо виділяє місце для зображення за допомогою виклику posix_fallocate(). «повний» режим
попередньо розподіляє місце для зображення, записуючи нулі в основне сховище.

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

Підтримувані параметри:

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

"backing_file"
Ім'я файлу базового зображення (див створювати підкоманда)

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

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

Використання шифрування в зображеннях qcow і qcow2 вважається недоліком
сучасні стандарти криптографії, які страждають від ряду проблем проектування:

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

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

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

Тому використання шифрування qcow/qcow2 категорично не рекомендується. Рекомендуємо користувачів
використовувати альтернативну технологію шифрування, таку як Linux dm-crypt / LUKS
системи.

"cluster_size"
Змінює розмір кластера qcow2 (повинен бути від 512 до 2 Мб). Менші розміри кластерів
може покращити розмір файлу зображення, тоді як більші розміри кластера зазвичай забезпечують
кращу продуктивність.

"попередній розподіл"
Режим попереднього розподілу (дозволені значення: "off", "metadata", "falloc", "full"). Образ
з попередньо розподіленими метаданими спочатку більше, але може покращити продуктивність, коли
імідж повинен рости. "falloc" і "full" попередні розподіли схожі
параметри "сирого" формату, але також налаштовує метадані.

"lazy_refcounts"
Якщо для цього параметра встановлено значення "увімкнено", оновлення кількості посилань відкладаються з цією метою
уникнення введення-виведення метаданих і підвищення продуктивності. Це особливо
цікаво з кеш=запис який не пакетно оновлює метадані. The
Компроміс полягає в тому, що після збою хоста таблиці підрахунку посилань повинні бути перебудовані,
тобто при наступному відкритті потрібна (автоматична) "qemu-img check -r all", яка
може знадобитися деякий час.

Цей параметр можна ввімкнути, лише якщо вказано "compat=1.1".

"nocow"
Якщо для цього параметра встановлено значення "on", це вимкне COW файлу. Це лише дійсне
на btrfs, не впливає на інші файлові системи.

Btrfs має низьку продуктивність під час розміщення файлу образу віртуальної машини, навіть більше, якщо він працює в режимі гостя
на віртуальній машині також використовує btrfs як файлову систему. Вимкнення COW – це спосіб пом’якшення
цей поганий виступ. Як правило, є два способи вимкнути COW на btrfs: a)
Вимкніть його, змонтувавши за допомогою nodatacow, тоді всі новостворені файли будуть NOCOW.
b) Для порожнього файлу додайте атрибут файлу NOCOW. Ось що робить цей варіант.

Примітка: цей параметр дійсний лише для нових або порожніх файлів. Якщо є існуючий
файл, який є COW і вже має блоки даних, його не вдалося змінити на NOCOW
налаштування "nocow=on". Можна задати "lsattr filename", щоб перевірити, чи є прапор NOCOW
встановлено чи ні (Велика 'C' є прапором NOCOW).

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

Основним призначенням блокових драйверів для цих форматів є перетворення зображень. Для
під керуванням віртуальних машин, рекомендується конвертувати образи дисків у raw або qcow2
для досягнення хорошої продуктивності.

Використовуйте qemu-img онлайн за допомогою служб onworks.net