X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=df%2Fvirt-df.pod;h=9d05ac97da0944f1b275f6d502d207c4c360c404;hp=93f41dd986f0314f1f099f7bcc9170cab239338f;hb=01f6bce19dbfaf42fa4908683f3cc8785585d023;hpb=94e1465129ae738367421c2515ee23623ee80ed9 diff --git a/df/virt-df.pod b/df/virt-df.pod index 93f41dd..9d05ac9 100755 --- a/df/virt-df.pod +++ b/df/virt-df.pod @@ -22,26 +22,39 @@ Old style: C is a command line tool to display free space on virtual machine filesystems. Unlike other tools, it doesn't just display the -amount of space allocated to a virtual machine, but can look inside -the virtual machine to see how much space is really being used. +size of disk allocated to a virtual machine, but can look inside disk +images to see how much space is really being used. -It is like the L command, but for virtual machines, except that -it also works for Windows virtual machines. +If used without any I<-a> or I<-d> arguments, C checks with +libvirt to get a list of all active and inactive guests, and performs +a C-type operation on each one in turn, printing out the results. -If used without any arguments, C checks with libvirt to get a -list of all active and inactive guests, and performs a C-type -operation on each one in turn, printing out the results. +If any I<-a> or I<-d> arguments are specified, C performs a +C-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), C will I. If you want to run on multiple guests, then +you have to invoke C multiple times. -If used with any argument(s), C performs a C-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), C will I. If you want to run on multiple guests, then you have -to invoke C multiple times. +Use the I<--csv> option to get a format which can be easily parsed by +other programs. Other options are similar to the standard L +command. -Use the C<--csv> option to get a format which can be easily parsed by -other programs. Other options are mostly similar to standard C -options. See below for the complete list. +=head1 EXAMPLES + +Show disk usage for a single libvirt guest called C. 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 C: + + $ virt-df -a test1.img + Filesystem 1K-blocks Used Available Use% + test1.img:/dev/sda1 99099 1551 92432 2% =head1 OPTIONS @@ -72,11 +85,18 @@ connect to the default libvirt hypervisor. If you specify guest block devices directly (I<-a>), then libvirt is not used at all. +=item B<--csv> + +Write out the results in CSV format (comma-separated values). This +format can be imported easily into databases and spreadsheets, but +read L below. + =item B<-d> guest =item B<--domain> guest -Add all the disks from the named libvirt guest. +Add all the disks from the named libvirt guest. Domain UUIDs can be +used instead of names. =item B<--format=raw|qcow2|..> @@ -110,7 +130,9 @@ Print sizes in human-readable format. You are not allowed to use I<-h> and I<--csv> at the same time. -=item B<--inodes> | B<-i> +=item B<-i> + +=item B<--inodes> Print inodes instead of blocks. @@ -199,10 +221,10 @@ manual page L for details. =head1 SEE ALSO +L, L, L, L, -L, L. =head1 AUTHOR @@ -211,7 +233,7 @@ Richard W.M. Jones L =head1 COPYRIGHT -Copyright (C) 2009-2010 Red Hat Inc. +Copyright (C) 2009-2011 Red Hat Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by