summaryrefslogtreecommitdiff
path: root/python/vyos/ethtool.py
blob: e8a339d2ffb73e5c804f56dac7727f2a9d7c3a0d (plain)
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
# Copyright 2021 VyOS maintainers and contributors <maintainers@vyos.io>
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library.  If not, see <http://www.gnu.org/licenses/>.

from vyos.util import cmd

class Ethtool:
    """
    Class is used to retrive and cache information about an ethernet adapter
    """

    # dictionary containing driver featurs, it will be populated on demand and
    # the content will look like:
    # {
    #   'tls-hw-tx-offload': {'fixed': True, 'on': False},
    #   'tx-checksum-fcoe-crc': {'fixed': True, 'on': False},
    #   'tx-checksum-ip-generic': {'fixed': False, 'on': True},
    #   'tx-checksum-ipv4': {'fixed': True, 'on': False},
    #   'tx-checksum-ipv6': {'fixed': True, 'on': False},
    #   'tx-checksum-sctp': {'fixed': True, 'on': False},
    #   'tx-checksumming': {'fixed': False, 'on': True},
    #   'tx-esp-segmentation': {'fixed': True, 'on': False},
    # }
    features = { }

    def __init__(self, ifname):
        # Now populate features dictionaty
        tmp = cmd(f'ethtool -k {ifname}')
        # skip the first line, it only says: "Features for eth0":
        for line in tmp.splitlines()[1:]:
            if ":" in line:
                key, value = [s.strip() for s in line.strip().split(":", 1)]
                fixed = "fixed" in value
                if fixed:
                    value = value.split()[0].strip()
                self.features[key.strip()] = {
                    "on": value == "on",
                    "fixed": fixed
                }

    def is_fixed_lro(self):
        # in case of a missing configuration, rather return "fixed". In Ethtool
        # terminology "fixed" means the setting can not be changed by the user.
        return self.features.get('large-receive-offload', True).get('fixed', True)

    def is_fixed_gro(self):
        # in case of a missing configuration, rather return "fixed". In Ethtool
        # terminology "fixed" means the setting can not be changed by the user.
        return self.features.get('generic-receive-offload', True).get('fixed', True)

    def is_fixed_gso(self):
        # in case of a missing configuration, rather return "fixed". In Ethtool
        # terminology "fixed" means the setting can not be changed by the user.
        return self.features.get('generic-segmentation-offload', True).get('fixed', True)

    def is_fixed_sg(self):
        # in case of a missing configuration, rather return "fixed". In Ethtool
        # terminology "fixed" means the setting can not be changed by the user.
        return self.features.get('scatter-gather', True).get('fixed', True)

    def is_fixed_tso(self):
        # in case of a missing configuration, rather return "fixed". In Ethtool
        # terminology "fixed" means the setting can not be changed by the user.
        return self.features.get('tcp-segmentation-offload', True).get('fixed', True)

    def is_fixed_ufo(self):
        # in case of a missing configuration, rather return "fixed". In Ethtool
        # terminology "fixed" means the setting can not be changed by the user.
        return self.features.get('udp-fragmentation-offload', True).get('fixed', True)