# This file is part of Scapy # See http://www.secdev.org/projects/scapy for more information # Copyright (C) Philippe Biondi # This program is published under a GPLv2 license """ Routing and handling of network interfaces. """ from __future__ import absolute_import import scapy.consts from scapy.config import conf from scapy.error import Scapy_Exception, warning from scapy.modules import six from scapy.utils import atol, ltoa, itom, plain_str, pretty_list ############################## # Routing/Interfaces stuff # ############################## class Route: def __init__(self): self.resync() def invalidate_cache(self): self.cache = {} def resync(self): from scapy.arch import read_routes self.invalidate_cache() self.routes = read_routes() def __repr__(self): rtlst = [] for net, msk, gw, iface, addr, metric in self.routes: rtlst.append((ltoa(net), ltoa(msk), gw, (iface.description if not isinstance(iface, six.string_types) else iface), # noqa: E501 addr, str(metric))) return pretty_list(rtlst, [("Network", "Netmask", "Gateway", "Iface", "Output IP", "Metric")]) # noqa: E501 def make_route(self, host=None, net=None, gw=None, dev=None, metric=1): from scapy.arch import get_if_addr if host is not None: thenet, msk = host, 32 elif net is not None: thenet, msk = net.split("/") msk = int(msk) else: raise Scapy_Exception("make_route: Incorrect parameters. You should specify a host or a net") # noqa: E501 if gw is None: gw = "0.0.0.0" if dev is None: if gw: nhop = gw else: nhop = thenet dev, ifaddr, _ = self.route(nhop) else: ifaddr = get_if_addr(dev) return (atol(thenet), itom(msk), gw, dev, ifaddr, metric) def add(self, *args, **kargs): """Ex: add(net="192.168.1.0/24",gw="1.2.3.4") """ self.invalidate_cache() self.routes.append(self.make_route(*args, **kargs)) def delt(self, *args, **kargs): """delt(host|net, gw|dev)""" self.invalidate_cache() route = self.make_route(*args, **kargs) try: i = self.routes.index(route) del(self.routes[i]) except ValueError: warning("no matching route found") def ifchange(self, iff, addr): self.invalidate_cache() the_addr, the_msk = (addr.split("/") + ["32"])[:2] the_msk = itom(int(the_msk)) the_rawaddr = atol(the_addr) the_net = the_rawaddr & the_msk for i, route in enumerate(self.routes): net, msk, gw, iface, addr, metric = route if scapy.consts.WINDOWS: if iff.guid != iface.guid: continue elif iff != iface: continue if gw == '0.0.0.0': self.routes[i] = (the_net, the_msk, gw, iface, the_addr, metric) # noqa: E501 else: self.routes[i] = (net, msk, gw, iface, the_addr, metric) conf.netcache.flush() def ifdel(self, iff): self.invalidate_cache() new_routes = [] for rt in self.routes: if scapy.consts.WINDOWS: if iff.guid == rt[3].guid: continue elif iff == rt[3]: continue new_routes.append(rt) self.routes = new_routes def ifadd(self, iff, addr): self.invalidate_cache() the_addr, the_msk = (addr.split("/") + ["32"])[:2] the_msk = itom(int(the_msk)) the_rawaddr = atol(the_addr) the_net = the_rawaddr & the_msk self.routes.append((the_net, the_msk, '0.0.0.0', iff, the_addr, 1)) def route(self, dst=None, verbose=conf.verb): """Returns the IPv4 routes to a host. parameters: - dst: the IPv4 of the destination host returns: (iface, output_ip, gateway_ip) - iface: the interface used to connect to the host - output_ip: the outgoing IP that will be used - gateway_ip: the gateway IP that will be used """ dst = dst or "0.0.0.0" # Enable route(None) to return default route if isinstance(dst, bytes): try: dst = plain_str(dst) except UnicodeDecodeError: raise TypeError("Unknown IP address input (bytes)") if dst in self.cache: return self.cache[dst] # Transform "192.168.*.1-5" to one IP of the set _dst = dst.split("/")[0].replace("*", "0") while True: idx = _dst.find("-") if idx < 0: break m = (_dst[idx:] + ".").find(".") _dst = _dst[:idx] + _dst[idx + m:] atol_dst = atol(_dst) paths = [] for d, m, gw, i, a, me in self.routes: if not a: # some interfaces may not currently be connected continue aa = atol(a) if aa == atol_dst: paths.append( (0xffffffff, 1, (conf.loopback_name, a, "0.0.0.0")) # noqa: E501 ) if (atol_dst & m) == (d & m): paths.append((m, me, (i, a, gw))) if not paths: if verbose: warning("No route found (no default route?)") return conf.loopback_name, "0.0.0.0", "0.0.0.0" # Choose the more specific route # Sort by greatest netmask and use metrics as a tie-breaker paths.sort(key=lambda x: (-x[0], x[1])) # Return interface ret = paths[0][2] self.cache[dst] = ret return ret def get_if_bcast(self, iff): for net, msk, gw, iface, addr, metric in self.routes: if net == 0: continue if scapy.consts.WINDOWS: if iff.guid != iface.guid: continue elif iff != iface: continue bcast = atol(addr) | (~msk & 0xffffffff) # FIXME: check error in atol() # noqa: E501 return ltoa(bcast) warning("No broadcast address found for iface %s\n", iff) conf.route = Route() iface = conf.route.route(None, verbose=0)[0] if getattr(iface, "name", iface) == conf.loopback_name: from scapy.arch import get_working_if conf.iface = get_working_if() else: conf.iface = iface del iface