summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorCole Robinson <crobinso@redhat.com>2020-01-24 16:18:00 -0500
committerCole Robinson <crobinso@redhat.com>2020-01-24 17:04:29 -0500
commitee9f93074bf74bd2e4c5177d750e7c438c7790cf (patch)
treea3d4ba5ec704ff939b9dd72f58e36961aded1fb9 /man
parentcdbc3f56e61543ca77c1d31463d1d9a1bade900a (diff)
downloadvirt-manager-ee9f93074bf74bd2e4c5177d750e7c438c7790cf.tar.gz
Remove virt-convert
This was raised here: https://www.redhat.com/archives/virt-tools-list/2019-June/msg00117.html Quoting from that: """ virt-convert takes an ovf/ova or vmx file and spits out libvirt XML. It started as a code drop a long time ago that could translate back and forth between vmx, ovf, and virt-image, a long dead appliance format. In 2014 I converted it to do vmx -> libvirt and ovf -> libvirt which was a CLI breaking change, but I never heard a peep of a complaint. It doesn't seem to do a particularly thorough job at its intended goal, I've seen 2-3 bug reports in the past 5 years and generally it doesn't seem to have any users. Let's kill it. If anyone has the desire to keep it alive it could live as a separate project that's a wrapper around virt-install but there's no compelling reason to keep it in virt-manager.git IMO """ Nothing has changed since then, so here is the removal. Signed-off-by: Cole Robinson <crobinso@redhat.com>
Diffstat (limited to 'man')
-rw-r--r--man/virt-convert.pod144
1 files changed, 0 insertions, 144 deletions
diff --git a/man/virt-convert.pod b/man/virt-convert.pod
deleted file mode 100644
index 8bb02ad7..00000000
--- a/man/virt-convert.pod
+++ /dev/null
@@ -1,144 +0,0 @@
-=pod
-
-=head1 NAME
-
-virt-convert - convert ovf/vmx to native libvirt guests
-
-=head1 SYNOPSIS
-
-B<virt-convert> INPUT.vmx|INPUT.ovf|INPUT-DIR|INPUT.zip [OPTIONS]
-
-=head1 DESCRIPTION
-
-B<virt-convert> is a command line tool for converting VMX or OVF virtual
-machines to native libvirt XML. Disk format conversion can also be done
-at the same time.
-
-The simplest invocation is simply: virt-convert INPUT. INPUT might be
-a .vmx or .ovf file, a directory containing a .vmx or .ovf file (and
-likely 1 or more disk images), or an appliance archive like .zip, .tar.gz,
-or .ova. virt-convert will try to do the right thing in each case.
-
-By default, the virt-convert will convert all encountered disk images
-to 'raw' format, sending the output to a new directory location. So the
-original disk images are _not_ altered in place.
-
-
-
-=head1 OPTIONS
-
-=over 4
-
-=item B<--connect> URI
-
-Connect to a non-default hypervisor. See L<virt-install(1)> for details
-
-=back
-
-
-
-
-=head1 CONVERSION OPTIONS
-
-=over 4
-
-=item B<-i> INPUT-FORMAT
-
-=item B<--input-format> INPUT-FORMAT
-
-Input format. This should be auto-detected, but can be forced if necessary. Currently C<vmx> and C<ovf> are supported.
-
-=item B<-D> OUTPUT-FORMAT
-
-=item B<--disk-format> OUTPUT-FORMAT
-
-Output disk format. The default is 'raw', so any encountered disk images will be converted to 'raw' format using L<qemu-img(1)>. Pass C<none> if no conversion should be performed: in this case the images will just be copied to the specified --destination.
-
-=item B<--destination> DIRECTORY
-
-The directory to send converted/copied disk images. If not specified, the hypervisor default is used, typically /var/lib/libvirt/images.
-
-=back
-
-
-
-
-=head1 MISCELLANEOUS OPTIONS
-
-=over 4
-
-=item B<--noautoconsole>
-
-Don't automatically try to connect to the guest console. The default behaviour
-is to launch L<virt-viewer(1)> to display the graphical console, or to run the
-C<virsh> C<console> command to display the text console. Use of this parameter
-will disable this behaviour.
-
-=item B<--print-xml>
-
-Print the generated libvirt XML, but do not perform any disk conversions or
-install/start the guest. This option implies --dry-run.
-
-=item B<--dry-run>
-
-Proceed through the conversion process, but don't convert disks or actually
-write any converted files.
-
-=item B<-h>
-
-=item B<--help>
-
-Show the help message and exit
-
-=item B<--version>
-
-Show program's version number and exit
-
-=item B<-q>
-
-=item B<--quiet>
-
-Avoid verbose output.
-
-=item B<-d>
-
-=item B<--debug>
-
-Print debugging information
-
-=back
-
-
-
-
-=head1 EXAMPLES
-
-Run a fedora18 OVA archive:
-
- # virt-convert fedora18.ova
-
-Run an extracted zip archive containing a centos6 .vmx and .vmdk file, converting the images to qcow2 format
-
- # virt-convert centos6/ --disk-format qcow2
-
-Convert the specified .vmx file. Any references disk images must be in the same directory. Don't change the disk format. Move the disk images to /tmp
-
- # virt-convert foo.vmx --disk-format none --destination /tmp
-
-=head1 BUGS
-
-Please see L<https://virt-manager.org/bugs>
-
-=head1 COPYRIGHT
-
-Copyright (C) Red Hat, Inc, and various contributors.
-This is free software. You may redistribute copies of it under the terms
-of the GNU General Public License C<https://www.gnu.org/licenses/gpl.html>.
-There is NO WARRANTY, to the extent permitted by law.
-
-=head1 SEE ALSO
-
-L<virt-install(1)>, the project website C<https://virt-manager.org>
-
-=cut
-