diff options
author | Cole Robinson <crobinso@redhat.com> | 2020-01-24 16:18:00 -0500 |
---|---|---|
committer | Cole Robinson <crobinso@redhat.com> | 2020-01-24 17:04:29 -0500 |
commit | ee9f93074bf74bd2e4c5177d750e7c438c7790cf (patch) | |
tree | a3d4ba5ec704ff939b9dd72f58e36961aded1fb9 /man | |
parent | cdbc3f56e61543ca77c1d31463d1d9a1bade900a (diff) | |
download | virt-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.pod | 144 |
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 - |