guestmount(1) | Virtualization Support | guestmount(1) |
guestmount — монтування файлової системи гостьової операційної системи у основній системі за допомогою FUSE і libguestfs
guestmount [--параметри] -a диск.img -m пристрій [--ro] точка монтування guestmount [--параметри] -a диск.img -i [--ro] точка_монтування guestmount [--параметри] -d Гостьова_система -i [--ro] точка_монтування
Програмою guestmount можна скористатися для монтування файлових систем віртуальної машини та інших образів дисків у основній системі. Програма використовує libguestfs для доступу до гостьової файлової системи і FUSE («файлову систему у просторі користувача») так, що змонтована система з'являється у основній системі як додатковий змонтований пристрій.
Along with other options, you have to give at least one device (-a option) or libvirt domain (-d option), and at least one mountpoint (-m option) or use the -i inspection option. How this works is better explained in the guestfish(1) manual page, or by looking at the examples below.
FUSE надає вам змогу монтувати файлові системи від імені звичайного користувача. Власником точки монтування має бути ваш користувач. Файлова система лишатиметься невидимою для усіх інших користувачів, якщо ви не внесете змін до налаштувань. Див. "ПРИМІТКИ" нижче.
Для демонтування файлової системи скористайтеся програмою guestunmount(1).
Для типової гостьової системи Windows, основна файлова система якої розміщується на першому розділі:
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
Якщо ви змонтуєте файлову систему від імені одного користувача (наприклад, root), інші користувачі типово не зможуть її бачити. Щоб виправити цей недолік, додайте під час монтування параметр "allow_other" FUSE:
sudo guestmount [...] -o allow_other /mnt
та для вмикання цього параметра у /etc/fuse.conf.
У деяких дистрибутивах користувача потрібно додати до спеціальної групи (наприклад "fuse"), перш ніж він зможе користуватися файловими системами FUSE. Так, зокрема, влаштовано систему доступу у Debian та похідних від нього дистрибутивах.
У інших дистрибутивах, зокрема Fedora та Red Hat Enterprise Linux, членство у групі не є обов'язковим.
Ви можете побачити це повідомлення про помилку, коли інший процес у системі починає використовувати щойно створену вами точку монтування, утримуючи її відкритою і заважаючи вам її демонтувати. Звичними «винуватцями» таких проблем є різноманітні програми для індексування даних.
Популярним способом обійти цю проблему є повторні спроби виконати "fusermount -u" декілька разів, аж доки потрібну дію не буде виконано (guestunmount(1) робити це за вас). На жаль, цей спосіб не є універсальним. Він не спрацює, якщо, наприклад, змонтована файлова система є доволі великою Unfortunately this isn't a reliable fix if (for example) the mounted filesystem is particularly large and the intruding program particularly persistent.
Належним вирішенням є використання приватної точки монтування шляхом створення простору назв монтування за допомогою специфічного для Linux прапорця clone(2)/unshare(2) "CLONE_NEWNS". На жаль, у поточній версії це потребує прав доступу root. Крім того, нам, ймовірно, потрібно буде додати цю можливість до guestmount.
Коли guestunmount(1)/fusermount(1) завершує роботу, guestmount усе ще може працювати над вилученням точки монтування. Образ диска у такому випадку може вийти незавершеним.
Це означає, що скрипти, подібні до наведеного нижче, містять небезпечний потенційний конфлікт потоків обробки через конкуренцію:
guestmount -a disk.img -i /mnt # скопіювати дані до /mnt guestunmount /mnt # негайно спробувати використати 'disk.img' ** НЕБЕЗПЕЧНО **
Рішенням є використання параметра --pid-file для запису PID guestmount до файла, а потім, після guestunmount, очікування на завершення роботи цього PID.
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 # Тепер можна безпечно користуватися образом диска.
Зауважте, що якщо ви використовуєте програмний інтерфейс "guestfs_mount_local" безпосередньо (див. "ЛОКАЛЬНЕ МОНТУВАННЯ" in guestfs(3)), набагато простіше буде написати безпечну, позбавлену конфліктів програму.
Формат образу диска визначається автоматично. Щоб перевизначити його і примусово використати певний формат, скористайтеся параметром --format=...
Замість назв можна використовувати UUID доменів.
Існує також інший кеш атрибутів, реалізований за допомогою FUSE (див. параметр FUSE -o attr_timeout), але кеш FUSE не розрахований на наступні виклики — його призначено лише для кешування наявних.
Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (CVE-2010-3851). Див. також <guestfs(3)/guestfs_add_drive_opts>.
Note that if any such option is present on the command line, QEMU user networking will be automatically enabled for the libguestfs appliance.
If there are multiple encrypted devices then you may need to supply multiple keys on stdin, one per line.
Якщо точку монтування не вказано, типовим значенням є /. Вам слід змонтувати щось до /.
Третьою (і нечасто використовуваною) частиною параметра монтування є список параметрів монтування, які використовуються для того, щоб змонтувати підлеглу файлову систему. Якщо такий список не буде задано, параметрами монтування вважатиметься або порожній рядок, або "ro" (другий варіант використовується, якщо використано прапорець --ro). Заданням параметрів монтування ви перевизначаєте типовий варіант. Ймовірно, єдиним випадком, коли вам може знадобитися це, є випадок вмикання списків керування доступом (ACL) і/або розширених атрибутів, якщо у файловій системі передбачено їхню підтримку:
-m /dev/sda1:/:acl,user_xattr
Четвертою частиною параметра є назва драйвера файлової системи, якою слід скористатися, зокрема "ext3" або "ntfs". У визначенні цієї частини параметра рідко виникає потреба, але вона може бути корисною, якщо для файлової системи можна скористатися декількома драйверами (приклад: "ext2" і "ext3"), або libguestfs визначає файлову систему помилково.
Щоб отримати список усіх додаткових параметрів, підтримку яких передбачено у FUSE, скористайтеся наведеною нижче командою. Зауважте, що можна передавати лише параметри FUSE -o і що лише деякі з них варто насправді передавати.
guestmount --fuse-help
Деякі з потенційно корисних параметрів FUSE:
Якщо цей параметр не вказано, FUSE створюватиме власні номери inode. Номери inode, які ви зазвичай бачите у stat(2), "ls -i" тощо, не є номерами inode у базовій файловій системі.
Зауваження: використання цього параметра є потенційно небезпечним, якщо у базова файлова система складається з декількох точок монтування, оскільки у такому випадку можливе дублювання номерів inode через FUSE. Використання цього параметра може призвести до неналежної роботи частини програм.
Наполегливо рекомендуємо скористатися цим параметром, якщо ви не маєте намірів щодо редагування диска гостьової системи. Якщо гостьова система працює, а цей параметр не вказано, існує дуже висока ймовірність пошкодити дані на диску. Ми намагаємося запобігати такому пошкодженню, але це не завжди можливо.
Див. також "OPENING DISKS FOR READ AND WRITE" in guestfish(1).
Див. "OPENING DISKS FOR READ AND WRITE" in guestfish(1).
Це також забороняє фоновій службі створювати відгалуження у фоновому режимі (див. --no-fork).
Див. libguestfs-tools.conf(5).
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка.
guestunmount(1), fusermount(1), guestfish(1), virt-inspector(1), virt-cat(1), virt-edit(1), virt-tar(1), libguestfs-tools.conf(5), "ЛОКАЛЬНЕ МОНТУВАННЯ" in guestfs(3), http://libguestfs.org/, http://fuse.sf.net/.
Richard W.M. Jones ("rjones at redhat dot com")
© Red Hat Inc., 2009–2020
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:
2022-11-28 | libguestfs-1.48.6 |