Provided by: guestfs-tools_1.52.2-2ubuntu1_amd64 
НАЗВА
virt-filesystems — програма для показу списку файлових систем, розділів, блокових
пристроїв, LVM у віртуальних машинах або образах дисків
КОРОТКИЙ ОПИС
virt-filesystems [--параметри] -d назва_домену
virt-filesystems [--параметри] -a диск.img [-a диск.img ...]
ОПИС
За допомогою цієї програми ви зможете виявляти файлові системи, розділи диска, логічні
томи та визначати їхні розміри у образі диска або у віртуальній машині. Програма є
замінником virt-list-filesystems(1) та virt-list-partitions(1).
Одним із варіантів використання цієї програми є додавання її у скрипти для ітеративного
обходу усіх файлових систем на образі диска:
for fs in $(virt-filesystems -a disk.img); do
# ...
done
Це одним використанням програми є виведення списку розділів до використання іншого
інструмента для внесення змін до цих розділів (зокрема програми virt-resize(1)). Якщо вам
цікавий вміст невідомого образу диска, скористайтеся цим інструментом разом із
virt-inspector(1).
Керувати виведенням даних цією програмою можна за допомогою різноманітних параметрів
командного рядка. Вам слід задати параметр -a або -d, щоб визначити образ диска або
гостьову систему libvirt. Якщо ви вкажете один з цих параметрів, програма покаже знайдені
файлові системи, по одній на рядок, ось так:
$ virt-filesystems -a disk.img
/dev/sda1
/dev/vg_guest/lv_root
Якщо ви додасте -l або --long, у виведених даних буде показано додаткову інформацію:
$ virt-filesystems -a disk.img -l
Назва Тип ВФС Мітка Розмір
/dev/sda1 filesystem ext4 boot 524288000
/dev/vg_guest/lv_root filesystem ext4 root 10212081664
Якщо ви додасте параметр --extra, буде показано і файлові системи, які непридатні до
монтування (резервна пам'ять, невідомий формат):
$ virt-filesystems -a disk.img --extra
/dev/sda1
/dev/vg_guest/lv_root
/dev/vg_guest/lv_swap
/dev/vg_guest/lv_data
Якщо ви додасте параметр --partitions, буде показано розділи, а не файлові системи:
$ virt-filesystems -a disk.img --partitions
/dev/sda1
/dev/sda2
У подібний спосіб, ви можете скористатися параметрами --logical-volumes, --volume-groups,
--physical-volumes, --block-devices, щоб отримати список цих записів.
Ви можете також скористатися цими параметрами у поєднанні (якщо вам потрібна комбінація із
файловими системами, вам слід додати --filesystems). Зауважте, що деякі з пунктів списку
можуть належати одночасно декільком категоріям (наприклад, /dev/sda1 може бути як
розділом, так і файловою системою). Такі пункти буде показано відповідну кількість разів.
Щоб отримати список, який міститиме абсолютно усе, про що знає virt-filesystems,
скористайтеся параметром --all.
UUID (оскільки вони є доволі довгими) типово показано не буде. Додайте параметр --uuid,
щоб ознайомитися із UUID пристроїв і файлових систем у розширених даних.
--all --long --uuid є корисною комбінацією для показу усіх доступних даних щодо усього.
$ virt-filesystems -a win.img --all --long --uuid -h
Назва Тип VFS Мітка Розмір Батьк. UUID
/dev/sda1 filesystem ntfs System Reserved 100M - F81C92571C92112C
/dev/sda2 filesystem ntfs - 20G - F2E8996AE8992E3B
/dev/sda1 partition - - 100M /dev/sda -
/dev/sda2 partition - - 20G /dev/sda -
/dev/sda device - - 20G - -
Для отримання зручних для машинної обробки даних скористайтеся параметром --csv. Дані буде
виведено у форматі значень відокремлених комами.
ПАРАМЕТРИ
--help
Показати коротку довідку.
-a файл
--add файл
Додати файл, який має бути образом диска з віртуальної машини. Якщо у віртуальній
машині декілька блокових пристроїв, вам слід вказати їх усі за допомогою окремих
записів параметра -a.
Формат образу диска визначається автоматично. Щоб перевизначити його і примусово
використати певний формат, скористайтеся параметром --format=...
-a адреса
--add адреса
Додати віддалений диск. Див. "ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА" in guestfish(1).
--all
Вивести усе. У поточній версії це те саме, що вказати такі параметри: --filesystems,
--extra, --partitions, --block-devices, --logical-volumes, --volume-groups,
--physical-volumes. (У майбутньому до цього списку може бути додано інші пункти).
Див. також --long.
--blkdevs
--block-devices
Показати список блокових пристроїв.
--blocksize=512
--blocksize=4096
--blocksize
This parameter sets the sector size of the disk image. It affects all explicitly
added subsequent disks after this parameter. Using --blocksize with no argument
switches the disk sector size to the default value which is usually 512 bytes. See
also "guestfs_add_drive_opts" in guestfs(3).
-c адреса
--connect адреса
Якщо використовується libvirt, встановити з’єднання з вказаним URI. Якщо пропущено,
з’єднання буде встановлено з типовим гіпервізором libvirt.
Якщо вказати блокові пристрої гостьових систем безпосередньо (-a), libvirt не буде
використовуватися взагалі.
--csv
Вивести результати до формату CSV (записів, відокремлених комами). Дані у цьому
форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто
ознайомитися із розділом "НОТАТКА ЩОДО ФОРМАТУ CSV", наведеним нижче.
-d гість
--domain гість
Додати всі диски з вказаної гостьової системи libvirt. UUID доменів можна
використовувати замість назв.
--echo-keys
Типово, якщо virt-filesystems попросить вас ввести ключ або пароль, програма не
відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST-нападів, або у
вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб
бачити, які саме символи ви вводите.
--extra
Це спричинить показ файлових систем, які не є звичайними файловими системами, які
придатні до монтування. До цієї категорії включено розділи резервної пам'яті та
файлові системи, які є порожніми або містять невідомі дані.
Цей параметр автоматично встановлює параметр --filesystems.
--filesystems
Показати список придатних до монтування систем. Якщо параметр показу не було
визначено, цей параметр буде додано до команди.
Якщо було використано параметр --extra, буде показано і непридатні до монтування
файлові системи.
--format=raw|qcow2|..
--format
Типовим значенням для параметра -a є автоматичне визначення формату образу диска.
Використання цього параметра примусово визначає значення параметрів -a формату диска у
наступному рядку команди. Використання параметра --format без аргументу перемикає
програму у режим автоматичного визначення у наступних параметрах -a.
Приклад:
virt-filesystems --format=raw -a диск.img
примусове встановлення формату без обробки (без автоматичного визначення) для
disk.img.
virt-filesystems --format=raw -a диск.img --format -a інший_диск.img
примусове встановлення формату без обробки (без автоматичного визначення) для diskimg
і повернення до автоматичного визначення для another.img.
Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі,
вам слід скористатися цим параметром для визначення формату диска. Таким чином можна
уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем
(CVE-2010-3851).
-h
--human-readable
У режимі --long показувати розміри у зручному для читання форматі.
--keys-from-stdin
Read key or passphrase parameters from stdin. The default is to try to read
passphrases from the user by opening /dev/tty.
If there are multiple encrypted devices then you may need to supply multiple keys on
stdin, one per line.
-l
--long
Показувати додаткові стовпчики даних («довгий формат»).
Якщо ви не додасте параметр --no-title, буде додано рядок заголовка.
Вміст додаткових стовпчиків залежить від вибраного виведення, а упорядкування
стовпчиків може змінитися у майбутніх версіях. Для того, щоб виведені дані відповідали
вхідним даним зовнішніх програм, скористайтеся рядком заголовків, виведенням --csv
і/або csvtool(1).
Якщо дані має бути виведено у зручному для читання людиною форматі, скористайтеся
параметром -h. Типово, буде показано розміри у байтах.
Скористайтеся параметром --uuid, щоб було показано також UUID.
--lvs
--logvols
--logical-volumes
Показати логічні томи LVM. У цьому режимі томи буде показано незалежно від того, чи
містяться на логічних томах файлові системи.
--no-title
У режимі --long не додавати рядок заголовків.
Зауважте, що порядок стовпчиків не є фіксованим і може змінитися у майбутніх версіях
virt-filesystems; отже, використання цього параметра може призвести до не зовсім
очікуваних наслідків.
--parts
--partitions
Показати розділи. У цьому режимі розділи буде показано незалежно від того, чи
містяться на розділах файлові системи.
--pvs
--physvols
--physical-volumes
Показати фізичні томи LVM.
--uuid
--uuids
У режимі --long буде також виведено UUID.
-v
--verbose
Увімкнути докладний показ повідомлень з метою діагностики.
-V
--version
Показати дані щодо версії і завершити роботу.
--vgs
--volgroups
--volume-groups
Показати групи томів LVM.
-x Увімкнути трасування викликів програмного інтерфейсу libguestfs.
СТОВПЧИКИ
Зауважте, що порядок і перелік стовпчиків у виведених даних у майбутніх версіях може бути
змінено.
Назва
Назва файлової системи, розділу, блокового пристрою або LVM.
Назви пристроїв та розділів буде показано у форматі канонічних назв libguestfs. Таким
чином, наприклад, /dev/sda2 означатиме другий розділ на першому пристрої.
Якщо параметр --long не вказано, у виведених даних буде лише стовпчик назв.
Тип Тип об'єкта. Наприклад, "filesystem", "lv", "device" тощо.
VFS Якщо буде виявлено відому програмі файлову систему, у цьому стовпчику буде показано
дані щодо неї, наприклад "ext4".
Мітка
Якщо у об'єкта є мітка (яка використовується для ідентифікації та монтування файлових
систем), у цьому стовпчику міститься мітка.
MBR Байт типу розділу, буде показано у форматі двоцифрового шістнадцяткового числа.
Довідковий список типів розділів наведено тут:
http://www.win.tue.nl/~aeb/partitions/partition_types-1.html
Це стосується лише розділів DOS (MBR).
Розмір
Розмір об'єкта у байтах. Якщо використано параметр --human, розмір буде вказано у
зручному для читання форматі.
Основа
У стовпчику батьківських об'єктів показано відношення батьківських і дочірніх
об'єктів.
Наприклад, якщо об'єкт є розділом, у цьому стовпчику міститиметься назва пристрою, на
якому цей розділ розташовано. Якщо об'єкт є логічним томом, у цьому стовпчику буде
наведено назву групи томів.
Якщо батьківських об'єктів декілька, вмістом стовпчика буде список значень
відокремлених комами, наприклад "/dev/sda,/dev/sdb".
UUID
Якщо у об'єкта є UUID (який використовується для ідентифікації та монтування файлових
систем та блокових пристроїв), у цьому стовпчику міститься UUID у форматі рядка.
UUID буде показано, лише якщо вказано параметр --uuid.
ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV
Формат значень, які відокремлено комами (CSV), є оманливо простим. Може здатися, що його
просто обробляти, але насправді це зовсім не так.
Міф: достатньо розділити поля за комами. Реальність: поділ комами не працює у надійний
спосіб. Ось приклад із двома стовпчиками:
"foo,bar",baz
Міф: слід читати файл за рядками, один рядок за одну операцію читання. Реальність: читання
за рядками не працює у надійний спосіб. Ось приклад із одним рядком:
"foo
bar",baz
Для скриптів командної оболонки скористайтеся "csvtool"
(https://github.com/Chris00/ocaml-csv також є серед пакунків основних дистрибутивів
Linux).
Для інших мов програмування використовуйте бібліотеку для обробки даних CSV (наприклад,
"Text::CSV" для Perl або вбудовану бібліотеку csv Python).
У більшості електронних таблиць та баз даних передбачено можливості безпосереднього
імпортування даних CSV.
СТАН ВИХОДУ
Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо
сталася помилка.
ТАКОЖ ПЕРЕГЛЯНЬТЕ
guestfs(3), guestfish(1), virt-cat(1), virt-df(1), virt-drivers(1),
virt-list-filesystems(1), virt-list-partitions(1), csvtool(1), http://libguestfs.org/.
АВТОР
Richard W.M. Jones http://people.redhat.com/~rjones/
АВТОРСЬКІ ПРАВА
Copyright (C) 2010-2023 Red Hat Inc.
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.