1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
# Copyright (c) 2019 Cisco and/or its affiliates.
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at:
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Dpdk Utilities Library."""
from resources.libraries.python.OptionString import OptionString
from resources.libraries.python.ssh import exec_cmd_no_error
class DpdkUtil(object):
"""Utilities for DPDK."""
@staticmethod
def get_eal_options(**kwargs):
"""Create EAL parameters options (including -v).
:param kwargs: Dict of testpmd parameters.
:type kwargs: dict
:returns: EAL parameters.
:rtype: OptionString
"""
options = OptionString(prefix='-')
options.add('v')
# Set the hexadecimal bitmask of the cores to run on.
options.add_with_value_from_dict('l', 'eal_corelist', kwargs)
# Set master core.
options.add_with_value('-master-lcore', '0')
# Load an external driver. Multiple -d options are allowed.
options.add_with_value_if_from_dict(
'd', '/usr/lib/librte_pmd_virtio.so', 'eal_driver', kwargs, True)
options.add_if_from_dict(
'-in-memory', 'eal_in_memory', kwargs, False)
return options
@staticmethod
def get_pmd_options(**kwargs):
"""Create PMD parameters options (without --).
:param kwargs: List of testpmd parameters.
:type kwargs: dict
:returns: PMD parameters.
:rtype: OptionString
"""
options = OptionString(prefix='--')
# Set the forwarding mode: io, mac, mac_retry, mac_swap, flowgen,
# rxonly, txonly, csum, icmpecho, ieee1588
options.add_equals_from_dict(
'forward-mode', 'pmd_fwd_mode', kwargs, 'io')
# Set the number of packets per burst to N.
options.add_equals('burst', 64)
# Set the number of descriptors in the TX rings to N.
options.add_equals_from_dict('txd', 'pmd_txd', kwargs, 1024)
# Set the number of descriptors in the RX rings to N.
options.add_equals_from_dict('rxd', 'pmd_rxd', kwargs, 1024)
# Set the number of queues in the TX to N.
options.add_equals_from_dict('txq', 'pmd_txq', kwargs, 1)
# Set the number of queues in the RX to N.
options.add_equals_from_dict('rxq', 'pmd_rxq', kwargs, 1)
# Set the hexadecimal bitmask of offloads.
options.add_equals_from_dict('tx-offloads', 'pmd_tx_offloads', kwargs)
# Set the number of mbufs to be allocated in the mbuf pools.
options.add_equals_from_dict('total-num-mbufs', 'pmd_num_mbufs', kwargs)
# Disable hardware VLAN.
options.add_if_from_dict(
'disable-hw-vlan', 'pmd_disable_hw_vlan', kwargs, True)
# Set the MAC address XX:XX:XX:XX:XX:XX of the peer port N
options.add_equals_from_dict('eth-peer', 'pmd_eth_peer_0', kwargs)
options.add_equals_from_dict('eth-peer', 'pmd_eth_peer_1', kwargs)
# Set the max packet length.
options.add_equals_from_dict('max-pkt-len', 'pmd_max_pkt_len', kwargs)
# Set the number of forwarding cores based on coremask.
options.add_equals_from_dict('nb-cores', 'pmd_nb_cores', kwargs)
return options
@staticmethod
def get_testpmd_cmdline(**kwargs):
"""Get DPDK testpmd command line arguments.
:param args: Key-value testpmd parameters.
:type args: dict
:returns: Command line string.
:rtype: OptionString
"""
options = OptionString()
options.add('testpmd')
options.extend(DpdkUtil.get_eal_options(**kwargs))
options.add('--')
options.extend(DpdkUtil.get_pmd_options(**kwargs))
return options
@staticmethod
def dpdk_testpmd_start(node, **kwargs):
"""Start DPDK testpmd app on VM node.
:param node: VM Node to start testpmd on.
:param args: Key-value testpmd parameters.
:type node: dict
:type kwargs: dict
"""
cmd_options = OptionString()
cmd_options.add("/start-testpmd.sh")
cmd_options.extend(DpdkUtil.get_eal_options(**kwargs))
cmd_options.add('--')
cmd_options.extend(DpdkUtil.get_pmd_options(**kwargs))
exec_cmd_no_error(node, cmd_options, sudo=True, disconnect=True)
@staticmethod
def dpdk_testpmd_stop(node):
"""Stop DPDK testpmd app on node.
:param node: Node to stop testpmd on.
:type node: dict
:returns: nothing
"""
cmd = "/stop-testpmd.sh" # Completed string, simpler than OptionString.
exec_cmd_no_error(node, cmd, sudo=True, disconnect=True)
|
