[% topdir = ".." -%]
[% PROCESS globals -%]
[% WRAPPER page
   title = "About virt tools and the virt tools site"
   h1 = "About virt tools and the virt tools site"
   section = "about"
   local_stylesheet = 1
%]

<p>
Virt Tools are open source virtualization management tools for Linux
system administrators.
</p>

<p>
This site provides tutorials, videos, documentation, online help and
roadmaps to help you get started with and understand the tools.
</p>

<p>
This site is an umbrella site covering many different virt projects.
Those sites also contain documentation and tutorials, and we link to
the best pages from here.
</p>

[% WRAPPER h2 h2="Contributing to the virt tools site" anchor="contribute" %]

<p>
This site is open source.  You can clone the sources from
<a href="http://git.fedorahosted.org/git/?p=virt-tools.git">this git
repository</a> (in the website subdirectory).  We welcome
contributions.  Please <a href="[% topdir %]/contact/">contact us
through the mailing list</a>.
</p>

[% END %]

[% WRAPPER h2 h2="The upstream virt projects" anchor="projects" %]

[%-
# Alphabetical order of project name.
  upstreams = [
    { url = "http://augeas.net/",
      project = "augeas",
      description = "Library and tools for Linux configuration
file editing from scripts.  Tools include <code>augtool</code>.
The Augeas APIs are exposed through libguestfs, allowing you to
make structured edits to Linux virtual machines." },
    { url = "http://people.redhat.com/~rjones/guestfs-browser/",
      project = "guest filesystem browser",
      description = "A graphical filesystem browser for virtual machines.
Uses libguestfs and libvirt." },
    { url = "http://libguestfs.org/hivex.3.html",
      project = "hivex",
      description = "Library and tools for Windows Registry
(<q>hive file</q>) editing.
This functionality is exposed through libguestfs, allowing you
to make changes to the Registry in your Windows guests." },
    { url = "http://libguestfs.org/",
      project = "libguestfs",
      description = "Library and tools for editing disk images
and files within virtual machines.  Tools include:
<code>guestfish</code>,
<code>virt-cat</code>,
<code>virt-df</code>,
<code>virt-inspector</code>,
<code>virt-resize</code>,
<code>virt-rescue</code>,
<code>virt-win-reg</code> and
<code>guestmount</code>." },
    { url = "http://libvirt.org/",
      project = "libvirt",
      description = "Libvirt is a comprehensive API
and set of tools for managing
virtual machines across many supported hypervisors including
KVM, Xen, VirtualBox, VMWare and more.  Many of the virt tools
use libvirt for virtual machine management.  Libvirt tools include
<code>virsh</code> (the virtual shell)." },
    { url = "https://fedorahosted.org/netcf/",
      project = "netcf",
      description = "Library and tools for network configuration.
Tools include <code>ncftool</code>." },
    { url = "http://people.redhat.com/dlutter/virt-image/",
      project = "virt-image",
      description = "Virt-image is a portable format for interchange of virtual
machines, and a command line tool for handling that format." },
    { url = "http://virt-manager.org/",
      project = "virt-install",
      description = "Virt-install is a command line tool for installing
new virtual machines.  It is also used as part of virt-manager." },
    { url = "http://virt-manager.org/",
      project = "virt-manager",
      description = "Virt-manager is a graphical tool for creating
and managing virtual machines.  It offers simple, rapid management
when you don't need the scalability and complexity of larger
more advanced programs." },
    { url = "http://people.redhat.com/~rjones/virt-p2v/",
      project = "virt-p2v",
      description = "Virt-p2v is a live CD that you can use to
convert a physical machine into a virtual machine." },
    { url = "http://people.redhat.com/~rjones/virt-top/",
      project = "virt-top",
      description = "Virt-top is a monitoring program, like <code>top</code>
for virtual machines.  It can display CPU, disk and network statistics,
and also output to a file or database." },
    { url = "",
      project = "virt-v2v",
      description = "Virt-v2v allows you to convert virtual machines
from Xen and VMWare over to KVM." },
    { url = "http://virt-manager.org/",
      project = "virt-viewer",
      description = "Virt-viewer is a console viewer for virtual
machines.  It is also used as part of virt-manager." },
    { url = "http://people.redhat.com/~rjones/virt-what/",
      project = "virt-what",
      description = "Virt-what is a set of shell scripts that you
can use to detect if your program is running inside a virtual machine." },
  ]

# Others:
#
# "text" virt-manager ?
# matahari           ?
# virt-clone
# virt-dmesg         
# virt-uname         
-%]

<table>
[% FOREACH x IN upstreams -%]
<tr>
<th>
[% IF x.url -%]
<a href="[% x.url %]">
[%- END -%]
[% x.project %]
[%- IF x.url -%]
</a>
[%- END %]
</th>
<td> [% x.description %] </td>
</tr>
[%- END %]
</table>

[% END %]

[% WRAPPER h2 h2="License" anchor="license" %]

<p>
The main content of this site is copyright &copy; [% year %]
<a href="http://redhat.com/">Red Hat Inc.</a> and dual licensed under
either the <a href="http://www.gnu.org/licenses/gpl-2.0.html">GNU General Public License, version 2 or (at your option) any
later version</a>, or
<a href="http://creativecommons.org/licenses/by-sa/3.0/">Creative
Commons Attribution-Share Alike 3.0 Unported</a>.  Tutorials, videos
and other documentation are owned by the respective authors.
</p>

[% END %]

[% WRAPPER h2 h2="Technology" anchor="technology" %]

<p>
The content of the site is generated from templates using the
<a href="http://template-toolkit.org/">Template Toolkit</a>.
</p>

[% END %]

[% END -%]