diff --git a/docs/bindings.html.in b/docs/bindings.html.in index 733c89bc20..46930cd6f6 100644 --- a/docs/bindings.html.in +++ b/docs/bindings.html.in @@ -2,7 +2,7 @@
-Libvirt supports C and C++ directly, and has bindings available @@ -74,6 +74,17 @@ +
+ Integration API modules: +
+ +For information on using libvirt on Windows please see the Windows support page. diff --git a/docs/dbus.html.in b/docs/dbus.html.in new file mode 100644 index 0000000000..6ff71d2770 --- /dev/null +++ b/docs/dbus.html.in @@ -0,0 +1,102 @@ + + + +
++ libvirt-dbus wraps libvirt API to provide a high-level object-oriented + API better suited for dbus-based applications. +
+ ++ The D-Bus bindings source code is maintained in a + git repository available on + libvirt.org: +
+ ++git clone https://libvirt.org/git/libvirt-dbus.git ++ +
+ They can also be browsed online: +
+ ++https://libvirt.org/git/?p=libvirt-dbus.git ++ +
+ libvirt-dbus exports libvirt API using D-Bus objects with methods and + properties described by interfaces. Currently only local connection + to libvirt is exported and the list of supported drivers depends + on the type of the bus connection (session or system). +
+ +
+ The name of the libvirt-dbus service is org.libvirt
.
+ libvirt-dbus distributes an interface XML descriptions which can be
+ usually found at /usr/share/dbus-1/interfaces/
.
+
+ By default unprivileged user has access only to the session D-Bus
+ connection. In order to allow specific user "foo" to access the system
+ D-Bus connection you need to create a file
+ /etc/dbus-1/system.d/org.libvirt.conf
that contains:
+
+<?xml version="1.0"?> +<!DOCTYPE busconfig PUBLIC "-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN" + "http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd"> + +<busconfig> + + <policy user="foo"> + <allow send_destination="org.libvirt"/> + </policy> + +</busconfig> ++ +
+ To get a list of supported drivers for the specific bus connection + you can run these commands (not all drivers may be available on + the host): +
+ ++gdbus introspect --xml --session --dest org.libvirt --object-path /org/libvirt +gdbus introspect --xml --system --dest org.libvirt --object-path /org/libvirt ++ +
+ Every object is introspectable so you can get a list of available + interfaces with methods, signals and properties running this command: +
+ ++gdbus introspect --xml --system --dest org.libvirt --object-path /org/libvirt/QEMU ++ +
+ To get a list of domains for specific connection driver you can run + this command: +
+ ++gdbus call --system --dest org.libvirt --object-path /org/libvirt/QEMU \ + --method org.libvirt.Connect.ListDomains 0 ++ + + diff --git a/docs/docs.html.in b/docs/docs.html.in index ee521c7460..40e0e3b82e 100644 --- a/docs/docs.html.in +++ b/docs/docs.html.in @@ -54,7 +54,7 @@