НАЗВА¶

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

 guestmount [--параметри] -a диск.img -m пристрій [--ro] точка монтування

 guestmount [--параметри] -a диск.img -i [--ro] точка_монтування

 guestmount [--параметри] -d Гостьова_система -i [--ro] точка_монтування

ОПИС¶

Разом із іншими параметрами вам слід надати принаймні один пристрій (параметр -a) або домен libvirt (параметр -d) і принаймні одну точку монтування (параметр -m) або скористатися параметром інспектування -i чи параметром --live. Кращий опис того, як це працює, наведено на сторінці підручника щодо guestfish(1). Також можна скористатися наведеними нижче прикладами.

FUSE надає вам змогу монтувати файлові системи від імені звичайного користувача. Власником точки монтування має бути ваш користувач. Файлова система лишатиметься невидимою для усіх інших користувачів, якщо ви не внесете змін до налаштувань. Див. "ПРИМІТКИ" нижче.

Для демонтування файлової системи скористайтеся програмою guestunmount(1).

ПРИКЛАДИ¶

 guestmount -a windows.img -m /dev/sda1 --ro /mnt

Для типової гостьової системи Linux із файловою системою /boot на першому розділі і кореневою файловою системою на логічному томі:

 guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt

Щоб libguestfs виявила точки монтування гостьової системи:

 guestmount -a guest.img -i --ro /mnt

Для гостьової системи libvirt із назвою «Guest» можна віддати таку команду:

 guestmount -d Guest -i --ro /mnt

Якщо ви не знаєте, які файлові системи містяться у гостьовій операційній системі або на образі диска, скористайтеся спочатку virt-filesystems(1):

 virt-filesystems -d MyGuest

Якщо вам потрібно трасувати виклики libguestfs, але без надмірних діагностичних даних, рекомендуємо зробити так:

 guestmount [...] --trace /mnt

Якщо ви хочете виконати діагностику роботи програми, рекомендуємо таке:

 guestmount [...] --trace --verbose /mnt

Щоб демонтувати файлову систему після її використання:

 guestunmount /mnt

ПРИМІТКИ¶

 sudo guestmount [...] -o allow_other /mnt

 guestmount -a disk.img -i /mnt
 # скопіювати дані до /mnt
 guestunmount /mnt
 # негайно спробувати використати 'disk.img' ** НЕБЕЗПЕЧНО **

 guestmount -a disk.img -i --pid-file guestmount.pid /mnt
 
 # ...
 # ...
 
 # Зберегти PID guestmount *до* виклику guestunmount.
 pid="$(cat guestmount.pid)"
 
 # Демонтувати файлову систему.
 guestunmount /mnt
 
 timeout=10
 
 count=$timeout
 while kill -0 "$pid" 2>/dev/null && [ $count -gt 0 ]; do
     sleep 1
     ((count--))
 done
 if [ $count -eq 0 ]; then
     echo "$0: wait for guestmount to exit failed after $timeout seconds"
     exit 1
 fi
 
 # Тепер можна безпечно користуватися образом диска.

ПАРАМЕТРИ¶

-a ОБРАЗ

--add ОБРАЗ

Додати блоковий пристрій або образ віртуальної машини.

Формат образу диска визначається автоматично. Щоб перевизначити його і примусово використати певний формат, скористайтеся параметром --format=...

-a адреса

--add адреса

Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in guestfish(1).

-c адреса

--connect адреса

Якщо використано у поєднанні із параметром -d, визначає адресу libvirt, якою слід скористатися. Типово, використовується типове з'єднання libvirt.

-d ДОМЕН_LIBVIRT

--domain ДОМЕН_LIBVIRT

Додати диски із названого домену libvirt. Якщо також використано параметр --ro, може бути використано будь-який домен libvirt. Втім, у режимі запису тут можна вказати лише домени libvirt, які вимкнено.

Замість назв можна використовувати UUID доменів.

--dir-cache-timeout N

Встановити час застарівання кешу readdir у значення N секунд. Типовим значенням є 60 секунд. Кеш readdir [насправді, існує декілька напівнезалежних кешів] заповнюється після виклику readdir(2) статистикою і розширеними атрибутами файлів у каталозі у сподіванні, що вони невдовзі знову знадобляться.

Існує також інший кеш атрибутів, реалізований за допомогою FUSE (див. параметр FUSE -o attr_timeout), але кеш FUSE не розрахований на наступні виклики — його призначено лише для кешування наявних.

--echo-keys

Типово, якщо guestfish попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите.

--fd=ДФ

Вказати канал або дескриптор файла eventfd. Коли точка монтування буде готова до використання, guestmount запише один байт до цього дескриптора файла. Цим можна скористатися, у поєднанні із --no-fork, щоб запустити guestmount у межах іншого процесу.

--format=raw|qcow2|..

--format

Типовим значенням для параметра -a є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів -a формату диска у наступному рядку команди. Використання параметра --format без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах -a.

Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE-2010-3851). Див. також <guestfs(3)/guestfs_add_drive_opts>.

--fuse-help

Вивести довідку щодо спеціальних параметрів FUSE (див. -o нижче).

--help

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

-i

--inspector

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

--key SELECTOR

Specify a key for LUKS, to automatically open a LUKS device when using the inspection. "SELECTOR" can be in one of the following formats:

--keys-from-stdin

Прочитати параметри ключа або пароля із джерела стандартного введення. Типово програма намагається читати паролі від користувача відкриттям /dev/tty.

--live

З'єднатися із запущеною віртуальною машиною. (Експериментальна можливість, див. "ДОЛУЧЕННЯ ДО ЗАПУЩЕНИХ ФОНОВИХ СЛУЖБ" in guestfs(3)).

-m пристрій[:точка_монтування[:параметри[:тип_файлової_системи]]]

--mount пристрій[:точка_монтування[:параметри[:тип_файлової_системи]]]

Змонтувати вказаний за назвою розділ або логічний том до вказаної точки монтування у гостьовій системі (немає нічого спільного із точками монтування у основній системі).

Якщо точку монтування не вказано, типовим значенням є /. Вам слід змонтувати щось до /.

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

 -m /dev/sda1:/:acl,user_xattr
    

Четвертою частиною параметра є назва драйвера файлової системи, якою слід скористатися, зокрема "ext3" або "ntfs". У визначенні цієї частини параметра рідко виникає потреба, але вона може бути корисною, якщо для файлової системи можна скористатися декількома драйверами (приклад: "ext2" і "ext3"), або libguestfs визначає файлову систему помилково.

--no-fork

Не створювати фонової служби (або відгалуження у фоновий режим).

-n

--no-sync

Типово, під час демонтування точки монтування FUSE буде виконано спробу синхронізувати диск гостьової операційної системи. Якщо ви вкажете цей параметр, спроби синхронізуватися не виконуватиметься. Див. обговорення автоматичної синхронізації на сторінці підручника guestfs(3).

-o ПАРАМЕТР

--option ПАРАМЕТР

Передати додаткові параметри FUSE.

Щоб отримати список усіх додаткових параметрів, підтримку яких передбачено у FUSE, скористайтеся наведеною нижче командою. Зауважте, що можна передавати лише параметри FUSE -o і що лише деякі з них варто насправді передавати.

 guestmount --fuse-help
    

Деякі з потенційно корисних параметрів FUSE:

--pid-file НАЗВА_ФАЙЛА

Записати PID робочого процесу guestmount до файла "назва_файла".

-r

--ro

Додавати пристрої і монтування лише у режимі читання. Це заборонить запис, а диск у FUSE буде показано як придатний лише до читання.

Наполегливо рекомендуємо скористатися цим параметром, якщо ви не маєте намірів щодо редагування диска гостьової системи. Якщо гостьова система працює, а цей параметр не вказано, існує дуже висока ймовірність пошкодити дані на диску. Ми намагаємося запобігати такому пошкодженню, але це не завжди можливо.

Див. також "OPENING DISKS FOR READ AND WRITE" in guestfish(1).

--selinux

Цей параметр призначено для забезпечення зворотної сумісності, його використання не матиме жодних наслідків.

-v

--verbose

Уможливити докладні повідомлення від підлеглої частини libguestfs.

-V

--version

Показати дані щодо версії програми, потім вийти

-w

--rw

Змінює дію параметрів -a, -d і -m таким чином, що диски додаються і монтуються у режимі читання і запису.

Див. "OPENING DISKS FOR READ AND WRITE" in guestfish(1).

-x

--trace

Трасувати виклики libguestfs і заходити до кожної функції FUSE.

Це також забороняє фоновій службі створювати відгалуження у фоновому режимі (див. --no-fork).

ФАЙЛИ¶

$XDG_CONFIG_HOME/libguestfs/libguestfs-tools.conf

$HOME/.libguestfs-tools.rc

$XDG_CONFIG_DIRS/libguestfs/libguestfs-tools.conf

/etc/libguestfs-tools.conf

Цей файл налаштувань керує типовим режимом — лише читання чи читання і запис (--ro або --rw).

Див. libguestfs-tools.conf(5).

СТАН ВИХОДУ¶

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

АВТОРИ¶

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

LICENSE¶

BUGS¶

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.