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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
"""Defines physical port classes and related items."""
# System imports
from enum import IntEnum
# Local source tree imports
from pyof.foundation.base import GenericBitMask, GenericStruct
from pyof.foundation.basic_types import (
Char, FixedTypeList, HWAddress, Pad, UBInt32)
from pyof.foundation.constants import OFP_MAX_PORT_NAME_LEN
# Third-party imports
__all__ = ('ListOfPorts', 'Port', 'PortNo', 'PortConfig', 'PortFeatures',
'PortState')
class PortNo(IntEnum):
"""Port numbering.
Ports are numbered starting from 1.
"""
#: Maximum number of physical and logical switch ports.
OFPP_MAX = 0xffffff00
# Reserved OpenFlow port (fake output "ports")
#: Send the packet out the input port. This reserved port must be
#: explicitly used in order to send back out of the input port.
OFPP_IN_PORT = 0xfffffff8
#: Submit the packet to the first flow table
#: NB: This destination port can only be used in packet-out messages.
OFPP_TABLE = 0xfffffff9
#: Process with normal L2/L3 switching.
OFPP_NORMAL = 0xfffffffa
#: All physical ports in VLAN, except input port and thos blocked or link
#: down.
OFPP_FLOOD = 0xfffffffb
#: All physical ports except input port
OFPP_ALL = 0xfffffffc
#: Send to controller
OFPP_CONTROLLER = 0xfffffffd
#: Local openflow "port"
OFPP_LOCAL = 0xfffffffe
#: Wildcard port used only for flow mod (delete) and flow stats requests.
#: Selects all flows regardless of output port (including flows with no
#: output port).
OFPP_ANY = 0xffffffff
class PortConfig(GenericBitMask):
"""Flags to indicate behavior of the physical port.
These flags are used in :class:`Port` to describe the current
configuration. They are used in the
:class:`~pyof.v0x04.controller2switch.port_mod.PortMod`
message to configure the port's behavior.
The :attr:`OFPPC_PORT_DOWN` bit indicates that the port has been
administratively brought down and should not be used by OpenFlow. The
:attr:`~OFPPC_NO_RECV` bit indicates that packets received on that port
should be ignored. The :attr:`OFPPC_NO_FWD` bit indicates that OpenFlow
should not send packets to that port. The :attr:`OFPPC_NO_PACKET_IN` bit
indicates that packets on that port that generate a table miss should never
trigger a packet-in message to the controller.
In general, the port config bits are set by the controller and not changed
by the switch. Those bits may be useful for the controller to implement
protocols such as STP or BFD. If the port config bits are changed by the
switch through another administrative interface, the switch sends an
:attr:`OFPT_PORT_STATUS` message to notify the controller of the change.
"""
#: Port is administratively down.
OFPPC_PORT_DOWN = 1 << 0
#: Drop all packets received by port.
OFPPC_NO_RECV = 1 << 2
#: Drop packets forwarded to port.
OFPPC_NO_FWD = 1 << 5
#: Do not send packet-in msgs for port.
OFPPC_NO_PACKET_IN = 1 << 6
class PortFeatures(GenericBitMask):
"""Physical ports features.
The curr, advertised, supported, and peer fields indicate link modes
(speed and duplexity), link type (copper/fiber) and link features
(autonegotiation and pause).
Multiple of these flags may be set simultaneously. If none of the port
speed flags are set, the max_speed or curr_speed are used.
The curr_speed and max_speed fields indicate the current and maximum bit
rate (raw transmission speed) of the link in kbps. The number should be
rounded to match common usage. For example, an optical 10 Gb Ethernet port
should have this field set to 10000000 (instead of 10312500), and an OC-192
port should have this field set to 10000000 (instead of 9953280).
The max_speed fields indicate the maximum configured capacity of the link,
whereas the curr_speed indicates the current capacity. If the port is a LAG
with 3 links of 1Gb/s capacity, with one of the ports of the LAG being
down, one port auto-negotiated at 1Gb/s and 1 port auto-negotiated at
100Mb/s, the max_speed is 3 Gb/s and the curr_speed is 1.1 Gb/s.
"""
#: 10 Mb half-duplex rate support.
OFPPF_10MB_HD = 1 << 0
#: 10 Mb full-duplex rate support.
OFPPF_10MB_FD = 1 << 1
#: 100 Mb half-duplex rate support.
OFPPF_100MB_HD = 1 << 2
#: 100 Mb full-duplex rate support.
OFPPF_100MB_FD = 1 << 3
#: 1 Gb half-duplex rate support.
OFPPF_1GB_HD = 1 << 4
#: 1 Gb full-duplex rate support.
OFPPF_1GB_FD = 1 << 5
#: 10 Gb full-duplex rate support.
OFPPF_10GB_FD = 1 << 6
#: 40 Gb full-duplex rate support.
OFPPF_40GB_FD = 1 << 7
#: 100 Gb full-duplex rate support.
OFPPF_100GB_FD = 1 << 8
#: 1 Tb full-duplex rate support.
OFPPF_1TB_FD = 1 << 9
#: Other rate, not in the list
OFPPF_OTHER = 1 << 10
#: Copper medium.
OFPPF_COPPER = 1 << 11
#: Fiber medium.
OFPPF_FIBER = 1 << 12
#: Auto-negotiation.
OFPPF_AUTONEG = 1 << 13
#: Pause.
OFPPF_PAUSE = 1 << 14
#: Asymmetric pause.
OFPPF_PAUSE_ASYM = 1 << 15
class PortState(GenericBitMask):
"""Current state of the physical port.
These are not configurable from the controller.
The port state bits represent the state of the physical link or switch
protocols outside of OpenFlow. The :attr:`~PortConfig.OFPPS_LINK_DOWN` bit
indicates the the physical link is not present. The
:attr:`~PortConfig.OFPPS_BLOCKED` bit indicates that a switch protocol
outside of OpenFlow, such as 802.1D Spanning Tree, is preventing the use of
that port with :attr:`~PortConfig.OFPP_FLOOD`.
All port state bits are read-only and cannot be changed by the controller.
When the port flags are changed, the switch sends an
:attr:`v0x04.common.header.Type.OFPT_PORT_STATUS` message to notify the
controller of the change.
"""
#: Not physical link present.
OFPPS_LINK_DOWN = 1 << 0
#: Port is blocked.
OFPPS_BLOCKED = 1 << 1
#: Live for Fast Failover Group.
OFPPS_LIVE = 1 << 2
# Classes
class Port(GenericStruct):
"""Description of a port.
The port_no field uniquely identifies a port within a switch. The hw_addr
field typically is the MAC address for the port;
:data:`.OFP_MAX_ETH_ALEN` is 6. The name field is a null-terminated string
containing a human-readable name for the interface.
The value of :data:`.OFP_MAX_PORT_NAME_LEN` is 16.
:attr:`curr`, :attr:`advertised`, :attr:`supported` and :attr:`peer` fields
indicate link modes (speed and duplexity), link type (copper/fiber) and
link features (autonegotiation and pause). They are bitmaps of
:class:`PortFeatures` enum values that describe features.
Multiple of these flags may be set simultaneously. If none of the port
speed flags are set, the :attr:`max_speed` or :attr:`curr_speed` are used.
"""
port_no = UBInt32()
pad = Pad(4)
hw_addr = HWAddress()
pad2 = Pad(2)
name = Char(length=OFP_MAX_PORT_NAME_LEN)
config = UBInt32(enum_ref=PortConfig)
state = UBInt32(enum_ref=PortState)
curr = UBInt32(enum_ref=PortFeatures)
advertised = UBInt32(enum_ref=PortFeatures)
supported = UBInt32(enum_ref=PortFeatures)
peer = UBInt32(enum_ref=PortFeatures)
curr_speed = UBInt32()
max_speed = UBInt32()
def __init__(self, port_no=None, hw_addr=None, name=None, config=None,
state=None, curr=None, advertised=None, supported=None,
peer=None, curr_speed=None, max_speed=None):
"""Create a Port with the optional parameters below.
Args:
port_no (int): Port number.
hw_addr (HWAddress): Hardware address.
name (str): Null-terminated name.
config (~pyof.v0x04.common.port.PortConfig):
Bitmap of OFPPC* flags.
state (~pyof.v0x04.common.port.PortState): Bitmap of OFPPS* flags.
curr (~pyof.v0x04.common.port.PortFeatures): Current features.
advertised (~pyof.v0x04.common.port.PortFeatures):
Features being advertised by the port.
supported (~pyof.v0x04.common.port.PortFeatures):
Features supported by the port.
peer (~pyof.v0x04.common.port.PortFeatures):
Features advertised by peer.
curr_speed (int): Current port bitrate in kbps.
max_speed (int): Max port bitrate in kbps.
"""
super().__init__()
self.port_no = port_no
self.hw_addr = hw_addr
self.name = name
self.config = config
self.state = state
self.curr = curr
self.advertised = advertised
self.supported = supported
self.peer = peer
self.curr_speed = curr_speed
self.max_speed = max_speed
class ListOfPorts(FixedTypeList):
"""List of Ports.
Represented by instances of :class:`Port` and used on
:class:`~pyof.v0x04.controller2switch.features_reply.FeaturesReply`/
:class:`~pyof.v0x04.controller2switch.features_reply.SwitchFeatures`
objects.
"""
def __init__(self, items=None):
"""Create a ListOfPort with the optional parameters below.
Args:
items (:class:`list`, :class:`~pyof.v0x04.common.port.Port`):
One :class:`~pyof.v0x04.common.port.Port` instance or list.
"""
super().__init__(pyof_class=Port,
items=items)
|
