shaba/virt-manager
1
0
Fork 0
mirror of https://github.com/virt-manager/virt-manager.git synced 2025-01-03 01:18:00 +03:00
Code Issues Projects Releases Wiki Activity

Remove the docs/ dir

Browse Source 
Release process doesn't need to be documented in the repo

Dbus interface is basically unused, I've got no problem with having people
look at the code to figure it out if they care that much.
This commit is contained in:
Cole Robinson 2012-10-18 15:32:27 -04:00
parent 53b12d82c5
commit 14485f2a08
2 changed files with 0 additions and 118 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/RELEASE-PROCESS.txt
View File

@ -1,28 +0,0 @@
Procedure for doing new releases
=================================
Before release:
verify virt-manager runs fine on RHEL5 (older gtk)
Make sure distcheck passes, 'make rpm' works fine
All virtinst/virt-manager tests and pylint checks
Preparing the source tree:
1. Sync up latest translations - see po/README.txt
2. Change release number in configure.ac
3. Update virtinst version requirement in configure.ac
4. Update NEWS file (and spec with release info)
5. Sync translations from transifex (see po/README.txt)
6. Update virt-manager.spec.in changelog & reset Release to '1'
7. Checkin changes
8. Run 'git tag RELEASE-X.Y.Z-1'
Preparing the build:
1. Get a fresh checkout from git://git.fedorahosted.org/git/virt-manager.git
2. Run 'autobuild.sh'
3. Upload build/virt-manager-X.Y.Z.tar.gz to website download area
4. Update the website download.html page
5. Mail fedora-virt, libvirt-list, virt-tools-list mailing lists
6. Update freshmeat record
7. Mail lwn@lwn.net release announcement

90
docs/dbus-remote-control.txt
View File

@ -1,90 +0,0 @@
DBus Remote Control
===================
The GNOME virt manager provides the ability to control its high level
UI actions via a DBus service.
Interface description
---------------------
The service is intended to run on the session bus, and when launched
will register a well known bus name of 'com.redhat.virt.manager'.
Within this service, a single object is to be exported under the
path of '/com/redhat/virt/manager'.
This object implements a single interface 'com.redhat.virt.manager'
which contains the following methods:
- show_domain_performance(string:uri, string:uuid)
Takes a domain's UUID in printable string format and displays
the window showing detailed performance data
- show_domain_editor(string:uri, string:uuid)
Takes a domain's UUID in printable string format and displays
the window for configuring the VM hardware resources
- show_domain_console(string:uri, string:uuid)
Takes a domain's UUID in printable string format and displays
the window for accessing the graphical framebuffer associated
with the VM.
- show_domain_serial_console(string:uri, string:uuid)
Takes a domain's UUID in printable string format and displays
the window for accessing the serial console connected to the
guest VM. NB, not all domains have a serial console activated,
and it is only typically accessible as root.
- show_domain_creator(string:uri)
Displays the window for creating & configuring a new domain.
NB. the domain creator is only accessible as root.
- show_host_summary(string:uri)
Displays the window showing a summary of all active domains
on the host
- show_connect()
Displays the dialog for connecting to a hypervisor
In all these methods the 'uri' parameter is the libvirt URI for the
hypervisor, typically either 'qemu:///system', or 'xen:///'
Example usage from shell
------------------------
To display the performance window for the domain with a UUID of
'349025e8-ad34-34ff-239a-12ae095249f3', one would use the dbus-send
command as follows:
# First ensure the application is running
$ dbus-send --print-reply --session --dest="org.freedesktop.DBus" \
"/org/freedesktop/DBus" \
"org.freedesktop.DBus.StartServiceByName" \
"string:com.redhat.virt.manager"
# Now call the show_domain_performance method
$dbus-send --print-reply --session --dest="com.redhat.virt.manager" \
"/com/redhat/virt/manager"
"com.redhat.virt.manager.show_domain_performance" \
"string:qemu:///system" \
"string:349025e8-ad34-34ff-239a-12ae095249f3"
Example usage from python
-------------------------
import dbus
bus = dbus.SessionBus()
bus_object = bus.get_object("org.freedesktop.DBus", "/org/freedesktop/DBus")
bus_iface = dbus.Interface(bus_object, "org.freedesktop.DBus")
bus_iface.StartServiceByName("com.redhat.virt.manager")
virt_object = bus.get_object("com.redhat.virt.manager",
"/com/redhat/virt/manager")
virt_iface = dbus.Interface(virt_object, "com.redhat.virt.manager")
virt_iface.show_domain_performance("qemu:///system",
"349025e8-ad34-34ff-239a-12ae095249f3")