Blame README

Packit a07778
libvirt-glib
Packit a07778
============
Packit a07778
Packit a07778
libvirt is a C toolkit to interact with the virtualization capabilities
Packit a07778
of recent versions of Linux (and other OSes). It is free software
Packit a07778
available under the GNU Lesser General Public License. Virtualization on
Packit a07778
the Linux Operating System means the ability to run multiple instances of
Packit a07778
Operating Systems concurrently on a single hardware system where the basic
Packit a07778
resources are driven by a Linux instance. The library aim at providing
Packit a07778
long term stable C API initially for the Xen paravirtualization but
Packit a07778
should be able to integrate other virtualization mechanisms if needed.
Packit a07778
Packit a07778
libvirt-glib wraps libvirt to provide a high-level object-oriented API better
Packit a07778
suited for glib-based applications, via three libraries:
Packit a07778
Packit a07778
  - libvirt-glib - GLib main loop integration & misc helper APIs
Packit a07778
  - libvirt-gconfig - GObjects for manipulating libvirt XML documents
Packit a07778
  - libvirt-gobject - GObjects for managing libvirt objects
Packit a07778
Packit a07778
libvirt-glib is Free Software and licenced under LGPLv2+.
Packit a07778
Packit a07778
The latest official releases can be found at:
Packit a07778
Packit a07778
  ftp://libvirt.org/libvirt/glib/
Packit a07778
Packit a07778
NB: at this time, libvirt-glib is *NOT* considered API/ABI stable. Future
Packit a07778
releases may still include API/ABI incompatible changes.
Packit a07778
Packit a07778
Dependencies / supported platforms
Packit a07778
==================================
Packit a07778
Packit a07778
The libvirt-glib projects attempts to be moderately conservative
Packit a07778
about updating the minimum required versions of external package
Packit a07778
dependencies, to strike a balance between enabling use of new
Packit a07778
features while minimizing inconvenience for downstream developers
Packit a07778
on distro platforms with specific shipped versions.
Packit a07778
Packit a07778
There are roughly two classes of Linux distro - short lifetime
Packit a07778
(Fedora, Ubuntu non-LTS, etc) and extended lifetime (RHEL, CentOS,
Packit a07778
Debian, Ubuntu LTS). Based on this classification, the libvirt-glib
Packit a07778
project will generally aim to ensure build support for
Packit a07778
Packit a07778
 - Most recent 2 releases of short lifetime distros
Packit a07778
 - Most recent major release of extended lifetime distros,
Packit a07778
   with most recent 2 minor updates
Packit a07778
Packit a07778
The project will consider RHEL, Fedora, Debian, Ubuntu LTS, Ubuntu,
Packit a07778
OpenSUSE and SUSE (SLES/SLED) distros to be a representative subset
Packit a07778
of distros when determining min required versions of external deps
Packit a07778
that is reasonable to target. Other distros of similar release vintage
Packit a07778
will typically have similar versions to at least one of these distros.
Packit a07778
In the case of Debian, the project may at times choose to require use
Packit a07778
of an update from the backports repository.
Packit a07778
Packit a07778
At any time, it may be possible to build on versions of distros
Packit a07778
that are older than those implied by this policy, but the project
Packit a07778
will not guarantee this remains the case in future releases. The
Packit a07778
min required package versions of external dependencies may be
Packit a07778
raised in future releases based on this distro build target policy.
Packit a07778
Packit a07778
The packages required to build libvirt-glib are
Packit a07778
Packit a07778
 - glib-2.0
Packit a07778
 - gobject-2.0
Packit a07778
 - libxml-2.0
Packit a07778
 - libvirt
Packit a07778
Packit a07778
Functionality is optionally enhanced by the following packages:
Packit a07778
Packit a07778
 - gobject-introspection
Packit a07778
 - Vala (build-time only)
Packit a07778
Packit a07778
Patches submissions
Packit a07778
===================
Packit a07778
Packit a07778
Patch submissions are welcomed from any interested contributor. Please
Packit a07778
send them to the main libvir-list mailing list
Packit a07778
Packit a07778
    libvir-list@redhat.com
Packit a07778
Packit a07778
Questions about usage / deployment can be send to the end users mailing
Packit a07778
list
Packit a07778
Packit a07778
    libvirt-users@redhat.com
Packit a07778
Packit a07778
For further information about mailing lists & contacting the developers,
Packit a07778
please consult
Packit a07778
Packit a07778
    http://libvirt.org/contact.html
Packit a07778
Packit a07778
--End