Read key or passphrase parameters from stdin. The default is
to try to read passphrases from the user by opening C</dev/tty>.
-=item B<-l> | B<--long>
+=item B<-l>
-=item B<-R> | B<--recursive>
+=item B<--long>
+
+=item B<-R>
+
+=item B<--recursive>
Select the mode. With neither of these options, C<virt-ls> produces a
simple, flat list of the files in the named directory. See
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.
By default, no backup file is made.
-=item B<--connect URI> | B<-c URI>
+=item B<-c URI>
+
+=item B<--connect URI>
If using libvirt, connect to the given I<URI>. If omitted, then we
connect to the default libvirt hypervisor.
=over 4
-=item B<-a image> | B<--add image>
+=item B<-a image>
+
+=item B<--add image>
Add a block device or virtual machine image.
The format of the disk image is auto-detected. To override this and
force a particular format use the I<--format=..> option.
-=item B<-c URI> | B<--connect URI>
+=item B<-c URI>
+
+=item B<--connect URI>
When used in conjunction with the I<-d> option, this specifies
the libvirt URI to use. The default is to use the default libvirt
connection.
-=item B<-d libvirt-domain> | B<--domain libvirt-domain>
+=item B<-d libvirt-domain>
+
+=item B<--domain libvirt-domain>
Add disks from the named libvirt domain. If the I<--ro> option is
also used, then any libvirt domain can be used. However in write
worried about Tempest attacks and there is no one else in the room
you can specify this flag to see what you are typing.
-=item B<--format=raw|qcow2|..> | B<--format>
+=item B<--format=raw|qcow2|..>
+
+=item B<--format>
The default for the I<-a> option is to auto-detect the format of the
disk image. Using this forces the disk format for I<-a> options which
Display brief help and exit.
-=item B<-i> | B<--inspector>
+=item B<-i>
+
+=item B<--inspector>
Using L<virt-inspector(1)> code, inspect the disks looking for
an operating system and mount filesystems as they would be
-m /dev/sda1:/:acl,user_xattr
-=item B<-n> | B<--no-sync>
+=item B<-n>
+
+=item B<--no-sync>
By default, we attempt to sync the guest disk when the FUSE mountpoint
is unmounted. If you specify this option, then we don't attempt to
sync the disk. See the discussion of autosync in the L<guestfs(3)>
manpage.
-=item B<-o option> | B<--option option>
+=item B<-o option>
+
+=item B<--option option>
Pass extra options to FUSE.
=back
-=item B<-r> | B<--ro>
+=item B<-r>
+
+=item B<--ro>
Add devices and mount everything read-only. Also disallow writes and
make the disk appear read-only to FUSE.
Enable SELinux support for the guest.
-=item B<-v> | B<--verbose>
+=item B<-v>
+
+=item B<--verbose>
Enable verbose messages from underlying libguestfs.
-=item B<-V> | B<--version>
+=item B<-V>
+
+=item B<--version>
Display the program version and exit.
-=item B<-w> | B<--rw>
+=item B<-w>
+
+=item B<--rw>
This changes the I<-a>, I<-d> and I<-m> options so that disks are
added and mounts are done read-write.
See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>.
-=item B<-x> | B<--trace>
+=item B<-x>
+
+=item B<--trace>
Trace libguestfs calls and entry into each FUSE function.
=over 4
-=item B<efi> | B<gpt>
+=item B<efi>
+
+=item B<gpt>
Intel EFI / GPT partition table.
from Linux and Intel-based Mac OS X. It also has limited backwards
compatibility with the C<mbr> format.
-=item B<mbr> | B<msdos>
+=item B<mbr>
+
+=item B<msdos>
The standard PC \"Master Boot Record\" (MBR) format used
by MS-DOS and Windows. This partition type will B<only> work
AIX disk labels.
-=item B<amiga> | B<rdb>
+=item B<amiga>
+
+=item B<rdb>
Amiga \"Rigid Disk Block\" format.
my $uri;
-=item B<--connect URI> | B<-c URI>
+=item B<-c URI>
+
+=item B<--connect URI>
If using libvirt, connect to the given I<URI>. If omitted, then we
connect to the default libvirt hypervisor.
my $long;
-=item B<-l> | B<--long>
+=item B<-l>
+
+=item B<--long>
With this option, C<virt-list-filesystems> displays the type of
each filesystem too (where "type" means C<ext3>, C<xfs> etc.)
my $all;
-=item B<-a> | B<--all>
+=item B<-a>
+
+=item B<--all>
Normally we only show mountable filesystems. If this option
is given then swap devices are shown too.
my $uri;
-=item B<--connect URI> | B<-c URI>
+=item B<-c URI>
+
+=item B<--connect URI>
If using libvirt, connect to the given I<URI>. If omitted, then we
connect to the default libvirt hypervisor.
my $human;
-=item B<-h> | B<--human-readable>
+=item B<-h>
+
+=item B<--human-readable>
Show sizes in human-readable form (eg. "1G").
my $long;
-=item B<-l> | B<--long>
+=item B<-l>
+
+=item B<--long>
With this option, C<virt-list-partitions> displays the type
and size of each partition too (where "type" means C<ext3>, C<pv> etc.)
my $total;
-=item B<-t> | B<--total>
+=item B<-t>
+
+=item B<--total>
Display the total size of each block device (as a separate row or
rows).
my $uri;
-=item B<--connect URI> | B<-c URI>
+=item B<-c URI>
+
+=item B<--connect URI>
If using libvirt, connect to the given I<URI>. If omitted, then we
connect to the default libvirt hypervisor.
my $mode;
-=item B<-x> | B<--extract> | B<--download>
+=item B<-x>
+
+=item B<--extract>
+
+=item B<--download>
-=item B<-u> | B<--upload>
+=item B<-u>
+
+=item B<--upload>
Use I<-x> to extract (download) a directory from a virtual machine
to a local tarball.
my $gzip;
-=item B<-z> | B<--gzip>
+=item B<-z>
+
+=item B<--gzip>
Specify that the input or output tarball is gzip-compressed.
my $uri;
-=item B<--connect URI> | B<-c URI>
+=item B<-c URI>
+
+=item B<--connect URI>
If using libvirt, connect to the given I<URI>. If omitted, then we
connect to the default libvirt hypervisor.
git.annexia.org / libguestfs.git / commitdiff