Files
deb-ryu/ryu/lib/ip.py
Yusuke Iwase 9663fbe563 of10: Support human readable MAC/IPv4 address in OFPMatch
In OF1.0, OFPMatch is required to specify MAC address as a binary
type value and to specify IPv4 Address as an int type value.
This behavior is differ from that in OF1.2+.
This patch makes OFPMatch in OF1.0 enable to support human readable
representation of MAC/IPv4 address like OF1.2+ API.

The current API in OF1.0:
  >>> match = parser.OFPMatch(dl_src=b'\x01\x02\x03\x04\x05\x06',
  ...                         nw_src=167772163)
  >>> match.dl_src
  '\x01\x02\x03\x04\x05\x06'
  >>> match.nw_src
  167772163

The introduced API (the same as OF1.2+ API):
  >>> match = parser.OFPMatch(dl_dst='aa:bb:cc:dd:ee:ff',
  ...                         nw_dst='192.168.0.1')
  >>> match['dl_dst']
  'aa:bb:cc:dd:ee:ff'
  >>> match['nw_dst']
  '192.168.0.1'

Signed-off-by: IWASE Yusuke <iwase.yusuke0@gmail.com>
Signed-off-by: FUJITA Tomonori <fujita.tomonori@lab.ntt.co.jp>
2015-10-11 21:51:37 +09:00

67 lines
2.0 KiB
Python

# Copyright (C) 2015 Nippon Telegraph and Telephone Corporation.
#
# 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.
import struct
from ryu.lib import addrconv
def ipv4_to_bin(ip):
"""
Converts human readable IPv4 string to binary representation.
:param str ip: IPv4 address string
:return: binary representation of IPv4 address
"""
return addrconv.ipv4.text_to_bin(ip)
def ipv4_to_int(ip):
"""
Converts human readable IPv4 string to int type representation.
:param str ip: IPv4 address string w.x.y.z
:returns: unsigned int of form w << 24 | x << 16 | y << 8 | z
"""
return struct.unpack("!I", addrconv.ipv4.text_to_bin(ip))[0]
def ipv4_to_str(ip):
"""
Converts binary or int type representation to human readable IPv4 string.
:param str ip: binary or int type representation of IPv4 address
:return: IPv4 address string
"""
if isinstance(ip, int):
return addrconv.ipv4.bin_to_text(struct.pack("!I", ip))
else:
return addrconv.ipv4.bin_to_text(ip)
def ipv6_to_bin(ip):
"""
Converts human readable IPv6 string to binary representation.
:param str ip: IPv6 address string
:return: binary representation of IPv6 address
"""
return addrconv.ipv6.text_to_bin(ip)
def ipv6_to_str(ip):
"""
Converts binary representation to human readable IPv6 string.
:param str ip: binary representation of IPv6 address
:return: IPv6 address string
"""
return addrconv.ipv6.bin_to_text(ip)