НАЗВА¶

virt-tar — видобування або вивантаження файлів до віртуальної машини

КОРОТКИЙ ОПИС¶

 virt-tar [--параметри] -x назва_домену каталог архів_tar
 virt-tar [--параметри] -u назва_домену  архів_tar каталог
 virt-tar [--параметри] диск.img [диск.img ...] -x каталог архів_tar
 virt-tar [--параметри] диск.img [диск.img ...] -u архів_tar каталог

ЗАСТАРІЛЕ¶

Ця програма вважається застарілою. Замість неї слід використовувати virt-copy-in(1), virt-copy-out(1), virt-tar-in(1), virt-tar-out(1).

ПРИКЛАДИ¶

Отримати "/home" з віртуальної машини до локального архіву tar:

 virt-tar -x domname /home home.tar
 virt-tar -zx domname /home home.tar.gz

Вивантажити локальний архів tar і розпакувати його до "/tmp" у віртуальній машині:

 virt-tar -u domname uploadstuff.tar /tmp
 virt-tar -zu domname uploadstuff.tar.gz /tmp

ПОПЕРЕДЖЕННЯ¶

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

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

ОПИС¶

"virt-tar" — інструмент архівування загального призначення, завданням якого є отримання і вивантаження частин файлової системи гостьової операційної системи. У нього багато можливих застосувань: створення резервних копій, вивантаження файлів із даними, стеження за діями у гостьовій системі, виправлення та налаштовування гостьових систем тощо.

Якщо вам потрібен один файл, скористайтеся virt-cat(1). Якщо ви хочете внести зміни до одного файла, скористайтеся virt-edit(1). Для виконання складніших дій можна скористатися програмою guestfish(1).

Передбачено два режими роботи: -x (eXtract) отримує дані каталогу і його вміст (рекурсивно) з віртуальної машини до локального архіву tar. -u вивантажує дані з локального архіву tar, розпаковуючи їх до каталогу у віртуальній машині. Параметри, які визначають ці два режими роботи, не можна використовувати разом у одній команді.

Крім того, ймовірно, вам знадобиться параметр -z (gZip), який вмикає стискання даних. Під час вивантаження даних вам слід вказати параметр -z, якщо вивантажуваний файл стиснуто, оскільки сама virt-tar не намагатиметься це визначити.

"virt-tar" може працювати лише з форматом архівів tar (з можливістю стискання gzip). Наприклад, програма не може працювати із файлами PKZip або архівами, які стиснуто bzip2. Якщо вам доводиться працювати з іншими форматами даних, вам доведеться перезібрати архіви власноруч. (Це обмеження є обмеженням програмного інтерфейсу libguestfs(3)).

ПАРАМЕТРИ¶

--help

Показати коротку довідку.

--version

Показати дані щодо версії і завершити роботу.

-c адреса

--connect адреса

Якщо використовується libvirt, встановити з’єднання з вказаним URI. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt.

Якщо вказати блокові пристрої гостьових систем безпосередньо, libvirt не буде використовуватися взагалі.

--format raw

Визначає формат образу диска, назву якого вказано у рядку команди. Якщо формат не вказано, його буде визначено автоматично на основі вмісту образу диска.

Якщо вказаний диск походить з libvirt, ця програма надішле запит щодо даних до libvirt. У цьому випадку вказане значення параметра формату буде проігноровано.

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

-x

--extract

--download

-u

--upload

Скористайтеся параметром -x для видобування (отримання) каталогу з віртуальної машини до локального архіву tar.

Скористайтеся параметром -u для вивантаження і розпаковування локального архіву tar до віртуальної машини. Будь ласка, ознайомтеся із наведеним вище розділом "ПОПЕРЕДЖЕННЯ", перш ніж користуватися цим параметром.

Слід вказувати лише один із цих параметрів.

-z

--gzip

Надає змогу вказати, що вхідний або вихідний архів tar стиснуто за допомогою gzip.

ТАКОЖ ПЕРЕГЛЯНЬТЕ¶

guestfs(3), guestfish(1), virt-cat(1), virt-edit(1), virt-copy-in(1), virt-copy-out(1), virt-tar-in(1), virt-tar-out(1), Sys::Guestfs(3), Sys::Virt(3), http://libguestfs.org/.

АВТОР¶

Richard W.M. Jones http://people.redhat.com/~rjones/

АВТОРСЬКІ ПРАВА¶

© Red Hat Inc., 2009

LICENSE¶

BUGS¶

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

• The version of libguestfs.
• Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
• Describe the bug accurately and give a way to reproduce it.
• Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.