Qubes/core-admin
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

dom0/qvm-usb: added description to usb_list() and usb_check_attached() methods

Browse Source
This commit is contained in:
Alexandre Bezroutchko 2012-10-10 16:54:23 +02:00
parent caf27cb936
commit 0ef88be16d
1 changed files with 20 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
dom0/qvm-core/qubesutils.py
View File

@ -407,6 +407,15 @@ def block_detach_all(vm, vm_xid = None):
####### USB devices ###### ####### USB devices ######
def usb_list(): def usb_list():
"""
Returns a dictionary of USB devices (for PVUSB backends running in all VM).
The dictionary is keyed by 'name' (see below), each element is a dictionary itself:
vm = name of the backend domain
xid = xid of the backend domain
device = <frontend device number>-<frontend port number>
name = <name of backend domain>:<frontend device number>-<frontend port number>
desc = description
"""
device_re = re.compile(r"^[0-9]+-[0-9]+$") device_re = re.compile(r"^[0-9]+-[0-9]+$")
# FIXME: any better idea of desc_re? # FIXME: any better idea of desc_re?
desc_re = re.compile(r"^.{1,255}$") desc_re = re.compile(r"^.{1,255}$")
@ -439,6 +448,17 @@ def usb_list():
return devices_list return devices_list
def usb_check_attached(backend_vm, device): def usb_check_attached(backend_vm, device):
"""
Checks if the given device in the given backend attached to any frontend.
Parameters:
backend_vm - xid of the backend domain
device - device name in the backend domain
Returns None or a dictionary:
vm - the name of the frontend domain
xid - xid of the frontend domain
frontend - frontend device number
devid - frontend port number
"""
# sample xs content: /local/domain/0/backend/vusb/4/0/port/1 = "7-5" # sample xs content: /local/domain/0/backend/vusb/4/0/port/1 = "7-5"
attached_dev = None attached_dev = None
xs_trans = xs.transaction_start() xs_trans = xs.transaction_start()