libvirt

mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-07-06 09:55:46 +00:00

Libvirt provides a portable, long term stable C API for managing the virtualization technologies provided by many operating systems. It includes support for QEMU, KVM, Xen, LXC, bhyve, Virtuozzo, VMware vCenter and ESX, VMware Desktop, Hyper-V, VirtualBox and the POWER Hypervisor.

Go to file

Ian Jackson 8915c9cb1f autogen.sh: Restore --no-git (avoid git submodule update) Prior to `2621d48f00` "gnulib: delete all gnulib integration", one could pass ./autogen.sh --no-git to prevent the libvirt build system from running git submodule update. This feature is needed by systems like the Xen Project CI which want to explicitly control the revisions of every tree. These will typically arrange to initialise the submodules check out the right version of everything, and then expect the build system not to mess with it any more. Despite to the old documentation comments referring only to gnulib, the --no-git feature is required not only because of gnulib but also because of the other submodule, src/keycodemapdb. (And in any case, even if it were no longer required because all the submodules were removed, it ought ideally to have been retained as a no-op for compaibility reasons.) So restore the --no-git feature. Because of the way the argument parsing of autogen.sh works, it is easiest to recognise this option only if it comes first. This works for the Xen Project CI, which has always passed this option first. If something else is using this option (and hasn't introduced a different workaround in the meantime), not in the first position, then perhaps a more sophisticated approach will be needed. But I think this will do for now. Signed-off-by: Ian Jackson <ian.jackson@eu.citrix.com> Reviewed-by: Pavel Hrdina <phrdina@redhat.com>		2020-06-03 16:19:13 +02:00
.ctags.d	maint: Add support for .ctags.d	2019-05-31 17:54:28 +02:00
.github	github: skip lockdown of old issues/prs	2020-04-07 17:50:54 +01:00
build-aux	qemumonitortestutils: Make test monitor failures more prominent	2020-04-27 08:13:48 +02:00
ci	ci: Drop handling of $PKG_CONFIG_LIBDIR	2020-03-04 11:24:10 +01:00
docs	news: Point to GitLab for full git log	2020-06-03 15:02:40 +02:00
examples	qemu: support Panic Crashloaded event handling	2020-02-07 14:05:25 +00:00
include/libvirt	API: Add VIR_DOMAIN_JOB_ERRMSG domain job statistics field	2020-04-24 08:56:57 +02:00
m4	qemu-conf: add configurable dbus-daemon location	2020-03-24 15:57:33 +01:00
po	vbox: remove unused support for Windows MSCOM	2020-04-20 11:34:59 +01:00
scripts	scripts: Fix E741 that pycodesyle is pointing out during syntax-check	2020-05-26 08:51:15 +02:00
src	src: make virObject inherit from GObject	2020-06-03 10:20:17 +01:00
tests	downscript: add support for booting and hotplug interface	2020-05-26 15:56:11 +02:00
tools	tools: libvirt-guests: correctly check shutdown value	2020-06-03 13:56:20 +02:00
.color_coded.in	gnulib: delete all gnulib integration	2020-02-07 15:03:54 +00:00
.ctags	ctags: Generate tags for headers, i.e. function prototypes	2018-09-18 14:21:33 +02:00
.dir-locals.el	build: avoid tabs that failed syntax-check	2012-09-06 09:43:46 -06:00
.editorconfig	Add .editorconfig	2019-09-06 12:47:46 +02:00
.gitignore	gnulib: delete all gnulib integration	2020-02-07 15:03:54 +00:00
.gitlab-ci.yml	gitlab: move some jobs onto CentOS 8	2020-05-06 13:16:58 +01:00
.gitmodules	gnulib: delete all gnulib integration	2020-02-07 15:03:54 +00:00
.gitpublish	gitpublish: add a subject prefix	2020-01-16 13:04:11 +00:00
.mailmap	mailmap: Remove some duplicates	2019-06-07 13:18:08 +02:00
.travis.yml	travis: explicitly include gnutls to ensure it is updated	2020-04-24 15:00:58 +01:00
.ycm_extra_conf.py.in	gnulib: delete all gnulib integration	2020-02-07 15:03:54 +00:00
ABOUT-NLS	Convert all remaining Markdown files to reStructuredText	2020-04-14 16:29:04 +02:00
AUTHORS.in	AUTHORS: Add Fabiano Fidêncio	2019-12-19 16:42:06 +01:00
autogen.sh	autogen.sh: Restore --no-git (avoid git submodule update)	2020-06-03 16:19:13 +02:00
ChangeLog	docs: point to GitLab as the primary git hosting	2020-06-03 13:38:33 +02:00
config-post.h	gnulib: delete all gnulib integration	2020-02-07 15:03:54 +00:00
configure.ac	maint: Post-release version bump to 6.5.0	2020-06-02 11:20:16 +02:00
CONTRIBUTING.rst	CONTRIBUTING: Include note about build system tools	2020-05-04 19:03:51 +02:00
COPYING	maint: follow recommended practice for using LGPL	2013-05-20 14:15:21 -06:00
COPYING.LESSER	maint: Remove control characters from LGPL license file	2015-09-25 09:16:24 +02:00
gitdm.config	gitdm: add 'ibm' file	2019-10-18 17:32:52 +02:00
GNUmakefile	build: merge all syntax-check logic into one file	2019-10-09 13:36:54 +01:00
libvirt-admin.pc.in	Add libvirt-admin library	2015-06-16 13:46:20 +02:00
libvirt-lxc.pc.in	Add pkg-config files for libvirt-qemu & libvirt-lxc	2014-06-23 16:17:27 +01:00
libvirt-qemu.pc.in	Add pkg-config files for libvirt-qemu & libvirt-lxc	2014-06-23 16:17:27 +01:00
libvirt.pc.in	Add pkg-config files for libvirt-qemu & libvirt-lxc	2014-06-23 16:17:27 +01:00
libvirt.spec.in	Convert all remaining Markdown files to reStructuredText	2020-04-14 16:29:04 +02:00
Makefile.am	CONTRIBUTING: Include in release archives	2020-04-20 18:01:55 +02:00
Makefile.nonreentrant	Remove backslash alignment attempts	2017-11-03 13:24:12 +01:00
mingw-libvirt.spec.in	Remove phyp driver	2019-12-20 12:25:42 -05:00
README	Convert all remaining Markdown files to reStructuredText	2020-04-14 16:29:04 +02:00
README.rst	README.rst: Replace the installation instructions with link to compiling.html.	2020-05-19 11:48:42 +02:00
run.in	run.in: Include tools directory on $PATH.	2020-01-21 13:04:57 +01:00

README

.. image:: https://gitlab.com/libvirt/libvirt/badges/master/pipeline.svg
     :target: https://gitlab.com/libvirt/libvirt/pipelines
     :alt: GitLab CI Build Status
.. image:: https://travis-ci.org/libvirt/libvirt.svg
     :target: https://travis-ci.org/libvirt/libvirt
     :alt: Travis CI Build Status
.. image:: https://bestpractices.coreinfrastructure.org/projects/355/badge
     :target: https://bestpractices.coreinfrastructure.org/projects/355
     :alt: CII Best Practices

==============================
Libvirt API for virtualization
==============================

Libvirt provides a portable, long term stable C API for managing the
virtualization technologies provided by many operating systems. It
includes support for QEMU, KVM, Xen, LXC, bhyve, Virtuozzo, VMware
vCenter and ESX, VMware Desktop, Hyper-V, VirtualBox and the POWER
Hypervisor.

For some of these hypervisors, it provides a stateful management
daemon which runs on the virtualization host allowing access to the
API both by non-privileged local users and remote users.

Layered packages provide bindings of the libvirt C API into other
languages including Python, Perl, PHP, Go, Java, OCaml, as well as
mappings into object systems such as GObject, CIM and SNMP.

Further information about the libvirt project can be found on the
website:

https://libvirt.org


License
=======

The libvirt C API is distributed under the terms of GNU Lesser General
Public License, version 2.1 (or later). Some parts of the code that are
not part of the C library may have the more restrictive GNU General
Public License, version 2.0 (or later). See the files ``COPYING.LESSER``
and ``COPYING`` for full license terms & conditions.


Installation
============

Instructions on building and installing libvirt can be found on the website:

https://libvirt.org/compiling.html

Contributing
============

The libvirt project welcomes contributions in many ways. For most components
the best way to contribute is to send patches to the primary development
mailing list. Further guidance on this can be found on the website:

https://libvirt.org/contribute.html


Contact
=======

The libvirt project has two primary mailing lists:

* libvirt-users@redhat.com (**for user discussions**)
* libvir-list@redhat.com (**for development only**)

Further details on contacting the project are available on the website:

https://libvirt.org/contact.html