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.
20 from tools import tasks
22 class IVnf(tasks.Process):
32 Initialization method.
34 Purpose of this method is to initialize all
35 common Vnf data, no services should be started by
36 this call (use ``start`` method instead).
38 self._number = IVnf._number_vnfs
39 IVnf._number_vnfs = IVnf._number_vnfs + 1
40 self._log_prefix = 'vnf_%d_cmd : ' % self._number
46 This is a blocking function
48 super(IVnf, self).start()
54 self._logger.info('Killing VNF...')
56 # force termination of VNF and wait for it to terminate; It will avoid
57 # sporadic reboot of host. (caused by hugepages or DPDK ports)
58 super(IVnf, self).kill(signal='-9', sleep=10)
60 def execute(self, cmd, delay=0):
62 execute ``cmd`` with given ``delay``.
64 This method makes asynchronous call to guest system
65 and waits given ``delay`` before returning. Can be
66 used with ``wait`` method to create synchronous call.
68 :param cmd: Command to execute on guest system.
69 :param delay: Delay (in seconds) to wait after sending
70 command before returning. Please note that
71 this value can be floating point which
72 allows to pass milliseconds.
76 self._logger.debug('%s%s', self._log_prefix, cmd)
77 self._child.sendline(cmd)
80 def wait(self, prompt='', timeout=30):
82 wait for ``prompt`` on guest system for given ``timeout``.
84 This method ends based on two conditions:
85 * ``prompt`` has been detected
86 * ``timeout`` has been reached.
88 :param prompt: method end condition. If ``prompt``
89 won't be detected during given timeout,
90 method will return False.
91 :param timeout: Time to wait for prompt (in seconds).
92 Please note that this value can be floating
93 point which allows to pass milliseconds.
95 :returns: True if result_cmd has been detected before
96 timeout has been reached, False otherwise.
98 self._child.expect(prompt, timeout=timeout)
100 def execute_and_wait(self, cmd, timeout=30, prompt=''):
102 execute ``cmd`` with given ``timeout``.
104 This method makes synchronous call to guest system
105 and waits till ``cmd`` execution is finished
106 (based on ``prompt value) or ''timeout'' has
109 :param cmd: Command to execute on guest system.
110 :param timeout: Timeout till the end of execution is not
112 :param prompt: method end condition. If ``prompt``
113 won't be detected during given timeout,
114 method will return False. If no argument
115 or None value will be passed, default
116 ``prompt`` passed in __init__
119 :returns: True if end of execution has been detected
120 before timeout has been reached, False otherwise.
123 self.wait(prompt=prompt, timeout=timeout)