mirror of https://gitlab.com/libvirt/libvirt.git synced 2024-07-03 16:42:37 +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

Laine Stump 35eb484f8c tests: remove firewalld backend tests from virfirewalltest.c When libvirt added support for firewalld, all iptables/ebtables rules were added via the firewalld "passthrough" API when firewalld was enabled (the "firewalld backend"), or run directly by libvirt when firewalld was disabled (the so-called "direct backend"). virfirewalltest.c dutifully ran each test twice, once with the each backend enabled. But commit `b19863640d` changed the code to always directly run iptables/ebtables commands, and never use the firewalld passthrough API, effectively making the direct and firewalld backends identical, except that when libvirt receives notice that firewalld has restarted or reloaded its rules, the firewalld backend sends an extra "iptables -V" command via firewalld's passthrough API (and waits for a response) prior to running all the rest of the iptables commands directly; this assures that a newly-restarted firewalld has finished its work on the filter tables before libvirt starts messing with it. (Because this code is only executed in response to an event from dbus, it isn't tested in the unit tests). In spite of this, we still go through all the virfirewall tests twice though - once for the direct backend, and once for the firewalld backend, even though these take the same codepath. In commit `b19863640d` I had left this double-testing in thinking that someday we might go back to actually doing something useful with the firewalld backend in the course of adding support for native nftables, but I've now realized that for the case of nftables we will be even more divorced from firewalld, so there is really no point in keeping this code around any longer. (It's likely/probable that the tests will be done twice again in the future, but it will be enough different that it is better to remove this code and re-implement from scratch when adding the nftables backend, rather than trying to directly modify the existing code and end up with something even more confusing). This patch eliminates all the test duplication in virfirewalltest.c, including mocking dbus, which is unnecessary since none of the tests use dbus (for now we ensure that by explicitly setting the virfirewall backend to DIRECT before any of the tests have run. Eventually the concept of a "firewalld backend" will disappear completely, but that's for another patch.) Signed-off-by: Laine Stump <laine@redhat.com> Reviewed-by: Michal Privoznik <mprivozn@redhat.com>		2021-12-13 13:37:31 -05:00
.ctags.d	maint: Add support for .ctags.d	2019-05-31 17:54:28 +02:00
.github/workflows	Switch to new GitHub repo-lockdown configuration	2021-10-20 14:27:20 +01:00
.gitlab/issue_templates	gitlab: Add disclaimer to the 'feature' issue template	2021-07-30 15:26:45 +02:00
build-aux	syntax-check: Fix regex for sc_require_attribute_cleanup_initialization	2021-11-05 15:00:53 +01:00
ci	ci: run a mingw64 job on stable Fedora	2021-11-23 16:44:18 +00:00
docs	qemu: Validate TCG feature is enabled only for TCG domains	2021-12-13 17:07:39 +01:00
examples	lib: Drop needless one line labels	2021-11-22 12:39:59 +01:00
include	virDomainMigrate: Introduce VIR_MIGRATE_NON_SHARED_SYNCHRONOUS_WRITES flag	2021-12-07 09:00:39 +01:00
po	Translated using Weblate (Ukrainian)	2021-11-27 16:16:17 +01:00
scripts	scripts: Properly declare g_auto() stub for cocci	2021-11-03 14:46:54 +01:00
src	util: rename iptables operators to something less generic	2021-12-13 13:37:31 -05:00
tests	tests: remove firewalld backend tests from virfirewalltest.c	2021-12-13 13:37:31 -05:00
tools	nss: Use shared_library() for nss_libvirt_lib	2021-12-13 14:17:56 +01: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	gitignore: Ignore __pycache__ directory	2021-03-22 12:05:11 +01:00
.gitlab-ci.yml	ci: display installed packages at start of build	2021-11-24 11:17:10 +00: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: consolidate my email addresses	2020-10-06 12:05:09 +02:00
.ycm_extra_conf.py.in	gnulib: delete all gnulib integration	2020-02-07 15:03:54 +00:00
AUTHORS.rst.in	AUTHORS: Add myself to the list of commiters	2021-07-14 14:51:19 +02:00
config.h	meson: Declare GLIB_VERSION_* macros at configure	2021-05-03 12:08:26 +02:00
configmake.h.in	meson: generate configmake.h	2020-08-03 09:26:48 +02:00
CONTRIBUTING.rst	meson: adjust our documentation to mention meson instead of autoconf	2020-08-03 09:27:09 +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
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	Revert "virt-ssh-helper: Add manual page"	2021-12-10 23:08:31 +01:00
meson_options.txt	meson: Introduce qemu_datadir option	2021-11-18 15:48:59 +01:00
meson.build	meson: Improve network driver enablement logic	2021-12-06 11:13:51 +01:00
mingw-libvirt.spec.in	rpm: fix mingw obsoletes lines	2021-08-02 13:47:20 +01:00
NEWS.rst	NEWS: Document TCG features	2021-12-13 17:10:23 +01:00
README.rst	README: drop Travis CI badge	2020-08-03 15:08:28 +02:00
run.in	run: detect daemons when run via wrapper commands	2021-12-01 12:14:03 +00:00

README.rst

Libvirt API for virtualization

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