iproute2/doc/ip-cref.tex

2 \def\TITLE{IP Command Reference}
5 \Large\bf IP Command Reference.
30 and examples to understand and configure Linux-2.2 IP and IPv6
113 \item \verb|address| --- protocol (IP or IPv6) address on a device
119 \item \verb|tunnel| --- tunnel over IP
164 IP address {\em et al\/}. In this case \verb|ip| prints an error message
190 (Sec.\ref{IP-LINK}, p.\pageref{IP-LINK}),
226 \label{IP-LINK}
326 \label{IP-LINK-SHOW}
470 of tunnels over IP are printed as dotted-quad IP addresses.
480 \verb|ip maddr ls| in~Sec.\ref{IP-MADDR} (p.\pageref{IP-MADDR} of this
553 \paragraph{Object:} The \verb|address| is a protocol (IP or IPv6) address attached
568 \label{IP-ADDR-ADD}
582 on the protocol. It is a dotted quad for IP and a sequence of hexadecimal halfwords
668 \item Disable IP on the interface \verb|eth0|:
674 Another method to disable IP on an interface using {\tt ip addr flush}
675 may be found in sec.\ref{IP-ADDR-FLUSH}, p.\pageref{IP-ADDR-FLUSH}.
745 Then the list of IP and IPv6 addresses follows, accompanied by
746 additional address attributes: scope value (see Sec.\ref{IP-ADDR-ADD},
747 p.\pageref{IP-ADDR-ADD} above), flags and the address label.
757 An IP address becomes secondary if another address with the same
785 \label{IP-ADDR-FLUSH}
817 Another instructive example is disabling IP on all the Ethernets:
1071 \label{IP-ROUTE}
1080 optionally, the TOS value. An IP packet matches the route if the highest
1141 the data required to deliver IP packets (f.e.\ output device and
1146 \paragraph{Route types:} \label{IP-ROUTE-TYPES}
1170 rules (see sec.\ref{IP-RULE}, p.\pageref{IP-RULE}). If such a route is selected, lookup
1201 is used. See sec.\ref{IP-RULE}, p.\pageref{IP-RULE}.
1210 \label{IP-ROUTE-ADD}
1222 are listed above. \verb|PREFIX| is an IP or IPv6 address optionally followed
1225 \verb|PREFIX| --- \verb|default| --- which is equivalent to IP \verb|0/0| or
1260 For NAT routes it is the first address of the block of translated IP destinations.
1379 option may be found in~\cite{IP-TUNNELS}.
1431 in the following section (sec.\ref{IP-RULE}, p.\pageref{IP-RULE}).
1450 (sec.\ref{IP-ROUTE-FLUSH}, p.\pageref{IP-ROUTE-FLUSH}) which
1614 in an error. See attribute \verb|error| below (p.\pageref{IP-ROUTE-GET-error}).
1650 devoted to route types (p.\pageref{IP-ROUTE-TYPES}).
1651 \label{IP-ROUTE-GET-error}
1669 \label{IP-ROUTE-FLUSH}
1679 dumps all the IP main routing table but \verb|flush| prints the helper page.
1745 \label{IP-ROUTE-GET}
1836 deliver) the packet to local IP listeners. In this case the router
1885 \label{IP-RULE}
1899 IP protocol, transport protocol ports or even packet payload.
1926 Matching IP protocols and transport ports is also possible,
1986 table. NAT and masquerading rules have an attribute to select new IP
2004 of the IP packet into some other value. More about NAT is
2014 \label{IP-RULE-ADD}
2079 --- The base of the IP address block to translate (for source addresses).
2118 \label{IP-RULE-SHOW}
2160 \label{IP-MADDR}
2260 \label{IP-MROUTE}
2295 --- the prefix selecting the IP source addresses of the multicast route.
2333 \label{IP-TUNNEL}
2338 packets in IPv4 packets and then sending them over the IP infrastructure.
2344 over IP and the \verb|ip tunnel| command can be found in~\cite{IP-TUNNELS}.
2405 	either a number or an IP address-like dotted quad.
2471 (sec.\ref{IP-LINK-SHOW}, p.\pageref{IP-LINK-SHOW}) but the tags are different
2484 transmitted because there is no IP route to the remote endpoint.
2491 \label{IP-MONITOR}
2560 can also be handled manually with \verb|ip route| (see sec.\ref{IP-ROUTE},
2561 p.\pageref{IP-ROUTE}).
2570 with routing policy rules, see sec.~\ref{IP-RULE}, p.\pageref{IP-RULE}.
2622 ``Neighbor Discovery for IP Version 6 (IPv6)'', RFC-2461.
2628 ``Requirements for IP Version 4 Routers'', RFC-1812.
2639 \bibitem{IP-TUNNELS} A.~N.~Kuznetsov.
2640 ``Tunnels over IP in Linux-2.2'', \\
2665 When a host creates an IP packet, it must select some source
2691 \item Otherwise, IP routing tables can contain an explicit source
2693 to the \verb|ip route| command, sec.\ref{IP-ROUTE}, p.\pageref{IP-ROUTE}.
2698 The search strategies are different for IP and IPv6. Namely:
2704 \item IP searches for the first valid address with a scope wider
2710 sec.\ref{IP-ROUTE}, p.\pageref{IP-ROUTE}).
2738 ARP on all the IP devices.
2774 parameters other than these (IP/IPv6 address and optional device).
2783 of the IP address space into other ones. Linux-2.2 route NAT is supposed
2807 through its data and mangling it. It mangles IP addresses,
2808 only IP addresses and nothing but IP addresses.
2831 (sec.\ref{IP-ROUTE-ADD}, p.\pageref{IP-ROUTE-ADD}). F.e.\
2854 policy rule (sec.\ref{IP-RULE-ADD}, p.\pageref{IP-RULE-ADD}):
2877 example from sec.\ref{IP-RULE-SHOW} (p.\pageref{IP-RULE-SHOW}).
2906 setup of IP (and IPv6, if it is compiled into the kernel)
2934 \# \$1 --- Static IP address, optionally followed by prefix length.\\
2943 \# Parse IP address, splitting prefix length.
2991 \# IP still needs some static preconfigured address.
3002 \# {\bf Step 2} --- IP Duplicate Address Detection~\cite{RFC-DHCP}.\\
3079 namely, IP address management. It not only adds
3096 \# ---IP address, optionally followed by prefix length.\\
3155   echo "       stop - completely disable IP" 1>&2
3195     echo "$1 is bad IP address." 1>&2
3247 \# {\bf Step 1} --- IP Duplicate Address Detection~\cite{RFC-DHCP}.\\