.\" Automatically generated by Podwrapper::Man 1.44.0 (Pod::Simple 3.40) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "virt-filesystems 1" .TH virt-filesystems 1 "2021-01-05" "libguestfs-1.44.0" "Virtualization Support" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "НАЗВА" .IX Header "НАЗВА" virt-filesystems — програма для показу списку файлових систем, розділів, блокових пристроїв, \s-1LVM\s0 у віртуальних машинах або образах дисків .SH "КОРОТКИЙ ОПИС" .IX Header "КОРОТКИЙ ОПИС" .Vb 1 \& virt\-filesystems [\-\-параметри] \-d назва_домену \& \& virt\-filesystems [\-\-параметри] \-a диск.img [\-a диск.img ...] .Ve .SH "ОПИС" .IX Header "ОПИС" За допомогою цієї програми ви зможете виявляти файлові системи, розділи диска, логічні томи та визначати їхні розміри у образі диска або у віртуальній машині. Програма є замінником \fBvirt\-list\-filesystems\fR\|(1) та \&\fBvirt\-list\-partitions\fR\|(1). .PP Одним із варіантів використання цієї програми є додавання її у скрипти для ітеративного обходу усіх файлових систем на образі диска: .PP .Vb 3 \& for fs in $(virt\-filesystems \-a disk.img); do \& # ... \& done .Ve .PP Це одним використанням програми є виведення списку розділів до використання іншого інструмента для внесення змін до цих розділів (зокрема програми \&\fBvirt\-resize\fR\|(1)). Якщо вам цікавий вміст невідомого образу диска, скористайтеся цим інструментом разом із \fBvirt\-inspector\fR\|(1). .PP Керувати виведенням даних цією програмою можна за допомогою різноманітних параметрів командного рядка. Вам слід задати параметр \fI\-a\fR або \fI\-d\fR, щоб визначити образ диска або гостьову систему libvirt. Якщо ви вкажете один з цих параметрів, програма покаже знайдені файлові системи, по одній на рядок, ось так: .PP .Vb 3 \& $ virt\-filesystems \-a disk.img \& /dev/sda1 \& /dev/vg_guest/lv_root .Ve .PP Якщо ви додасте \fI\-l\fR або \fI\-\-long\fR, у виведених даних буде показано додаткову інформацію: .PP .Vb 4 \& $ virt\-filesystems \-a disk.img \-l \& Назва Тип ВФС Мітка Розмір \& /dev/sda1 filesystem ext4 boot 524288000 \& /dev/vg_guest/lv_root filesystem ext4 root 10212081664 .Ve .PP Якщо ви додасте параметр \fI\-\-extra\fR, буде показано і файлові системи, які непридатні до монтування (резервна пам'ять, невідомий формат): .PP .Vb 5 \& $ virt\-filesystems \-a disk.img \-\-extra \& /dev/sda1 \& /dev/vg_guest/lv_root \& /dev/vg_guest/lv_swap \& /dev/vg_guest/lv_data .Ve .PP Якщо ви додасте параметр \fI\-\-partitions\fR, буде показано розділи, а не файлові системи: .PP .Vb 3 \& $ virt\-filesystems \-a disk.img \-\-partitions \& /dev/sda1 \& /dev/sda2 .Ve .PP У подібний спосіб, ви можете скористатися параметрами \fI\-\-logical\-volumes\fR, \&\fI\-\-volume\-groups\fR, \fI\-\-physical\-volumes\fR, \fI\-\-block\-devices\fR, щоб отримати список цих записів. .PP Ви можете також скористатися цими параметрами у поєднанні (якщо вам потрібна комбінація із файловими системами, вам слід додати \&\fI\-\-filesystems\fR). Зауважте, що деякі з пунктів списку можуть належати одночасно декільком категоріям (наприклад, \fI/dev/sda1\fR може бути як розділом, так і файловою системою). Такі пункти буде показано відповідну кількість разів. Щоб отримати список, який міститиме абсолютно усе, про що знає virt-filesystems, скористайтеся параметром \fI\-\-all\fR. .PP \&\s-1UUID\s0 (оскільки вони є доволі довгими) типово показано не буде. Додайте параметр \fI\-\-uuid\fR, щоб ознайомитися із \s-1UUID\s0 пристроїв і файлових систем у розширених даних. .PP \&\fI\-\-all \-\-long \-\-uuid\fR є корисною комбінацією для показу усіх доступних даних щодо усього. .PP .Vb 7 \& $ 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 \- \- .Ve .PP Для отримання зручних для машинної обробки даних скористайтеся параметром \&\fI\-\-csv\fR. Дані буде виведено у форматі значень відокремлених комами. .SH "ПАРАМЕТРИ" .IX Header "ПАРАМЕТРИ" .IP "\fB\-\-help\fR" 4 .IX Item "--help" Показати коротку довідку. .IP "\fB\-a\fR файл" 4 .IX Item "-a файл" .PD 0 .IP "\fB\-\-add\fR файл" 4 .IX Item "--add файл" .PD Додати \fIфайл\fR, який має бути образом диска з віртуальної машини. Якщо у віртуальній машині декілька блокових пристроїв, вам слід вказати їх усі за допомогою окремих записів параметра \fI\-a\fR. .Sp Формат образу диска визначається автоматично. Щоб перевизначити його і примусово використати певний формат, скористайтеся параметром \&\fI\-\-format=..\fR. .IP "\fB\-a адреса\fR" 4 .IX Item "-a адреса" .PD 0 .IP "\fB\-\-add адреса\fR" 4 .IX Item "--add адреса" .PD Додати віддалений диск. Див. \*(L"ДОДАВАННЯ ВІДДАЛЕНОГО СХОВИЩА\*(R" in \fBguestfish\fR\|(1). .IP "\fB\-\-all\fR" 4 .IX Item "--all" Вивести усе. У поточній версії це те саме, що вказати такі параметри: \&\fI\-\-filesystems\fR, \fI\-\-extra\fR, \fI\-\-partitions\fR, \fI\-\-block\-devices\fR, \&\fI\-\-logical\-volumes\fR, \fI\-\-volume\-groups\fR, \fI\-\-physical\-volumes\fR. (У майбутньому до цього списку може бути додано інші пункти). .Sp Див. також \fI\-\-long\fR. .IP "\fB\-\-blkdevs\fR" 4 .IX Item "--blkdevs" .PD 0 .IP "\fB\-\-block\-devices\fR" 4 .IX Item "--block-devices" .PD Показати список блокових пристроїв. .IP "\fB\-\-blocksize=512\fR" 4 .IX Item "--blocksize=512" .PD 0 .IP "\fB\-\-blocksize=4096\fR" 4 .IX Item "--blocksize=4096" .IP "\fB\-\-blocksize\fR" 4 .IX Item "--blocksize" .PD This parameter sets the sector size of the disk image. It affects all explicitly added subsequent disks after this parameter. Using \&\fI\-\-blocksize\fR with no argument switches the disk sector size to the default value which is usually 512 bytes. See also \&\*(L"guestfs_add_drive_opts\*(R" in \fBguestfs\fR\|(3). .IP "\fB\-c\fR адреса" 4 .IX Item "-c адреса" .PD 0 .IP "\fB\-\-connect\fR адреса" 4 .IX Item "--connect адреса" .PD Якщо використовується libvirt, встановити з’єднання з вказаним \fI\s-1URI\s0\fR. Якщо пропущено, з’єднання буде встановлено з типовим гіпервізором libvirt. .Sp Якщо вказати блокові пристрої гостьових систем безпосередньо (\fI\-a\fR), libvirt не буде використовуватися взагалі. .IP "\fB\-\-csv\fR" 4 .IX Item "--csv" Вивести результати до формату \s-1CSV\s0 (записів, відокремлених комами). Дані у цьому форматі можна просто імпортувати до баз даних і електронних таблиць. Втім, варто ознайомитися із розділом \*(L"НОТАТКА ЩОДО ФОРМАТУ \s-1CSV\*(R"\s0, наведеним нижче. .IP "\fB\-d\fR гість" 4 .IX Item "-d гість" .PD 0 .IP "\fB\-\-domain\fR гість" 4 .IX Item "--domain гість" .PD Додати всі диски з вказаної гостьової системи libvirt. \s-1UUID\s0 доменів можна використовувати замість назв. .IP "\fB\-\-echo\-keys\fR" 4 .IX Item "--echo-keys" Типово, якщо virt-filesystems попросить вас ввести ключ або пароль, програма не відтворюватиме введені символи на екрані. Якщо ви не боїтеся TEMPEST\-нападів, або у вашій кімнаті нікого, окрім вас, немає, ви можете скористатися цим прапорцем, щоб бачити, які саме символи ви вводите. .IP "\fB\-\-extra\fR" 4 .IX Item "--extra" Це спричинить показ файлових систем, які не є звичайними файловими системами, які придатні до монтування. До цієї категорії включено розділи резервної пам'яті та файлові системи, які є порожніми або містять невідомі дані. .Sp Цей параметр автоматично встановлює параметр \fI\-\-filesystems\fR. .IP "\fB\-\-filesystems\fR" 4 .IX Item "--filesystems" Показати список придатних до монтування систем. Якщо параметр показу не було визначено, цей параметр буде додано до команди. .Sp Якщо було використано параметр \fI\-\-extra\fR, буде показано і непридатні до монтування файлові системи. .IP "\fB\-\-format=raw|qcow2|..\fR" 4 .IX Item "--format=raw|qcow2|.." .PD 0 .IP "\fB\-\-format\fR" 4 .IX Item "--format" .PD Типовим значенням для параметра \fI\-a\fR є автоматичне визначення формату образу диска. Використання цього параметра примусово визначає значення параметрів \fI\-a\fR формату диска у наступному рядку команди. Використання параметра \fI\-\-format\fR без аргументу перемикає програму у режим автоматичного визначення у наступних параметрах \fI\-a\fR. .Sp Приклад: .Sp .Vb 1 \& virt\-filesystems \-\-format=raw \-a диск.img .Ve .Sp примусове встановлення формату без обробки (без автоматичного визначення) для \fIdisk.img\fR. .Sp .Vb 1 \& virt\-filesystems \-\-format=raw \-a диск.img \-\-format \-a інший_диск.img .Ve .Sp примусове встановлення формату без обробки (без автоматичного визначення) для \fIdiskimg\fR і повернення до автоматичного визначення для \fIanother.img\fR. .Sp Якщо ви користуєтеся ненадійними образами гостьових систем у необробленому форматі, вам слід скористатися цим параметром для визначення формату диска. Таким чином можна уникнути можливих проблем з захистом для сформованих зловмисниками гостьових систем (\s-1CVE\-2010\-3851\s0). .IP "\fB\-h\fR" 4 .IX Item "-h" .PD 0 .IP "\fB\-\-human\-readable\fR" 4 .IX Item "--human-readable" .PD У режимі \fI\-\-long\fR показувати розміри у зручному для читання форматі. .IP "\fB\-\-keys\-from\-stdin\fR" 4 .IX Item "--keys-from-stdin" Прочитати параметри ключа або пароля із джерела стандартного введення. Типово програма намагається читати паролі від користувача відкриттям \fI/dev/tty\fR. .Sp If there are multiple encrypted devices then you may need to supply multiple keys on stdin, one per line. .IP "\fB\-l\fR" 4 .IX Item "-l" .PD 0 .IP "\fB\-\-long\fR" 4 .IX Item "--long" .PD Показувати додаткові стовпчики даних («довгий формат»). .Sp Якщо ви не додасте параметр \fI\-\-no\-title\fR, буде додано рядок заголовка. .Sp Вміст додаткових стовпчиків залежить від вибраного виведення, а упорядкування стовпчиків може змінитися у майбутніх версіях. Для того, щоб виведені дані відповідали вхідним даним зовнішніх програм, скористайтеся рядком заголовків, виведенням \fI\-\-csv\fR і/або \fBcsvtool\fR\|(1). .Sp Якщо дані має бути виведено у зручному для читання людиною форматі, скористайтеся параметром \fI\-h\fR. Типово, буде показано розміри у \fIбайтах\fR. .Sp Скористайтеся параметром \fI\-\-uuid\fR, щоб було показано також \s-1UUID.\s0 .IP "\fB\-\-lvs\fR" 4 .IX Item "--lvs" .PD 0 .IP "\fB\-\-logvols\fR" 4 .IX Item "--logvols" .IP "\fB\-\-logical\-volumes\fR" 4 .IX Item "--logical-volumes" .PD Показати логічні томи \s-1LVM.\s0 У цьому режимі томи буде показано незалежно від того, чи містяться на логічних томах файлові системи. .IP "\fB\-\-no\-title\fR" 4 .IX Item "--no-title" У режимі \fI\-\-long\fR не додавати рядок заголовків. .Sp Зауважте, що порядок стовпчиків не є фіксованим і може змінитися у майбутніх версіях virt-filesystems; отже, використання цього параметра може призвести до не зовсім очікуваних наслідків. .IP "\fB\-\-parts\fR" 4 .IX Item "--parts" .PD 0 .IP "\fB\-\-partitions\fR" 4 .IX Item "--partitions" .PD Показати розділи. У цьому режимі розділи буде показано незалежно від того, чи містяться на розділах файлові системи. .IP "\fB\-\-pvs\fR" 4 .IX Item "--pvs" .PD 0 .IP "\fB\-\-physvols\fR" 4 .IX Item "--physvols" .IP "\fB\-\-physical\-volumes\fR" 4 .IX Item "--physical-volumes" .PD Показати фізичні томи \s-1LVM.\s0 .IP "\fB\-\-uuid\fR" 4 .IX Item "--uuid" .PD 0 .IP "\fB\-\-uuids\fR" 4 .IX Item "--uuids" .PD У режимі \fI\-\-long\fR буде також виведено \s-1UUID.\s0 .IP "\fB\-v\fR" 4 .IX Item "-v" .PD 0 .IP "\fB\-\-verbose\fR" 4 .IX Item "--verbose" .PD Увімкнути докладний показ повідомлень з метою діагностики. .IP "\fB\-V\fR" 4 .IX Item "-V" .PD 0 .IP "\fB\-\-version\fR" 4 .IX Item "--version" .PD Показати дані щодо версії і завершити роботу. .IP "\fB\-\-vgs\fR" 4 .IX Item "--vgs" .PD 0 .IP "\fB\-\-volgroups\fR" 4 .IX Item "--volgroups" .IP "\fB\-\-volume\-groups\fR" 4 .IX Item "--volume-groups" .PD Показати групи томів \s-1LVM.\s0 .IP "\fB\-x\fR" 4 .IX Item "-x" Увімкнути трасування викликів програмного інтерфейсу libguestfs. .SH "СТОВПЧИКИ" .IX Header "СТОВПЧИКИ" Зауважте, що порядок і перелік стовпчиків у виведених даних у майбутніх версіях може бути змінено. .IP "\fBНазва\fR" 4 .IX Item "Назва" Назва файлової системи, розділу, блокового пристрою або \s-1LVM.\s0 .Sp Назви пристроїв та розділів буде показано у форматі канонічних назв libguestfs. Таким чином, наприклад, \fI/dev/sda2\fR означатиме другий розділ на першому пристрої. .Sp Якщо параметр \fI\-\-long\fR \fBне\fR вказано, у виведених даних буде лише стовпчик назв. .IP "\fBТип\fR" 4 .IX Item "Тип" Тип об'єкта. Наприклад, \f(CW\*(C`filesystem\*(C'\fR, \f(CW\*(C`lv\*(C'\fR, \f(CW\*(C`device\*(C'\fR тощо. .IP "\fB\s-1VFS\s0\fR" 4 .IX Item "VFS" Якщо буде виявлено відому програмі файлову систему, у цьому стовпчику буде показано дані щодо неї, наприклад \f(CW\*(C`ext4\*(C'\fR. .IP "\fBМітка\fR" 4 .IX Item "Мітка" Якщо у об'єкта є мітка (яка використовується для ідентифікації та монтування файлових систем), у цьому стовпчику міститься мітка. .IP "\fB\s-1MBR\s0\fR" 4 .IX Item "MBR" Байт типу розділу, буде показано у форматі двоцифрового шістнадцяткового числа. Довідковий список типів розділів наведено тут: http://www.win.tue.nl/~aeb/partitions/partition_types\-1.html .Sp Це стосується лише розділів \s-1DOS\s0 (\s-1MBR\s0). .IP "\fBРозмір\fR" 4 .IX Item "Розмір" Розмір об'єкта у байтах. Якщо використано параметр \fI\-\-human\fR, розмір буде вказано у зручному для читання форматі. .IP "\fBОснова\fR" 4 .IX Item "Основа" У стовпчику батьківських об'єктів показано відношення батьківських і дочірніх об'єктів. .Sp Наприклад, якщо об'єкт є розділом, у цьому стовпчику міститиметься назва пристрою, на якому цей розділ розташовано. Якщо об'єкт є логічним томом, у цьому стовпчику буде наведено назву групи томів. .Sp Якщо батьківських об'єктів декілька, вмістом стовпчика буде список значень відокремлених комами, наприклад \f(CW\*(C`/dev/sda,/dev/sdb\*(C'\fR. .IP "\fB\s-1UUID\s0\fR" 4 .IX Item "UUID" Якщо у об'єкта є \s-1UUID\s0 (який використовується для ідентифікації та монтування файлових систем та блокових пристроїв), у цьому стовпчику міститься \s-1UUID\s0 у форматі рядка. .Sp \&\s-1UUID\s0 буде показано, лише якщо вказано параметр \fI\-\-uuid\fR. .SH "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV" .IX Header "ЗАУВАЖЕННЯ ЩОДО ФОРМАТУ CSV" Формат значень, які відокремлено комами (\s-1CSV\s0), є оманливо простим. Може \&\fIздатися\fR, що його просто обробляти, але насправді це зовсім не так. .PP Міф: достатньо розділити поля за комами. Реальність: поділ комами \fIне\fR працює у надійний спосіб. Ось приклад із двома стовпчиками: .PP .Vb 1 \& "foo,bar",baz .Ve .PP Міф: слід читати файл за рядками, один рядок за одну операцію читання. Реальність: читання за рядками \fIне\fR працює у надійний спосіб. Ось приклад із одним рядком: .PP .Vb 2 \& "foo \& bar",baz .Ve .PP Для скриптів командної оболонки скористайтеся \f(CW\*(C`csvtool\*(C'\fR (https://github.com/Chris00/ocaml\-csv також є серед пакунків основних дистрибутивів Linux). .PP Для інших мов програмування використовуйте бібліотеку для обробки даних \s-1CSV\s0 (наприклад, \f(CW\*(C`Text::CSV\*(C'\fR для Perl або вбудовану бібліотеку csv Python). .PP У більшості електронних таблиць та баз даних передбачено можливості безпосереднього імпортування даних \s-1CSV.\s0 .SH "СТАН ВИХОДУ" .IX Header "СТАН ВИХОДУ" Ця програма повертає значення 0 у разі успішного завершення і ненульове значення, якщо сталася помилка. .SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ" .IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ" \&\fBguestfs\fR\|(3), \fBguestfish\fR\|(1), \fBvirt\-cat\fR\|(1), \fBvirt\-df\fR\|(1), \&\fBvirt\-list\-filesystems\fR\|(1), \fBvirt\-list\-partitions\fR\|(1), \fBcsvtool\fR\|(1), http://libguestfs.org/. .SH "АВТОР" .IX Header "АВТОР" Richard W.M. Jones http://people.redhat.com/~rjones/ .SH "АВТОРСЬКІ ПРАВА" .IX Header "АВТОРСЬКІ ПРАВА" © Red Hat Inc., 2010–2012 .SH "LICENSE" .IX Header "LICENSE" .SH "BUGS" .IX Header "BUGS" To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools .PP To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools .PP When reporting a bug, please supply: .IP "\(bu" 4 The version of libguestfs. .IP "\(bu" 4 Where you got libguestfs (eg. which Linux distro, compiled from source, etc) .IP "\(bu" 4 Describe the bug accurately and give a way to reproduce it. .IP "\(bu" 4 Run \fBlibguestfs\-test\-tool\fR\|(1) and paste the \fBcomplete, unedited\fR output into the bug report.