iproute2mac

CLI wrapper for basic network utilities on macOS, inspired by iproute2 on Linux systems – ip and bridge commands

Provided functionality is limited and command output is not fully compatible with iproute2.\ Goal of this project is to make basic network configuration/debug tasks on macOS easy for admins who already use Linux systems.\ For advanced usage use netstat, ifconfig, ndp, arp, route and networksetup directly.

If you are interested in contributing, please see our Contribution Guidelines.

Installation

A) [Preferred] Using Homebrew:

# [Optional] Install Homebrew first, see http://brew.sh for options
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Install iproute2mac
brew install iproute2mac

B) Manual installation from HEAD:

sudo mkdir /usr/local/iproute2mac
sudo chown -R $(whoami):admin /usr/local/iproute2mac
cd /usr/local/
git clone https://github.com/brona/iproute2mac.git
ln -s iproute2mac/src/ip.py /usr/local/bin/ip
ln -s iproute2mac/src/bridge.py /usr/local/bin/bridge

Supported commands / Example usage

Goal of this utility is to provide compatible CLI with iproute2, supporting same command shortcuts and user experience.

• Help
  • ip help
  • ip link help
  • ip addr help
  • ip route help
  • ip neigh help
  • bridge help
  • bridge link help
• Link module (Interfaces)
  • List local interfaces ip link
  • Show one interface ip link show en0
  • Shutdown interface ip link set dev en0 down
  • Start interface ip link set dev en0 up
  • Set custom MAC address ip link set dev en0 address 00:12:34:45:78:90
  • Set random MAC address ip link set en0 address random
  • Set factory default MAC address ip link set en0 address factory
  • Set MTU ip link set dev en0 mtu 9000
• Neighbour module (ARP/NDP)
  • Show all neighbours ip neigh
  • Show all IPv4 (ARP) neighbours ip -4 neigh
  • Show all IPv6 (NDP) neighbours ip -6 neigh
  • Show all IPv4 (ARP) neighbours for a specific interface ip -4 neigh show dev en0
  • Show neighbours filtered by prefix ip -4 neigh show 192.0.2.0/24
  • IPv6 (NDP) neighbours cannot be currently shown for a specific interface
  • Flush all neighbours (IPv4 + IPv6) for a specific interface ip neigh flush dev en0
  • Flush all IPv4 (ARP) neighbours for a specific interface ip -4 neigh flush dev en0
  • IPv6 (NDP) neighbours are being flushed for all interfaces
• Address module
  • List all addresses ip addr
  • List IPv4 addresses ip -4 addr
  • List IPv6 addresses ip -6 addr
  • Add address to interface ip addr add 10.0.0.5/24 dev en0
  • Remove address from interface ip addr del 10.0.0.5 dev en0
• Route module
  • List IPv4 addresses ip route
  • List IPv6 addresses ip -6 route
  • Flush route cache (no-op on MacOS) ip route flush cache
  • Flush routes ip route flush table main
  • Get route for destination ip route get 8.8.8.8
  • Add static route ip route add 192.168.0.0/16 nexthop 10.0.0.1
  • Add default route ip route add default nexthop 10.0.0.1
  • Replace static route ip route replace 192.0.2.0/24 dev utun1
  • Remove static route ip route del 192.168.0.0/16
• Bridge module
  • List bridge interfaces bridge link
  • List one bridged interface bridge link show dev en2
• JSON output
  • List interfaces: ip -j link show
  • List addresses: ip -j addr show
  • List neighbours: ip -j neigh show
  • List routes: ip -j route show
  • List bridges (with pretty print): bridge -j -p link show

Changelog

Authors

See AUTHORS.

Used software/code:

• macgen.py - Function for generating random MAC address
• SpoofMAC - Code for obtaining factory default MAC address for interface

License

• The MIT License (MIT)