1 # Copyright 2016 Cisco Systems, Inc. All rights reserved.
3 # Licensed under the Apache License, Version 2.0 (the "License"); you may
4 # not use this file except in compliance with the License. You may obtain
5 # 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, WITHOUT
11 # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12 # License for the specific language governing permissions and limitations
18 from nfvbench.log import LOG
19 from . import traffic_utils
22 class Latency(object):
23 """A class to hold latency data."""
25 def __init__(self, latency_list=None):
26 """Create a latency instance.
28 latency_list: aggregate all latency values from list if not None
30 self.min_usec = sys.maxsize
35 for lat in latency_list:
37 self.min_usec = min(self.min_usec, lat.min_usec)
38 self.max_usec = max(self.max_usec, lat.max_usec)
39 self.avg_usec += lat.avg_usec
40 # round to nearest usec
41 self.avg_usec = int(round(float(self.avg_usec) / len(latency_list)))
44 """Return True if latency information is available."""
45 return self.min_usec != sys.maxsize
48 class TrafficGeneratorException(Exception):
49 """Exception for traffic generator."""
51 class AbstractTrafficGenerator(object):
53 def __init__(self, traffic_client):
54 self.traffic_client = traffic_client
55 self.generator_config = traffic_client.generator_config
56 self.config = traffic_client.config
59 def get_version(self):
60 # Must be implemented by sub classes
65 # Must be implemented by sub classes
69 def create_traffic(self, l2frame_size, rates, bidirectional, latency=True, e2e=False):
70 # Must be implemented by sub classes
73 def modify_rate(self, rate, reverse):
74 """Change the rate per port.
76 rate: new rate in % (0 to 100)
77 reverse: 0 for port 0, 1 for port 1
79 port_index = int(reverse)
80 port = self.port_handle[port_index]
81 self.rates[port_index] = traffic_utils.to_rate_str(rate)
82 LOG.info('Modified traffic stream for port %s, new rate=%s.', port, self.rates[port_index])
86 # Must be implemented by sub classes
90 def start_traffic(self):
91 # Must be implemented by sub classes
95 def stop_traffic(self):
96 # Must be implemented by sub classes
101 """Cleanup the traffic generator."""
104 def clear_streamblock(self):
105 """Clear all streams from the traffic generator."""
108 def resolve_arp(self):
109 """Resolve all configured remote IP addresses.
111 return: None if ARP failed to resolve for all IP addresses
112 else a dict of list of dest macs indexed by port#
113 the dest macs in the list are indexed by the chain id
118 """Return the local port MAC addresses.
120 return: a list of MAC addresses indexed by the port#
124 def get_port_speed_gbps(self):
125 """Return the local port speeds.
127 return: a list of speed in Gbps indexed by the port#