virt-filesystems(1)

НАЗВА
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-list-filesystems(1), virt-list-partitions(1), csvtool(1), http://libguestfs.org/.

АВТОР
Richard W.M. Jones http://people.redhat.com/~rjones/

АВТОРСЬКІ ПРАВА
© Red Hat Inc., 2010–2012

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.