Skip to content

Commit

Permalink
Use IPv6 default route when no IPv4 is available
Browse files Browse the repository at this point in the history
  • Loading branch information
guedou committed Mar 19, 2024
1 parent 58519e5 commit 425690a
Show file tree
Hide file tree
Showing 3 changed files with 32 additions and 0 deletions.
3 changes: 3 additions & 0 deletions doc/scapy/usage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -226,6 +226,9 @@ make\_table() displays a table according to a lambda function
Sending packets
---------------

.. note::
Scapy automatically detects the network interface to be used by default, and stores this result in ``conf.iface``. Packets built by Scapy uses this variable to set relevant fields such as Ethernet source addresses. When sending packets, with functions such as ``send()``, Scapy will use the network interface stored in ``conf.iface``. This behavior can be changed using the ``iface=`` argument. With IPv6 and link-local addresses, it is mandatory to setup both ``conf.iface`` and ``iface=`` the same value to get the desired result, as Scapy cannot find which interface to use for link-local communications.

.. index::
single: Sending packets, send

Expand Down
16 changes: 16 additions & 0 deletions scapy/interfaces.py
Original file line number Diff line number Diff line change
Expand Up @@ -372,6 +372,8 @@ def get_if_list():
def get_working_if():
# type: () -> NetworkInterface
"""Return an interface that works"""

# IPv4
# return the interface associated with the route with smallest
# mask (route by default if it exists)
routes = conf.route.routes[:]
Expand All @@ -383,6 +385,20 @@ def get_working_if():
iface = resolve_iface(ifname) # type: ignore
if iface.is_valid():
return iface

# IPv6
routes_ipv6 = conf.route6.routes
default_routes_ipv6 = [r for r in routes_ipv6 if r[0] == "::"]
if default_routes_ipv6:
# Sort the default routes using the priority (at index -1)
tmp_routes = sorted(default_routes_ipv6, key=lambda r: r[-1])

# Return the interface (at index 3) of the highest priority default
ifname = tmp_routes[-1][3]
iface = resolve_iface(ifname)
if iface.is_valid():
return iface

# There is no hope left
return resolve_iface(conf.loopback_name)

Expand Down
13 changes: 13 additions & 0 deletions test/regression.uts
Original file line number Diff line number Diff line change
Expand Up @@ -334,6 +334,19 @@ assert "cuz you know the way to go" + conf.iface # right +

_test_get_working_if()

# Test IPv6 default route interface selection
ni = NetworkInterface(InterfaceProvider(), {"name": "scapy0", "ips": ["::1"], "mac": "aa:aa:aa:aa:aa:aa"})

import mock
@mock.patch("scapy.interfaces.conf.ifaces", {})
@mock.patch("scapy.interfaces.conf.route.routes", [])
@mock.patch("scapy.interfaces.conf.route6.routes", [("::", 0, "", ni, [""], 0)])
def _test_get_working_if_v6():

assert get_working_if() == ni

_test_get_working_if_v6()

= Test conf.ifaces

conf.iface
Expand Down

0 comments on commit 425690a

Please sign in to comment.