CLI wrapper for basic network utilities on Mac OS X inspired with iproute2 on Linux systems - ip command.

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 Mac OS X easy for admins who already use Linux systems.

For advanced usage use netstat, ifconfig, ndp, arp, route and networksetup directly.

• Mac OS X Maverics 10.10.5 (Python 2.7.10)

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
• 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
  • IPv6 (NDP) neighbours cannot be currently shown for a specific interface
  • Flush all neighbours (IPv4 + IPv6) ip neigh flush
  • Flush all IPv4 (ARP) neighbours ip -4 neigh flush
  • Flush all IPv6 (NDP) neighbours ip -6 neigh flush
  • Flush all IPv4 (ARP) neighbours for a specific interface ip -4 neigh flush dev en0
  • IPv6 (NDP) neighbours cannot be currently flushed for a specific interface
• 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 to interface ip addr del 10.0.0.5 dev en0
• Route module
  • List IPv4 addresses ip route
  • List IPv6 addresses ip -6 route
  • 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
  • Remove static route ip route del 192.168.0.0/16

A) Using Homebrew:

# Install Homebrew first - see http://brew.sh
$ brew install iproute2mac

B) Manual installation:

$ curl --remote-name -L https://github.com/brona/iproute2mac/raw/master/src/ip.py
$ chmod +x ip.py
$ mv ip.py /usr/local/bin/ip

v1.1.1

• Added dev option to ip route add command

v1.1.0

• Added source IP address to ip route get command
• Accepted to Homebrew master branch, tap is no longer supported

v1.0.9

• Fixed versioning

v1.0.8

• Better error handling and error messages (Thanks rgcr)

v1.0.7

• Help messages are sent to stderr (Thanks rgcr)

v1.0.6

• Fixed ip -6 neigh failing for N status flag

v1.0.5

• Added s shortcuts to show commands (Thanks vmoutoussamy)

v1.0.4

• Added ip neigh flush (Thanks ThangCZ)
• Added 'dev' option for ip neigh show and ip neigh flush

v1.0.3

• Fixed ifconfig: dev: bad value in ip addr del

v1.0.2

• Interface name is concatenated to ip addr inet rows

See AUTHORS.

Used software/code:

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

• The MIT License (MIT)