名前

       virt-df - 仮想ファイルシステムの使用状況の表示

書式

       すべての仮想マシン:

        virt-df [--options]

       単一の仮想マシン:

        virt-df [--options] -d domname

        virt-df [--options] -a disk.img [-a disk.img ...]

       古い形式:

        virt-df [--options] domname

        virt-df [--options] disk.img [disk.img ...]

説明

       "virt-df" is a command line tool to display free space on virtual machine filesystems.
       Unlike other tools, it doesn't just display the size of disk allocated to a virtual
       machine, but can look inside disk images to see how much space is really being used.

       If used without any -a or -d arguments, "virt-df" checks with libvirt to get a list of all
       active and inactive guests, and performs a "df"-type operation on each one in turn,
       printing out the results.

       If any -a or -d arguments are specified, "virt-df" performs a "df"-type operation on
       either the single named libvirt domain, or on the disk image(s) listed on the command line
       (which must all belong to a single VM).  In this mode (with arguments), "virt-df" will
       only work for a single guest.  If you want to run on multiple guests, then you have to
       invoke "virt-df" multiple times.

       Use the --csv option to get a format which can be easily parsed by other programs.  Other
       options are similar to the standard df(1) command.

例

       Show disk usage for a single libvirt guest called "F14x64".  Make the output human-
       readable:

        # virt-df -d F14x64 -h
        Filesystem                       Size     Used  Available  Use%
        F14x64:/dev/sda1                 484M      66M       393M   14%
        F14x64:/dev/vg_f13x64/lv_root    7.4G     3.4G       4.0G   46%

       Show disk usage for a disk image file called test.img:

        $ virt-df -a test1.img
        Filesystem                  1K-blocks     Used  Available  Use%
        test1.img:/dev/sda1             99099     1551      92432    2%

       If a single guest has multiple disks, use the -a option repeatedly.  A plus sign ("+") is
       displayed for each additional disk.  Note: Do not do this with unrelated guest disks.

        $ virt-df -a Win7x32TwoDisks-a -a Win7x32TwoDisks-b
        Filesystem                   1K-blocks    Used  Available  Use%
        Win7x32TwoDisks-a+:/dev/sda1    102396   24712      77684   25%
        Win7x32TwoDisks-a+:/dev/sda2  12478460 7403416    5075044   60%
        Win7x32TwoDisks-a+:/dev/sdb1    521212   55728     465484   11%

オプション

       --help
           簡単なヘルプを表示します。

       -a FILE
       --add FILE
           Add "FILE" which should be a disk image from a virtual machine.  If the virtual
           machine has multiple block devices, you must supply all of them with separate -a
           options.

           ディスクイメージの形式は自動検知されます。 これを上書きして強制的に特定の形式を使用す
           る場合、 --format=.. オプションを使用します。

       -a URI
       --add URI
           リモートディスクを追加します。 "リモートストレージの追加" in guestfish(1) 参照。

       --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 URI
       --connect URI
           libvirt を使用していると、指定された URI に接続します。  省略すると、デフォルトの
           libvirt ハイパーバイザーに接続します。

           ゲストのブロックデバイスを直接指定していると（(-a)）、libvirt は何も使用されません。

       --csv
           Write out the results in CSV format (comma-separated values).  This format can be
           imported easily into databases and spreadsheets, but read "NOTE ABOUT CSV FORMAT"
           below.

       -d guest
       --domain guest
           名前付きの libvirt 仮想マシンからすべてのディスクを追加します。  名前の代わりに仮想マ
           シンの UUID を使用できます。

       --format=raw|qcow2|..
       --format
           -a オプションは標準状態でディスクイメージの形式を自動検知します。 これを使用することに
           より、コマンドラインで後続の -a オプションのディスク形式を強制的に指定できます。 引数
           なしで --format を使用することにより、 後続の -a オプションに対して自動検知に戻せま
           す。

           例:

            virt-df --format=raw -a disk.img

           forces raw format (no auto-detection) for disk.img.

            virt-df --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)。

       -h
       --human-readable
           読みやすい形式で容量を表示します。

           -h と --csv を同時に使用することはできません。

       -i
       --inodes
           ブロックの代わりに inode を表示します。

       --one-per-guest
           Since libguestfs 1.22, this is the default.  This option does nothing and is left here
           for backwards compatibility with older scripts.

       -P nr_threads
           Since libguestfs 1.22, virt-df is multithreaded and examines guests in parallel.  By
           default the number of threads to use is chosen based on the amount of free memory
           available at the time that virt-df is started.  You can force virt-df to use at most
           "nr_threads" by using the -P option.

           Note that -P 0 means to autodetect, and -P 1 means to use a single thread.

       --uuid
           名前の代わりに UUID を表示します。仮想マシンがマイグレーションまたは名前変更されたと
           き、または偶然 2 つの仮想マシンが同じ名前を持つとき、仮想マシンに使用させるために有用
           です。

           Note that only domains that we fetch from libvirt come with UUIDs.  For disk images,
           we still print the disk image name even when this option is specified.

       -v
       --verbose
           デバッグ用の冗長なメッセージを有効にします。

       -V
       --version
           バージョン番号を表示して、終了します。

       -x  libguestfs API 呼び出しのトレースを有効にします。

STATVFS NUMBERS

       "virt-df" (and df(1)) get information by issuing a statvfs(3) system call.  You can get
       the same information directly, either from the host (using libguestfs) or inside the
       guest:

       ホストから
           このコマンドを実行してください:

            guestfish --ro -d GuestName -i statvfs /

           (change / to see stats for other filesystems).

       仮想マシンの中から
           このコマンドを実行してください:

            python -c 'import os; s = os.statvfs ("/"); print s'

           (change / to see stats for other filesystems).

CSV 形式に関する注意

       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 以外を返します。

関連項目

       df(1), guestfs(3), guestfish(1), virt-drivers(1), virt-filesystems(1),
       http://libguestfs.org/.

著者

       Richard W.M. Jones http://people.redhat.com/~rjones/

COPYRIGHT

       Copyright (C) 2009-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.