]>
Commit | Line | Data |
---|---|---|
8c0aa613 MA |
1 | # -*- Mode: Python -*- |
2 | ||
d3a48372 MAL |
3 | ## |
4 | # = Rocker switch device | |
5 | ## | |
6 | ||
fafa4d50 | 7 | ## |
4d5c8bc4 | 8 | # @RockerSwitch: |
fafa4d50 SF |
9 | # |
10 | # Rocker switch information. | |
11 | # | |
12 | # @name: switch name | |
13 | # | |
14 | # @id: switch ID | |
15 | # | |
16 | # @ports: number of front-panel ports | |
17 | # | |
18 | # Since: 2.4 | |
19 | ## | |
20 | { 'struct': 'RockerSwitch', | |
21 | 'data': { 'name': 'str', 'id': 'uint64', 'ports': 'uint32' } } | |
22 | ||
23 | ## | |
24 | # @query-rocker: | |
25 | # | |
26 | # Return rocker switch information. | |
27 | # | |
28 | # Returns: @Rocker information | |
29 | # | |
30 | # Since: 2.4 | |
a35c33f0 MAL |
31 | # |
32 | # Example: | |
33 | # | |
34 | # -> { "execute": "query-rocker", "arguments": { "name": "sw1" } } | |
35 | # <- { "return": {"name": "sw1", "ports": 2, "id": 1327446905938}} | |
36 | # | |
fafa4d50 SF |
37 | ## |
38 | { 'command': 'query-rocker', | |
39 | 'data': { 'name': 'str' }, | |
40 | 'returns': 'RockerSwitch' } | |
41 | ||
42 | ## | |
43 | # @RockerPortDuplex: | |
44 | # | |
45 | # An eumeration of port duplex states. | |
46 | # | |
47 | # @half: half duplex | |
48 | # | |
49 | # @full: full duplex | |
50 | # | |
51 | # Since: 2.4 | |
52 | ## | |
53 | { 'enum': 'RockerPortDuplex', 'data': [ 'half', 'full' ] } | |
54 | ||
55 | ## | |
56 | # @RockerPortAutoneg: | |
57 | # | |
58 | # An eumeration of port autoneg states. | |
59 | # | |
60 | # @off: autoneg is off | |
61 | # | |
62 | # @on: autoneg is on | |
63 | # | |
64 | # Since: 2.4 | |
65 | ## | |
66 | { 'enum': 'RockerPortAutoneg', 'data': [ 'off', 'on' ] } | |
67 | ||
68 | ## | |
69 | # @RockerPort: | |
70 | # | |
71 | # Rocker switch port information. | |
72 | # | |
73 | # @name: port name | |
74 | # | |
75 | # @enabled: port is enabled for I/O | |
76 | # | |
77 | # @link-up: physical link is UP on port | |
78 | # | |
79 | # @speed: port link speed in Mbps | |
80 | # | |
81 | # @duplex: port link duplex | |
82 | # | |
83 | # @autoneg: port link autoneg | |
84 | # | |
85 | # Since: 2.4 | |
86 | ## | |
87 | { 'struct': 'RockerPort', | |
88 | 'data': { 'name': 'str', 'enabled': 'bool', 'link-up': 'bool', | |
89 | 'speed': 'uint32', 'duplex': 'RockerPortDuplex', | |
90 | 'autoneg': 'RockerPortAutoneg' } } | |
91 | ||
92 | ## | |
93 | # @query-rocker-ports: | |
94 | # | |
7e20b169 | 95 | # Return rocker switch port information. |
fafa4d50 | 96 | # |
7e20b169 | 97 | # Returns: a list of @RockerPort information |
fafa4d50 SF |
98 | # |
99 | # Since: 2.4 | |
7e20b169 MAL |
100 | # |
101 | # Example: | |
102 | # | |
103 | # -> { "execute": "query-rocker-ports", "arguments": { "name": "sw1" } } | |
104 | # <- { "return": [ {"duplex": "full", "enabled": true, "name": "sw1.1", | |
105 | # "autoneg": "off", "link-up": true, "speed": 10000}, | |
106 | # {"duplex": "full", "enabled": true, "name": "sw1.2", | |
107 | # "autoneg": "off", "link-up": true, "speed": 10000} | |
108 | # ]} | |
109 | # | |
fafa4d50 SF |
110 | ## |
111 | { 'command': 'query-rocker-ports', | |
112 | 'data': { 'name': 'str' }, | |
113 | 'returns': ['RockerPort'] } | |
114 | ||
115 | ## | |
116 | # @RockerOfDpaFlowKey: | |
117 | # | |
118 | # Rocker switch OF-DPA flow key | |
119 | # | |
120 | # @priority: key priority, 0 being lowest priority | |
121 | # | |
122 | # @tbl-id: flow table ID | |
123 | # | |
124 | # @in-pport: #optional physical input port | |
125 | # | |
126 | # @tunnel-id: #optional tunnel ID | |
127 | # | |
128 | # @vlan-id: #optional VLAN ID | |
129 | # | |
130 | # @eth-type: #optional Ethernet header type | |
131 | # | |
132 | # @eth-src: #optional Ethernet header source MAC address | |
133 | # | |
134 | # @eth-dst: #optional Ethernet header destination MAC address | |
135 | # | |
136 | # @ip-proto: #optional IP Header protocol field | |
137 | # | |
138 | # @ip-tos: #optional IP header TOS field | |
139 | # | |
140 | # @ip-dst: #optional IP header destination address | |
141 | # | |
8c0aa613 MA |
142 | # Note: optional members may or may not appear in the flow key |
143 | # depending if they're relevant to the flow key. | |
fafa4d50 SF |
144 | # |
145 | # Since: 2.4 | |
146 | ## | |
147 | { 'struct': 'RockerOfDpaFlowKey', | |
148 | 'data' : { 'priority': 'uint32', 'tbl-id': 'uint32', '*in-pport': 'uint32', | |
149 | '*tunnel-id': 'uint32', '*vlan-id': 'uint16', | |
150 | '*eth-type': 'uint16', '*eth-src': 'str', '*eth-dst': 'str', | |
151 | '*ip-proto': 'uint8', '*ip-tos': 'uint8', '*ip-dst': 'str' } } | |
152 | ||
153 | ## | |
154 | # @RockerOfDpaFlowMask: | |
155 | # | |
156 | # Rocker switch OF-DPA flow mask | |
157 | # | |
158 | # @in-pport: #optional physical input port | |
159 | # | |
160 | # @tunnel-id: #optional tunnel ID | |
161 | # | |
162 | # @vlan-id: #optional VLAN ID | |
163 | # | |
164 | # @eth-src: #optional Ethernet header source MAC address | |
165 | # | |
166 | # @eth-dst: #optional Ethernet header destination MAC address | |
167 | # | |
168 | # @ip-proto: #optional IP Header protocol field | |
169 | # | |
170 | # @ip-tos: #optional IP header TOS field | |
171 | # | |
8c0aa613 MA |
172 | # Note: optional members may or may not appear in the flow mask |
173 | # depending if they're relevant to the flow mask. | |
fafa4d50 SF |
174 | # |
175 | # Since: 2.4 | |
176 | ## | |
177 | { 'struct': 'RockerOfDpaFlowMask', | |
178 | 'data' : { '*in-pport': 'uint32', '*tunnel-id': 'uint32', | |
179 | '*vlan-id': 'uint16', '*eth-src': 'str', '*eth-dst': 'str', | |
180 | '*ip-proto': 'uint8', '*ip-tos': 'uint8' } } | |
181 | ||
182 | ## | |
183 | # @RockerOfDpaFlowAction: | |
184 | # | |
185 | # Rocker switch OF-DPA flow action | |
186 | # | |
187 | # @goto-tbl: #optional next table ID | |
188 | # | |
189 | # @group-id: #optional group ID | |
190 | # | |
191 | # @tunnel-lport: #optional tunnel logical port ID | |
192 | # | |
193 | # @vlan-id: #optional VLAN ID | |
194 | # | |
195 | # @new-vlan-id: #optional new VLAN ID | |
196 | # | |
197 | # @out-pport: #optional physical output port | |
198 | # | |
8c0aa613 MA |
199 | # Note: optional members may or may not appear in the flow action |
200 | # depending if they're relevant to the flow action. | |
fafa4d50 SF |
201 | # |
202 | # Since: 2.4 | |
203 | ## | |
204 | { 'struct': 'RockerOfDpaFlowAction', | |
205 | 'data' : { '*goto-tbl': 'uint32', '*group-id': 'uint32', | |
206 | '*tunnel-lport': 'uint32', '*vlan-id': 'uint16', | |
207 | '*new-vlan-id': 'uint16', '*out-pport': 'uint32' } } | |
208 | ||
209 | ## | |
210 | # @RockerOfDpaFlow: | |
211 | # | |
212 | # Rocker switch OF-DPA flow | |
213 | # | |
214 | # @cookie: flow unique cookie ID | |
215 | # | |
216 | # @hits: count of matches (hits) on flow | |
217 | # | |
218 | # @key: flow key | |
219 | # | |
220 | # @mask: flow mask | |
221 | # | |
222 | # @action: flow action | |
223 | # | |
224 | # Since: 2.4 | |
225 | ## | |
226 | { 'struct': 'RockerOfDpaFlow', | |
227 | 'data': { 'cookie': 'uint64', 'hits': 'uint64', 'key': 'RockerOfDpaFlowKey', | |
228 | 'mask': 'RockerOfDpaFlowMask', 'action': 'RockerOfDpaFlowAction' } } | |
229 | ||
230 | ## | |
231 | # @query-rocker-of-dpa-flows: | |
232 | # | |
233 | # Return rocker OF-DPA flow information. | |
234 | # | |
235 | # @name: switch name | |
236 | # | |
237 | # @tbl-id: #optional flow table ID. If tbl-id is not specified, returns | |
238 | # flow information for all tables. | |
239 | # | |
435fcb29 | 240 | # Returns: rocker OF-DPA flow information |
fafa4d50 SF |
241 | # |
242 | # Since: 2.4 | |
435fcb29 MAL |
243 | # |
244 | # Example: | |
245 | # | |
246 | # -> { "execute": "query-rocker-of-dpa-flows", | |
247 | # "arguments": { "name": "sw1" } } | |
248 | # <- { "return": [ {"key": {"in-pport": 0, "priority": 1, "tbl-id": 0}, | |
249 | # "hits": 138, | |
250 | # "cookie": 0, | |
251 | # "action": {"goto-tbl": 10}, | |
252 | # "mask": {"in-pport": 4294901760} | |
253 | # }, | |
254 | # {...more...}, | |
255 | # ]} | |
256 | # | |
fafa4d50 SF |
257 | ## |
258 | { 'command': 'query-rocker-of-dpa-flows', | |
259 | 'data': { 'name': 'str', '*tbl-id': 'uint32' }, | |
260 | 'returns': ['RockerOfDpaFlow'] } | |
261 | ||
262 | ## | |
263 | # @RockerOfDpaGroup: | |
264 | # | |
265 | # Rocker switch OF-DPA group | |
266 | # | |
267 | # @id: group unique ID | |
268 | # | |
269 | # @type: group type | |
270 | # | |
271 | # @vlan-id: #optional VLAN ID | |
272 | # | |
273 | # @pport: #optional physical port number | |
274 | # | |
275 | # @index: #optional group index, unique with group type | |
276 | # | |
277 | # @out-pport: #optional output physical port number | |
278 | # | |
279 | # @group-id: #optional next group ID | |
280 | # | |
281 | # @set-vlan-id: #optional VLAN ID to set | |
282 | # | |
283 | # @pop-vlan: #optional pop VLAN headr from packet | |
284 | # | |
285 | # @group-ids: #optional list of next group IDs | |
286 | # | |
287 | # @set-eth-src: #optional set source MAC address in Ethernet header | |
288 | # | |
289 | # @set-eth-dst: #optional set destination MAC address in Ethernet header | |
290 | # | |
291 | # @ttl-check: #optional perform TTL check | |
292 | # | |
8c0aa613 MA |
293 | # Note: optional members may or may not appear in the group depending |
294 | # if they're relevant to the group type. | |
fafa4d50 SF |
295 | # |
296 | # Since: 2.4 | |
297 | ## | |
298 | { 'struct': 'RockerOfDpaGroup', | |
299 | 'data': { 'id': 'uint32', 'type': 'uint8', '*vlan-id': 'uint16', | |
300 | '*pport': 'uint32', '*index': 'uint32', '*out-pport': 'uint32', | |
301 | '*group-id': 'uint32', '*set-vlan-id': 'uint16', | |
302 | '*pop-vlan': 'uint8', '*group-ids': ['uint32'], | |
303 | '*set-eth-src': 'str', '*set-eth-dst': 'str', | |
304 | '*ttl-check': 'uint8' } } | |
305 | ||
306 | ## | |
307 | # @query-rocker-of-dpa-groups: | |
308 | # | |
309 | # Return rocker OF-DPA group information. | |
310 | # | |
311 | # @name: switch name | |
312 | # | |
313 | # @type: #optional group type. If type is not specified, returns | |
314 | # group information for all group types. | |
315 | # | |
9389a4e3 | 316 | # Returns: rocker OF-DPA group information |
fafa4d50 SF |
317 | # |
318 | # Since: 2.4 | |
9389a4e3 MAL |
319 | # |
320 | # Example: | |
321 | # | |
322 | # -> { "execute": "query-rocker-of-dpa-groups", | |
323 | # "arguments": { "name": "sw1" } } | |
324 | # <- { "return": [ {"type": 0, "out-pport": 2, | |
325 | # "pport": 2, "vlan-id": 3841, | |
326 | # "pop-vlan": 1, "id": 251723778}, | |
327 | # {"type": 0, "out-pport": 0, | |
328 | # "pport": 0, "vlan-id": 3841, | |
329 | # "pop-vlan": 1, "id": 251723776}, | |
330 | # {"type": 0, "out-pport": 1, | |
331 | # "pport": 1, "vlan-id": 3840, | |
332 | # "pop-vlan": 1, "id": 251658241}, | |
333 | # {"type": 0, "out-pport": 0, | |
334 | # "pport": 0, "vlan-id": 3840, | |
335 | # "pop-vlan": 1, "id": 251658240} | |
336 | # ]} | |
337 | # | |
fafa4d50 SF |
338 | ## |
339 | { 'command': 'query-rocker-of-dpa-groups', | |
340 | 'data': { 'name': 'str', '*type': 'uint8' }, | |
341 | 'returns': ['RockerOfDpaGroup'] } |