NAME

       virt-v2v-hacking -

DESCRIPTION

       First a little history.  Virt-v2v has been through at least two complete rewrites, so this is probably
       about the third version (but we don't intend to rewrite it again).  The previous version was written in
       Perl and can be found here: https://git.fedorahosted.org/git/virt-v2v.git

       The current version started out as almost a line-for-line rewrite of the Perl code in OCaml + C, and it
       still has a fairly similar structure.  Therefore if there are details of this code that you don't
       understand (especially in the details of guest conversion), checking the Perl code may help.

       The files to start with when reading this code are:

       •   types.mli

       •   v2v.ml

       types.mli defines all the structures used and passed around when communicating between different bits of
       the program.  v2v.ml controls how the program runs in stages.

       After studying those files, you may want to branch out into the input modules (input_*), the output
       modules (output_*) or the conversion modules (convert_*).  The input and output modules define -i and -o
       options (see the manual).  The conversion modules define what guest types we can handle and the detailed
       steps involved in converting them.

       Every other file in this directory is a support module / library of some sort.  Some code is written in
       C, especially where we want to use an external C library such as libxml2.

SEE ALSO

       virt-p2v(1), virt-v2v(1).

AUTHORS

       Richard W.M. Jones

COPYRIGHT

       Copyright (C) 2009-2020 Red Hat Inc.

LICENSE

       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 the Free Software Foundation; either version 2 of the License, or
       (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even
       the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
       License for more details.

       You should have received a copy of the GNU General Public License along with this program; if not, write
       to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

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.