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
|
# Copyright (c) 2016 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.ssh import SSH, exec_cmd_no_error
class DpdkUtil(object):
"""Utilities for DPDK."""
#pylint: disable=too-many-locals
@staticmethod
def dpdk_testpmd_start(node, **args):
"""Start DPDK testpmd app on VM node.
:param node: VM Node to start testpmd on.
:param args: List of testpmd parameters.
:type node: dict
:type args: list
:return: nothing
"""
# Set the hexadecimal bitmask of the cores to run on.
eal_coremask = '-c {} '.format(args['eal_coremask'])\
if args.get('eal_coremask', '') else ''
# Set master core.
eal_master_core = '--master-lcore 0 '
# Set the number of memory channels to use.
eal_mem_channels = '-n {} '.format(args['eal_mem_channels'])\
if args.get('eal_mem_channels', '') else ''
# Set the memory to allocate on specific sockets (comma separated).
eal_socket_mem = '--socket-mem {} '.format(args['eal_socket_mem'])\
if args.get('eal_socket_mem', '') else ''
# Load an external driver. Multiple -d options are allowed.
eal_driver = '-d /usr/lib/librte_pmd_virtio.so '
# Set the forwarding mode: io, mac, mac_retry, mac_swap, flowgen,
# rxonly, txonly, csum, icmpecho, ieee1588
pmd_fwd_mode = '--forward-mode={} '.format(args['pmd_fwd_mode'])\
if args.get('pmd_fwd_mode', '') else ''
# Set the number of packets per burst to N.
pmd_burst = '--burst=64 '
# Set the number of descriptors in the TX rings to N.
pmd_txd = '--txd=256 '
# Set the number of descriptors in the RX rings to N.
pmd_rxd = '--rxd=256 '
# Set the number of queues in the TX to N.
pmd_txq = '--txq=1 '
# Set the number of queues in the RX to N.
pmd_rxq = '--rxq=1 '
# Set the hexadecimal bitmask of TX queue flags.
pmd_txqflags = '--txqflags=0xf00 '
# Set the number of mbufs to be allocated in the mbuf pools.
pmd_total_num_mbufs = '--total-num-mbufs={} '.format(\
args['pmd_num_mbufs']) if args.get('pmd_num_mbufs', '') else ''
# Set the hexadecimal bitmask of the ports for forwarding.
pmd_portmask = '--portmask={} '.format(args['pmd_portmask'])\
if args.get('pmd_portmask', '') else ''
# Disable hardware VLAN.
pmd_disable_hw_vlan = '--disable-hw-vlan '\
if args.get('pmd_disable_hw_vlan', '') else ''
# Disable RSS (Receive Side Scaling).
pmd_disable_rss = '--disable-rss '\
if args.get('pmd_disable_rss', '') else ''
# Set the MAC address XX:XX:XX:XX:XX:XX of the peer port N
pmd_eth_peer_0 = '--eth-peer={} '.format(args['pmd_eth_peer_0'])\
if args.get('pmd_eth_peer_0', '') else ''
pmd_eth_peer_1 = '--eth-peer={} '.format(args['pmd_eth_peer_1'])\
if args.get('pmd_eth_peer_1', '') else ''
# Set the number of forwarding cores based on coremask.
pmd_nb_cores = '--nb-cores={} '.format(\
bin(int(args['eal_coremask'], 0)).count('1')-1)\
if args.get('eal_coremask', '') else ''
eal_options = '-v '\
+ eal_coremask\
+ eal_master_core\
+ eal_mem_channels\
+ eal_socket_mem\
+ eal_driver
pmd_options = '-- '\
+ pmd_fwd_mode\
+ pmd_burst\
+ pmd_txd\
+ pmd_rxd\
+ pmd_txq\
+ pmd_rxq\
+ pmd_txqflags\
+ pmd_total_num_mbufs\
+ pmd_portmask\
+ pmd_disable_hw_vlan\
+ pmd_disable_rss\
+ pmd_eth_peer_0\
+ pmd_eth_peer_1\
+ pmd_nb_cores
ssh = SSH()
ssh.connect(node)
cmd = "/start-testpmd.sh {0} {1}".format(eal_options, pmd_options)
exec_cmd_no_error(node, cmd, sudo=True)
ssh.disconnect(node)
@staticmethod
def dpdk_testpmd_stop(node):
"""Stop DPDK testpmd app on node.
:param node: Node to stop testpmd on.
:type node: dict
:return: nothing
"""
ssh = SSH()
ssh.connect(node)
cmd = "/stop-testpmd.sh"
exec_cmd_no_error(node, cmd, sudo=True)
ssh.disconnect(node)
|