ip - show / manipulate routing, devices, policy routing and tunnels

ip [ OPTIONS ] OBJECT { COMMAND | help }
ip [ -force ] -batch filename

OBJECT := { link | addr | addrlabel | route | rule | neigh | ntable | tunnel | tuntap | maddr | mroute | mrule | monitor | xfrm | netns | l2tp }

OPTIONS := { -V[ersion] | -s[tatistics] | -d[etails] | -r[esolve] | -f[amily] { inet | inet6 | ipx | dnet | link } | -l[oops] { maximum-addr-flush-attempts } | -o[neline] | -t[imestamp] | -b[atch] [filename] | -rc[vbuf] [size]}

OBJECT := { link | addr | addrlabel | route | rule | neigh | ntable | tunnel | tuntap | maddr | mroute | mrule | monitor | xfrm | netns | l2tp }

OPTIONS := { -V[ersion] | -s[tatistics] | -r[esolve] | -f[amily] { inet | inet6 | ipx | dnet | link } | -o[neline] }

print the version of the ip utility and exit.
-s, -stats, -statistics output more information. If the option appears twice or more, the amount of information increases. As a rule, the infor- mation is statistics or some time values.
-l, -loops Specify maximum number of loops the 'ip addr flush' logic will attempt before giving up. The default is 10. Zero (0) means loop until all addresses are removed.
-f, -family followed by protocol family identifier: inet, inet6 or link ,enforce the protocol family to use. If the option is not present, the protocol family is guessed from other arguments. If the rest of the command line does not give enough infor- mation to guess the family, ip falls back to the default one, usually inet or any. link is a special family identifier meaning that no networking protocol is involved.
-4 shortcut for -family inet.
-6 shortcut for -family inet6.
-0 shortcut for -family link.
-o, -oneline output each record on a single line, replacing line feeds with the '\' character. This is convenient when you want to count records with wc(1) or to grep(1) the output.
-r, -resolve use the system's name resolver to print DNS names instead of host addresses. IP - COMMAND SYNTAX OBJECT
address - protocol (IP or IPv6) address on a device.
addrlabel - label configuration for protocol address selection.
l2tp - tunnel ethernet over IP (L2TPv3).
link device.
maddress - multicast address.
monitor - watch for netlink messages.
mroute multicast routing cache entry.
mrule rule in multicast routing policy database.
neighbour - manage ARP or NDISC cache entries.
netns manage network namespaces.
ntable manage the neighbor cache's operation.
route routing table entry.
rule rule in routing policy database.
tunnel tunnel over IP.
tuntap manage TUN/TAP devices.
xfrm manage IPSec policies.
Objects may be written in full or abbreviated form, example: address is abbreviated as addr or just a.


Action to perform on the object, depending on the object type.

add, delete and show (or list ) objects. Some objects do not allow all of these operations and some have additional commands.

help outputs a list of available commands and argument syntax conventions. If no command is given, some default command is assumed. U sually it is list or, if the objects of this class cannot be listed, help.


ip-address(8), ip-addrlabel(8), ip-l2tp(8), ip-link(8), ip-maddress(8), ip-monitor(8), ip-mroute(8), ip-neighbour(8), ip- netns(8), ip-ntable(8), ip-route(8), ip-rule(8), ip-tunnel(8), ip-xfrm(8) IP Command reference ip-cref.ps REPORTING BUGS Report bug to the Network Developers mailing list . iproute2 20 Dec 2011