Merge pull request #8 from signal-09/link-modify

Implemented iplink_modify
signal-09 · Aug 7, 2024 · e406cc9 · e406cc9
2 parents c9c1f84 + 065598b
commit e406cc9
Show file tree

Hide file tree

Showing 18 changed files with 1,612 additions and 630 deletions.
diff --git a/.ruff.toml b/.ruff.toml
@@ -1,4 +1,4 @@
 line-length = 128
 
 [lint]
-ignore = ["F403", "F405"]
+ignore = ["F401", "F403", "F405"]
diff --git a/README.md b/README.md
@@ -7,8 +7,12 @@ This is a macOS network wrapper to imitate GNU/Linux [iproute2](https://wiki.lin
 
 ### Working staff
 
-* `ip link [ show ]`, `ip address [ show ]`, and `ip route [ show ]`
+* `ip address [ list | show ]`
+* `ip link [ list | show ]`
+* `ip link { add | set | change | delete }`
+* `ip route [ list | show ]`
 * `ip route { add | change | replace | delete }`
+* `ip route get`
 
 ## Installation
 
@@ -146,18 +150,126 @@ Shows the vlan devices:
 ip link show type vlan
 ```
 
-Shows devices enslaved by bridge0
+Shows devices enslaved by bridge0:
 ```shell
 ip link show master bridge0
 ```
 
+#### Notes
+
+1. `txqlen` (the transmit queue length) is not configurable on specific interface; a system default value is managed via `sysctl net.link.generic.system.sndq_maxlen` (or `net.link.generic.system.rcvq_maxlen`).
+
+### `ip link add`: add virtual link
+
+Implemented syntax:
+
+> ip link add [ link DEV | ~~parentdev NAME~~ ] [ name ] NAME
+>             [ ~~txqueuelen~~ PACKETS ]
+>             [ address LLADDR ]
+>             [ ~~broadcast LLADDR~~ ]
+>             [ mtu MTU ] [ ~~index IDX~~ ]
+>             [ ~~numtxqueues QUEUE_COUNT~~ ]
+>             [ ~~numrxqueues QUEUE_COUNT~~ ]
+>             [ ~~netns { PID | NETNSNAME | NETNSFILE }~~ ]
+>             type TYPE [ ARGS ]
+
+Create a VLAN with TAG 100 linked to en1:
+
+```shell
+ip link add link en1 name vlan100 type vlan id 100
+```
+
+Create a new bridge interface (auto numbering):
+
+```shell
+ip link add type bridge
+```
+
+Create a new bridge with a specified name:
+
+```shell
+ip link add bridge20 type bridge
+```
+
+Create a new static bond (vs lacp) interface:
+
+```shell
+ip link add bond1 type bond mode active-backup
+```
+
+### `ip link delete`: delete virtual link
+
+Implemented syntax:
+
+> ip link delete { DEVICE | dev DEVICE | ~~group DEVGROUP~~ } type TYPE [ ARGS ]
+
+Delete any kind of virtual interface:
+
+```shell
+ip link del vlan100
+```
+
+### `ip link set` (or `change`): change device attributes
+
+Implemented syntax:
+
+
+### `ip route show`: list routes
+
+Implemented syntax:
+
+> ip route [ show [ SELECTOR ] ]
+>
+> SELECTOR := [ ~~root PREFIX~~ ] [ ~~match PREFIX~~ ] [ ~~exact PREFIX~~ ]
+>             [ ~~table TABLE_ID~~ ] [ ~~vrf NAME~~ ] [ proto RTPROTO ]
+>             [ type TYPE ] [ scope SCOPE ]
+>
+> TYPE := { unicast | ~~local~~ | broadcast | multicast | ~~throw~~ |
+>           ~~unreachable~~ | ~~prohibit~~ | blackhole | ~~nat~~ }
+>
+> ~~TABLE_ID := [ local | main | default | all | NUMBER ]~~
+>
+> SCOPE := [ host | link | global | ~~NUMBER~~ ]
+>
+> RTPROTO := [ kernel | ~~boot~~ | static | ~~NUMBER~~ ]
+
+List routes using a specific gateway:
+
+```shell
+ip route show via 192.168.0.1
+```
+
+List routes using a specific network interface:
+
+```shell
+ip route show dev en1
+```
+
+List routes for multicast:
+
+```shell
+ip route show type multicast
+```
+
+List availabe routes to reach specific network:
+
+```shell
+ip route show to match 192.168.1.0/24
+```
+
+#### Notes
+
+1. `iif` is not honored (is treated like `dev` and `oif`).
+2. *Route tables* are not implemented in macOS (Darwin).
+
 ### `ip route add`: add new route
+### `ip route delete`: delete route
 ### `ip route change`: change route
 ### `ip route replace`: change or add new one
 
 Implemented syntax:
 
-> ip route { add | del | change | ~~append~~ | replace } ROUTE
+> ip route { add | delete | change | ~~append~~ | replace } ROUTE
 >
 > ROUTE := NODE_SPEC [ INFO_SPEC ]
 >
@@ -244,53 +356,12 @@ Delete route:
 ip route del 192.168.22.0/24
 ```
 
-### `ip route show`: list routes
-
-Implemented syntax:
-
-> ip route [ show [ SELECTOR ] ]
->
-> SELECTOR := [ ~~root PREFIX~~ ] [ ~~match PREFIX~~ ] [ ~~exact PREFIX~~ ]
->             [ ~~table TABLE_ID~~ ] [ ~~vrf NAME~~ ] [ proto RTPROTO ]
->             [ type TYPE ] [ scope SCOPE ]
->
-> TYPE := { unicast | ~~local~~ | broadcast | multicast | ~~throw~~ |
->           ~~unreachable~~ | ~~prohibit~~ | blackhole | ~~nat~~ }
->
-> ~~TABLE_ID := [ local | main | default | all | NUMBER ]~~
->
-> SCOPE := [ host | link | global | ~~NUMBER~~ ]
->
-> RTPROTO := [ kernel | ~~boot~~ | static | ~~NUMBER~~ ]
-
-List routes using a specific gateway:
-
-```shell
-ip route show via 192.168.0.1
-```
-
-List routes using a specific network interface:
-
-```shell
-ip route show dev en1
-```
-
-List routes for multicast:
-
-```shell
-ip route show type multicast
-```
-
-#### Notes
-
-1. `iif` is not honored (is treated like `dev` and `oif`).
-2. *Route tables* are not implemented in macOS (Darwin).
-
 ### `ip route get`: get a single route
 
 Implemented syntax:
 
 > ip route get ~~ROUTE_GET_FLAGS~~ ADDRESS [ ~~from ADDRESS iif STRING~~  ] [ ~~oif STRING~~ ] [ ~~mark MARK~~ ] [ ~~tos TOS~~ ] [ ~~vrf NAME~~ ] [ ~~ipproto PROTOCOL~~ ] [ ~~sport NUMBER~~ ] [ ~~dport NUMBER~~ ]
+>
 > ROUTE_GET_FLAGS :=  [ fibmatch ]
 
 Shows the route to reach Google DNS 8.8.8.8:
@@ -333,7 +404,7 @@ Then install requiered packages:
 
 ```shell
 python3 -m pip install -U pip
-python3 -m pip install pre-commit pytest flake8
+python3 -m pip install pre-commit pytest
 pre-commit install
 ```
 

diff --git a/iproute4mac/__init__.py b/iproute4mac/__init__.py
@@ -1 +1,58 @@
-VERSION = "0.1.7"
+VERSION = "0.2.0"
+
+# socket.h
+AF_UNSPEC = 0
+AF_UNIX = 1
+AF_INET = 2
+AF_BRIDGE = 7
+AF_INET6 = 10
+AF_PACKET = 17  # not present in BSD
+AF_MPLS = 28
+
+address_families = [
+    (AF_UNSPEC, "none"),
+    (AF_INET, "inet"),
+    (AF_INET6, "inet6"),
+    (AF_PACKET, "link"),
+    (AF_MPLS, "mpls"),
+    (AF_BRIDGE, "bridge"),
+]
+
+# libc
+EXIT_FAILURE = 1
+EXIT_SUCCESS = 0
+EXIT_ERROR = -1
+
+# map operstates
+oper_states = {"active": "UP", "inactive": "DOWN"}
+
+# MAC address RegEx
+LLSEG = "[0-9a-fA-F]{1,2}"
+LLADDR = "(?:%s(?::%s){5})" % (LLSEG, LLSEG)
+
+# IPv4 RegEx
+IPV4SEG = "(?:25[0-5]|2[0-4][0-9]|1{0,1}[0-9]{1,2})"
+IPV4ADDR = r"(?:%s(?:\.%s){0,3})" % (IPV4SEG, IPV4SEG)
+IPV4MASK = "(?:0x)?(?:[0-9a-fA-F]){8}"
+
+# IPv6 RegEx
+IPV6SEG = "(?:[0-9a-fA-F]{1,4})"
+IPV6GROUPS = (
+    "::",
+    "(?:%s:){1,7}:" % (IPV6SEG),
+    ":(?::%s){1,7}" % (IPV6SEG),
+    "(?:%s:){1,6}:%s" % (IPV6SEG, IPV6SEG),
+    "%s:(?::%s){1,6}" % (IPV6SEG, IPV6SEG),
+    "(?:%s:){1,5}(?::%s){1,2}" % (IPV6SEG, IPV6SEG),
+    "(?:%s:){1,4}(?::%s){1,3}" % (IPV6SEG, IPV6SEG),
+    "(?:%s:){1,3}(?::%s){1,4}" % (IPV6SEG, IPV6SEG),
+    "(?:%s:){1,2}(?::%s){1,5}" % (IPV6SEG, IPV6SEG),
+    "(?:%s:){7,7}%s" % (IPV6SEG, IPV6SEG),
+)
+IPV6ADDR = "|".join([f"(?:{group})" for group in IPV6GROUPS[::-1]])
+IPV6ADDR = f"(?:{IPV6ADDR})"
+
+# nu <netinet6/nd6.h>
+ND6_INFINITE_LIFETIME = 0xFFFFFFFF
+
+IFNAME = r"(?:\w+\d+)"