Subject: PSARC FastTrack [03/23/2007]: libvirt - a LGPL library to control guest domains


Template Version: @(#)sac_nextcase 1.2 04/14/09 SMI
Copyright 2007 Sun Microsystems, Inc.
1. Introduction
    1.1. Project/Component Working Name:
	 libvirt - a LGPL library to control guest domains
    1.2. Name of Document Author/Supplier:
	 Author:  Mark Johnson
    1.3  Date of This Document:
	16 March, 2007
4. Technical Description

I am sponsoring the following fast track for Mark Johnson.  The timer
for this case is set to expire on March 23, 2007.

- john

======================

libvirt - a LGPL library to control guest domains

1.  Summary

This fast-track introduces libvirt (http://www.libvirt.org/),
into the xen-gate and will be delivered via the ON consolidation.

Patch release binding is requested.


2.  Discussion

 From www.libvirt.org...
     The library's aim is to provide a "long term stable
     C API initially for the Xen paravirtualization but
     should be able to integrate other virtualization
     mechanisms if needed."

virt-manager, which is a gnome based GUI for managing
guest domains (http://virt-manager.et.redhat.com/), is the
primary motivation for integrating libvirt. virt-manager
will be integrated into and delivered by the JDS
consolidation.

libvirt has detailed knowledge on the hypervisors's
implementation. It's tightly coupled with the hypervisor
which is the reason why it is included in ON as part of
the xen-gate.

libvirt also includes virsh, an interactive shell based
application. virsh is built on top of libvirt and allows
a user to interact with the hypervisor and guest domains.


3.  Interface table

All interfaces in libvirt, including associated python files
are Uncommitted. Documentation on the interfaces can be found
in the case directory in libvirt.interfaces.

virsh's commands, options, and output are Uncommitted.  The
man page for virsh can also be located in the case directory.


4.  Deliverables & Licensing

libvirt.so along with the python wrappers are LGPL. The
virsh application includes a statically linked GNU readline
library, and is GPL due to that. If a dynamic version of
GNU readline is available in Solaris before integration,
virsh will link to that instead.

File                                                Location Commitment Level
----                                                ----
usr/bin/virsh (libexec)                             Committed
usr/bin/i86/virsh                                   Committed
usr/bin/amd64/virsh                                 Committed
usr/include/libvirt/libvirt.h                       Uncommitted
usr/include/libvirt/virterror.h                     Uncommitted
usr/lib/libvirt.so.0.2.0                            Uncommitted
usr/lib/libvirt.so.0                                Uncommitted
usr/lib/libvirt.so                                  Committed
usr/lib/amd64/libvirt.so.0.2.0                      Uncommitted
usr/lib/amd64/libvirt.so.0                          Uncommitted
usr/lib/amd64/libvirt.so                            Committed
usr/lib/python2.4/vendor-packages/libvirt.py        Uncommitted
usr/lib/python2.4/vendor-packages/libvirt.pyc       Uncommitted
usr/lib/python2.4/vendor-packages/libvirtmod.so     Uncommitted
usr/lib/python2.4/vendor-packages/64/libvirtmod.so  Uncommitted


5.  References

PSARC/2006/260  Solaris on Xen

6. Resources and Schedule
    6.4. Steering Committee requested information
   	6.4.1. Consolidation C-team Name:
		ON
    6.5. ARC review type: FastTrack