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.

virt-v2v-2.4.0                                     2024-04-01                                virt-v2v-hacking(1)