| virt-filesystems(1) | Virtualization Support | virt-filesystems(1) |
virt-filesystems - 仮想マシンまたはディスクイメージにあるファイルシステム、パーティション、ブロックデバイスおよび LVM の一覧表示
virt-filesystems [--options] -d domname virt-filesystems [--options] -a disk.img [-a disk.img ...]
This tool allows you to discover filesystems, partitions, logical volumes, and their sizes in a disk image or virtual machine. It is a replacement for virt-list-filesystems(1) and virt-list-partitions(1).
One use for this tool is from shell scripts to iterate over all filesystems from a disk image:
for fs in $(virt-filesystems -a disk.img); do # ... done
他の使用方法は、これらのパーティションを変更するために (virt-resize(1) のような) 他のツールを使用する前に、パーティションを一覧表示することです。未知のディスクイメージが含んでいるものについてわからなければ、virt-inspector(1) とともにこのツールを使用します。
さまざまなコマンドラインオプションがこのプログラムが表示するものを制御します。それぞれディスクイメージまたは libvirt 仮想マシンを指定するには -a または -d オプションを与える必要があります。単にそれを指定すると、見つけたファイルシステムを 1 行ごとに 1 つずつこのように表示します:
$ virt-filesystems -a disk.img /dev/sda1 /dev/vg_guest/lv_root
-l または --long を追加すると、追加の情報が出力に含まれます:
$ virt-filesystems -a disk.img -l 名前 種類 VFS ラベル 容量 /dev/sda1 filesystem ext4 boot 524288000 /dev/vg_guest/lv_root filesystem ext4 root 10212081664
--extra を追加すると、マウント不可能な（swap や未知の）ファイルシステムも同様に表示されます:
$ 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 を使用できます。
You can use these options in combination as well (if you want a combination including filesystems, you have to add --filesystems). Notice that some items fall into several categories (eg. /dev/sda1 might be both a partition and a filesystem). These items are listed several times. To get a list which includes absolutely everything that virt-filesystems knows about, use the --all option.
UUIDs (because they are quite long) are not shown by default. Add the --uuid option to display device and filesystem UUIDs in the long output.
--all --long --uuid is a useful combination to display all possible information about everything.
$ virt-filesystems -a win.img --all --long --uuid -h Name Type VFS Label Size Parent 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 を使用します。
ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用する場合、 --format=.. オプションを使用します。
--long 参照。
ゲストのブロックデバイスを直接指定していると（(-a)）、libvirt は何も使用されません。
このオプションは --filesystems を意味します。
--extra を用いると、マウントできないファイルシステムも表示されます。
例:
virt-filesystems --format=raw -a disk.img
forces raw format (no auto-detection) for disk.img.
virt-filesystems --format=raw -a disk.img --format -a another.img
forces raw format (no auto-detection) for disk.img and reverts to auto-detection for another.img.
仮想マシンのディスクイメージが信頼できない raw 形式である場合、 ディスク形式を指定するためにこのオプションを使用すべきです。 これにより、悪意のある仮想マシンにより起こり得る セキュリティ問題を回避できます (CVE-2010-3851)。
A title row is added unless you also specify --no-title.
The extra columns displayed depend on what output you select, and the ordering of columns may change in future versions. Use the title row, --csv output and/or csvtool(1) to match columns to data in external programs.
Use -h if you want sizes to be displayed in human-readable format. The default is to show raw numbers of bytes.
UUID も表示するには --uuid を使用します。
Note that the order of the columns is not fixed, and may change in future versions of virt-filesystems, so using this option may give you unexpected surprises.
出力にある列はこのツールの将来のバージョンにおいて並び替えられる場合や変更される場合があることに注意してください。
For device and partition names these are displayed as canonical libguestfs names, so that for example /dev/sda2 is the second partition on the first device.
--long オプションが指定されていないと、名前の列のみが出力に表示されます。
これは DOS (MBR) パーティションに対してのみ適用できます。
たとえば、オブジェクトがパーティションならば、このカラムは含んでいるデバイスの名前が含まれます。オブジェクトが論理ボリュームならば、このカラムはボリュームグループの名前です。
複数の親があると、この列は (内部に列を持つ) カンマ区切りの一覧になります。例: "/dev/sda,/dev/sdb"。
--uuid オプションが指定されると、 UUID のみが表示されます。
Comma-separated values (CSV) is a deceptive format. It seems like it should be easy to parse, but it is definitely not easy to parse.
神話: ただコンマで項目を区切る。 真実: これは正しく動き ません。この例は 2 つの列があります:
"foo,bar",baz
神話: 同時にファイルの 1 行を読み込みます。 真実: これは正しく動き ません。この例は 1 つの行があります:
"foo bar",baz
For shell scripts, use "csvtool" (https://github.com/Chris00/ocaml-csv also packaged in major Linux distributions).
For other languages, use a CSV processing library (eg. "Text::CSV" for Perl or Python’s built-in csv library).
Most spreadsheets and databases can import CSV directly.
このプログラムは、成功すると 0 を、エラーがあると 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/
Copyright (C) 2010-2012 Red Hat Inc.
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:
| 2019-02-07 | libguestfs-1.40.2 |