1 # Copyright 2015 Intel Corporation.
3 # Licensed under the Apache License, Version 2.0 (the "License");
4 # you may not use this file except in compliance with the License.
5 # You may obtain a copy of the License at
7 # http://www.apache.org/licenses/LICENSE-2.0
9 # Unless required by applicable law or agreed to in writing, software
10 # distributed under the License is distributed on an "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 # See the License for the specific language governing permissions and
13 # limitations under the License.
15 """Automation of QEMU hypervisor with direct access to host NICs via
23 from conf import settings as S
24 from vnfs.qemu.qemu import IVnfQemu
25 from tools import tasks
26 from tools.module_manager import ModuleManager
28 _MODULE_MANAGER = ModuleManager()
30 class QemuPciPassthrough(IVnfQemu):
32 Control an instance of QEMU with direct access to the host network devices
36 Initialization function.
38 super(QemuPciPassthrough, self).__init__()
39 self._logger = logging.getLogger(__name__)
40 self._host_nics = S.getValue('NICS')
42 # in case of SRIOV and PCI passthrough we must ensure, that MAC addresses are swapped
43 if S.getValue('SRIOV_ENABLED') and not self._testpmd_fwd_mode.startswith('mac'):
44 self._logger.info("SRIOV detected, forwarding mode of testpmd was changed from '%s' to '%s'",
45 self._testpmd_fwd_mode, 'mac')
46 self._testpmd_fwd_mode = 'mac'
48 for nic in self._host_nics:
49 self._cmd += ['-device', 'vfio-pci,host=' + nic['pci']]
53 Start QEMU instance, bind host NICs to vfio-pci driver
56 _MODULE_MANAGER.insert_modules(['vfio-pci'])
58 # bind every interface to vfio-pci driver
60 nics_list = list(tmp_nic['pci'] for tmp_nic in self._host_nics)
61 tasks.run_task(['sudo', S.getValue('TOOLS')['bind-tool'], '--bind=vfio-pci'] + nics_list,
62 self._logger, 'Binding NICs %s...' % nics_list, True)
64 except subprocess.CalledProcessError:
65 self._logger.error('Unable to bind NICs %s', self._host_nics)
67 super(QemuPciPassthrough, self).start()
71 Stop QEMU instance, bind host NICs to the original driver
73 super(QemuPciPassthrough, self).stop()
75 # bind original driver to every interface
76 for nic in self._host_nics:
79 tasks.run_task(['sudo', S.getValue('TOOLS')['bind-tool'], '--bind=' + nic['driver'], nic['pci']],
80 self._logger, 'Binding NIC %s...' % nic['pci'], True)
82 except subprocess.CalledProcessError:
83 self._logger.error('Unable to bind NIC %s to driver %s', nic['pci'], nic['driver'])
85 # unload vfio-pci driver
86 _MODULE_MANAGER.remove_modules()