# under the License.
import abc
+import sys
-class TrafficGeneratorException(Exception):
- pass
+from nfvbench.log import LOG
+from . import traffic_utils
-class AbstractTrafficGenerator(object):
+class Latency(object):
+ """A class to hold latency data."""
- # src_mac (6) + dst_mac (6) + mac_type (2) + frame_check (4) = 18
- l2_header_size = 18
+ def __init__(self, latency_list=None):
+ """Create a latency instance.
- imix_l2_sizes = [64, 594, 1518]
- imix_l3_sizes = [size - l2_header_size for size in imix_l2_sizes]
- imix_ratios = [7, 4, 1]
- imix_avg_l2_size = sum(map(
- lambda imix: 1.0 * imix[0] * imix[1],
- zip(imix_l2_sizes, imix_ratios))) / sum(imix_ratios)
+ latency_list: aggregate all latency values from list if not None
+ """
+ self.min_usec = sys.maxsize
+ self.max_usec = 0
+ self.avg_usec = 0
+ self.hdrh = None
+ if latency_list:
+ for lat in latency_list:
+ if lat.available():
+ self.min_usec = min(self.min_usec, lat.min_usec)
+ self.max_usec = max(self.max_usec, lat.max_usec)
+ self.avg_usec += lat.avg_usec
+ # round to nearest usec
+ self.avg_usec = int(round(float(self.avg_usec) / len(latency_list)))
- def __init__(self, config):
- self.config = config
+ def available(self):
+ """Return True if latency information is available."""
+ return self.min_usec != sys.maxsize
- @abc.abstractmethod
- def get_version():
- # Must be implemented by sub classes
- return None
+
+class TrafficGeneratorException(Exception):
+ """Exception for traffic generator."""
+
+class AbstractTrafficGenerator(object):
+
+ def __init__(self, traffic_client):
+ self.traffic_client = traffic_client
+ self.generator_config = traffic_client.generator_config
+ self.config = traffic_client.config
@abc.abstractmethod
- def init():
+ def get_version(self):
# Must be implemented by sub classes
return None
@abc.abstractmethod
- def connect():
+ def connect(self):
# Must be implemented by sub classes
return None
@abc.abstractmethod
- def config_interface():
+ def create_traffic(self, l2frame_size, rates, bidirectional, latency=True, e2e=False):
# Must be implemented by sub classes
return None
+ def modify_rate(self, rate, reverse):
+ """Change the rate per port.
+
+ rate: new rate in % (0 to 100)
+ reverse: 0 for port 0, 1 for port 1
+ """
+ port_index = int(reverse)
+ port = self.port_handle[port_index]
+ self.rates[port_index] = traffic_utils.to_rate_str(rate)
+ LOG.info('Modified traffic stream for port %s, new rate=%s.', port, self.rates[port_index])
+
@abc.abstractmethod
- def create_traffic():
+ def get_stats(self):
# Must be implemented by sub classes
return None
@abc.abstractmethod
- def modify_traffic():
+ def start_traffic(self):
# Must be implemented by sub classes
return None
@abc.abstractmethod
- def get_stats():
+ def stop_traffic(self):
# Must be implemented by sub classes
return None
@abc.abstractmethod
- def clear_traffic():
- # Must be implemented by sub classes
+ def cleanup(self):
+ """Cleanup the traffic generator."""
return None
+ def clear_streamblock(self):
+ """Clear all streams from the traffic generator."""
+
@abc.abstractmethod
- def start_traffic():
- # Must be implemented by sub classes
- return None
+ def resolve_arp(self):
+ """Resolve all configured remote IP addresses.
+
+ return: None if ARP failed to resolve for all IP addresses
+ else a dict of list of dest macs indexed by port#
+ the dest macs in the list are indexed by the chain id
+ """
@abc.abstractmethod
- def stop_traffic():
- # Must be implemented by sub classes
- return None
+ def get_macs(self):
+ """Return the local port MAC addresses.
+
+ return: a list of MAC addresses indexed by the port#
+ """
@abc.abstractmethod
- def cleanup():
- # Must be implemented by sub classes
- return None
+ def get_port_speed_gbps(self):
+ """Return the local port speeds.
+
+ return: a list of speed in Gbps indexed by the port#
+ """