2006-02-28 12:17:00 +00:00
|
|
|
#
|
2009-09-16 13:03:53 +00:00
|
|
|
# Manually written part of python bindings for libvirt
|
2006-02-28 12:17:00 +00:00
|
|
|
#
|
2007-11-30 11:10:53 +00:00
|
|
|
|
|
|
|
# On cygwin, the DLL is called cygvirtmod.dll
|
|
|
|
try:
|
|
|
|
import libvirtmod
|
2009-05-19 13:03:03 +00:00
|
|
|
except ImportError, lib_e:
|
|
|
|
try:
|
|
|
|
import cygvirtmod as libvirtmod
|
|
|
|
except ImportError, cyg_e:
|
|
|
|
if str(cyg_e).count("No module named"):
|
|
|
|
raise lib_e
|
2007-11-30 11:10:53 +00:00
|
|
|
|
2006-02-28 12:17:00 +00:00
|
|
|
import types
|
|
|
|
|
2006-11-07 23:18:56 +00:00
|
|
|
# The root of all libvirt errors.
|
2006-02-28 12:17:00 +00:00
|
|
|
class libvirtError(Exception):
|
2008-08-22 10:50:18 +00:00
|
|
|
def __init__(self, defmsg, conn=None, dom=None, net=None, pool=None, vol=None):
|
2006-02-28 12:17:00 +00:00
|
|
|
|
2009-01-20 22:10:52 +00:00
|
|
|
# Never call virConnGetLastError().
|
|
|
|
# virGetLastError() is now thread local
|
|
|
|
err = virGetLastError()
|
2008-08-22 10:50:18 +00:00
|
|
|
if err is None:
|
|
|
|
msg = defmsg
|
2006-11-07 23:18:56 +00:00
|
|
|
else:
|
2008-08-22 10:50:18 +00:00
|
|
|
msg = err[2]
|
|
|
|
|
|
|
|
Exception.__init__(self, msg)
|
|
|
|
|
|
|
|
self.err = err
|
2006-11-07 23:18:56 +00:00
|
|
|
|
|
|
|
def get_error_code(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[0]
|
|
|
|
|
|
|
|
def get_error_domain(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[1]
|
|
|
|
|
|
|
|
def get_error_message(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[2]
|
|
|
|
|
|
|
|
def get_error_level(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[3]
|
|
|
|
|
|
|
|
def get_str1(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[4]
|
|
|
|
|
|
|
|
def get_str2(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[5]
|
|
|
|
|
|
|
|
def get_str3(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[6]
|
|
|
|
|
|
|
|
def get_int1(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[7]
|
|
|
|
|
|
|
|
def get_int2(self):
|
|
|
|
if self.err is None:
|
|
|
|
return None
|
|
|
|
return self.err[8]
|
|
|
|
|
2006-02-28 12:17:00 +00:00
|
|
|
#
|
|
|
|
# register the libvirt global error handler
|
|
|
|
#
|
|
|
|
def registerErrorHandler(f, ctx):
|
|
|
|
"""Register a Python written function to for error reporting.
|
|
|
|
The function is called back as f(ctx, error), with error
|
2008-03-14 11:08:03 +00:00
|
|
|
being a list of information about the error being raised.
|
2006-02-28 12:17:00 +00:00
|
|
|
Returns 1 in case of success."""
|
|
|
|
return libvirtmod.virRegisterErrorHandler(f,ctx)
|
|
|
|
|
2007-12-05 19:09:23 +00:00
|
|
|
def openAuth(uri, auth, flags):
|
|
|
|
ret = libvirtmod.virConnectOpenAuth(uri, auth, flags)
|
|
|
|
if ret is None:raise libvirtError('virConnectOpenAuth() failed')
|
|
|
|
return virConnect(_obj=ret)
|
|
|
|
|
|
|
|
|
2007-05-29 14:58:27 +00:00
|
|
|
#
|
|
|
|
# Return library version.
|
|
|
|
#
|
|
|
|
def getVersion (name = None):
|
|
|
|
"""If no name parameter is passed (or name is None) then the
|
|
|
|
version of the libvirt library is returned as an integer.
|
|
|
|
|
|
|
|
If a name is passed and it refers to a driver linked to the
|
|
|
|
libvirt library, then this returns a tuple of (library version,
|
|
|
|
driver version).
|
|
|
|
|
|
|
|
If the name passed refers to a non-existent driver, then you
|
|
|
|
will get the exception 'no support for hypervisor'.
|
|
|
|
|
|
|
|
Versions numbers are integers: 1000000*major + 1000*minor + release."""
|
|
|
|
if name is None:
|
|
|
|
ret = libvirtmod.virGetVersion ();
|
|
|
|
else:
|
|
|
|
ret = libvirtmod.virGetVersion (name);
|
|
|
|
if ret is None: raise libvirtError ("virGetVersion() failed")
|
|
|
|
return ret
|
|
|
|
|
|
|
|
|
2008-10-31 10:13:45 +00:00
|
|
|
#
|
|
|
|
# Invoke an EventHandle callback
|
|
|
|
#
|
2008-11-24 19:28:12 +00:00
|
|
|
def eventInvokeHandleCallback (watch, fd, event, callback, opaque):
|
2008-10-31 10:13:45 +00:00
|
|
|
"""
|
|
|
|
Invoke the Event Impl Handle Callback in C
|
|
|
|
"""
|
2008-11-24 19:28:12 +00:00
|
|
|
libvirtmod.virEventInvokeHandleCallback(watch, fd, event, callback, opaque);
|
2008-10-31 10:13:45 +00:00
|
|
|
|
|
|
|
#
|
|
|
|
# Invoke an EventTimeout callback
|
|
|
|
#
|
|
|
|
def eventInvokeTimeoutCallback (timer, callback, opaque):
|
|
|
|
"""
|
|
|
|
Invoke the Event Impl Timeout Callback in C
|
|
|
|
"""
|
|
|
|
libvirtmod.virEventInvokeTimeoutCallback(timer, callback, opaque);
|