{"id":3487,"date":"2022-12-20T17:08:48","date_gmt":"2022-12-20T20:08:48","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/ip-man8\/"},"modified":"2022-12-20T17:08:48","modified_gmt":"2022-12-20T20:08:48","slug":"ip-man8","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/ip-man8\/","title":{"rendered":"IP (man8)"},"content":{"rendered":"

IP<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
OPTIONS<\/a>
IP – COMMAND SYNTAX<\/a>
ENVIRONMENT<\/a>
EXIT STATUS<\/a>
EXAMPLES<\/a>
HISTORY<\/a>
SEE ALSO<\/a>
REPORTING BUGS<\/a>
AUTHOR<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

ip \u2212 show \/ manipulate routing, network devices, interfaces and tunnels<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

ip<\/b> [ OPTIONS<\/i> ] OBJECT<\/i> { COMMAND<\/i> | help<\/b> }<\/p>\n

ip<\/b> [ -force<\/b> ] -batch<\/b> filename<\/i><\/p>\n

OBJECT<\/i> := { link<\/b> | address<\/b> | addrlabel<\/b> | route<\/b> | rule<\/b> | neigh<\/b> | ntable<\/b> | tunnel<\/b> | tuntap<\/b> | maddress<\/b> | mroute<\/b> | mrule<\/b> | monitor<\/b> | xfrm<\/b> | netns<\/b> | l2tp<\/b> | tcp_metrics<\/b> | token<\/b> | macsec<\/b> | vrf<\/b> | mptcp<\/b> | ioam<\/b> }<\/p>\n

OPTIONS<\/i> := { \u2212V<\/b>[ersion<\/i>] | \u2212h<\/b>[uman-readable<\/i>] | \u2212s<\/b>[tatistics<\/i>] | \u2212d<\/b>[etails<\/i>] | \u2212r<\/b>[esolve<\/i>] | \u2212iec<\/b> | \u2212f<\/b>[amily<\/i>] { inet<\/b> | inet6<\/b> | link<\/b> } | -4<\/b> | -6<\/b> | -B<\/b> | -0<\/b> | -l<\/b>[oops<\/i>] { maximum-addr-flush-attempts<\/b> } | \u2212o<\/b>[neline<\/i>] | \u2212rc<\/b>[vbuf<\/i>] [size<\/b>] | \u2212t<\/b>[imestamp<\/i>] | \u2212ts<\/b>[hort<\/i>] | \u2212n<\/b>[etns<\/i>] name | \u2212N<\/b>[umeric<\/i>] | \u2212a<\/b>[ll<\/i>] | \u2212c<\/b>[olor<\/i>] | \u2212br<\/b>[ief<\/i>] | \u2212j<\/b>[son] | \u2212p<\/b>[retty] }<\/p>\n

OPTIONS <\/a> <\/h2>\n

\u2212V<\/b>, -Version<\/b><\/p>\n

Print the version of the ip<\/b> utility and exit.<\/p>\n

\u2212h<\/b>, \u2212human<\/b>, \u2212human-readable<\/b><\/p>\n

output statistics with human readable values followed by suffix.<\/p>\n

\u2212b<\/b>, \u2212batch<\/b> <\/p>\n

Read commands from provided file or standard input and invoke them. First failure will cause termination of ip.<\/p>\n\n\n
<\/td>\n\n

\u2212force<\/b><\/p>\n<\/td>\n

<\/td>\n\n

Don\u2019t terminate ip on errors in batch mode. If there were any errors during execution of the commands, the application return code will be non zero.<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212s<\/b>, \u2212stats<\/b>, \u2212statistics<\/b><\/p>\n

Output more information. If the option appears twice or more, the amount of information increases. As a rule, the information is statistics or some time values.<\/p>\n

\u2212d<\/b>, \u2212details<\/b><\/p>\n

Output more detailed information.<\/p>\n

\u2212l<\/b>, \u2212loops<\/b> <\/p>\n

Specify maximum number of loops the \u2019ip address flush\u2019 logic will attempt before giving up. The default is 10. Zero (0) means loop until all addresses are removed.<\/p>\n

\u2212f<\/b>, \u2212family<\/b> <\/p>\n

Specifies the protocol family to use. The protocol family identifier can be one of inet<\/b>, inet6<\/b>, bridge<\/b>, mpls<\/b> or link<\/b>. If this option is not present, the protocol family is guessed from other arguments. If the rest of the command line does not give enough information to guess the family, ip<\/b> falls back to the default one, usually inet<\/b> or any<\/b>. link<\/b> is a special family identifier meaning that no networking protocol is involved.<\/p>\n\n\n\n\n\n\n
<\/td>\n\n

\u22124<\/b><\/p>\n<\/td>\n

<\/td>\n\n

shortcut for -family inet<\/b>.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u22126<\/b><\/p>\n<\/td>\n

<\/td>\n\n

shortcut for \u2212family inet6<\/b>.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2212B<\/b><\/p>\n<\/td>\n

<\/td>\n\n

shortcut for \u2212family bridge<\/b>.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u2212M<\/b><\/p>\n<\/td>\n

<\/td>\n\n

shortcut for \u2212family mpls<\/b>.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

\u22120<\/b><\/p>\n<\/td>\n

<\/td>\n\n

shortcut for \u2212family link<\/b>.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

\u2212o<\/b>, \u2212oneline<\/b><\/p>\n

output each record on a single line, replacing line feeds with the \u2019\u2019<\/b> character. This is convenient when you want to count records with wc<\/b>(1) or to grep<\/b>(1) the output.<\/p>\n

\u2212r<\/b>, \u2212resolve<\/b><\/p>\n

use the system\u2019s name resolver to print DNS names instead of host addresses.<\/p>\n

\u2212n<\/b>, \u2212netns<\/b> <\/p>\n

switches ip<\/b> to the specified network namespace NETNS<\/i>. Actually it just simplifies executing of:<\/p>\n

ip netns exec<\/b> NETNS<\/i> ip<\/b> [ OPTIONS<\/i> ] OBJECT<\/i> { COMMAND<\/i> | help<\/b> }<\/p>\n

to<\/p>\n

ip<\/b> -n[etns] NETNS<\/i> [ OPTIONS<\/i> ] OBJECT<\/i> { COMMAND<\/i> | help<\/b> }<\/p>\n

\u2212N<\/b>, \u2212Numeric<\/b><\/p>\n

Print the number of protocol, scope, dsfield, etc directly instead of converting it to human readable name.<\/p>\n

\u2212a<\/b>, \u2212all<\/b><\/p>\n

executes specified command over all objects, it depends if command supports this option.<\/p>\n

\u2212c<\/b>[color<\/b>][=<\/b>{always<\/b>|auto<\/b>|never<\/b>}<\/p>\n

Configure color output. If parameter is omitted or always<\/b>, color output is enabled regardless of stdout state. If parameter is auto<\/b>, stdout is checked to be a terminal before enabling color output. If parameter is never<\/b>, color output is disabled. If specified multiple times, the last one takes precedence. This flag is ignored if \u2212json<\/b> is also given.<\/p>\n

Used color palette can be influenced by COLORFGBG<\/b> environment variable (see ENVIRONMENT<\/b>).<\/p>\n

\u2212t<\/b>, \u2212timestamp<\/b><\/p>\n

display current time when using monitor option.<\/p>\n

\u2212ts<\/b>, \u2212tshort<\/b><\/p>\n

Like \u2212timestamp<\/b>, but use shorter format.<\/p>\n

\u2212rc<\/b>, \u2212rcvbuf<\/b><\/p>\n

Set the netlink socket receive buffer size, defaults to 1MB.<\/p>\n\n\n
<\/td>\n\n

\u2212iec<\/b><\/p>\n<\/td>\n

<\/td>\n\n

print human readable rates in IEC units (e.g. 1Ki = 1024).<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

\u2212br<\/b>, \u2212brief<\/b><\/p>\n

Print only basic information in a tabular format for better readability. This option is currently only supported by ip addr show<\/b> , ip link show<\/b> & ip neigh show<\/b> commands.<\/p>\n

\u2212j<\/b>, \u2212json<\/b><\/p>\n

Output results in JavaScript Object Notation (JSON).<\/p>\n

\u2212p<\/b>, \u2212pretty<\/b><\/p>\n

The default JSON format is compact and more efficient to parse but hard for most users to read. This flag adds indentation for readability.<\/p>\n

IP – COMMAND SYNTAX <\/a> <\/h2>\n

OBJECT<\/i>
address<\/b><\/p>\n

– protocol (IP or IPv6) address on a device.<\/p>\n

addrlabel<\/b><\/p>\n

– label configuration for protocol address selection.<\/p>\n\n\n\n\n
<\/td>\n\n

ioam<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage IOAM namespaces and IOAM schemas.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

l2tp<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– tunnel ethernet over IP (L2TPv3).<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

link<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– network device.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

maddress<\/b><\/p>\n

– multicast address.<\/p>\n

monitor<\/b><\/p>\n

– watch for netlink messages.<\/p>\n\n\n\n\n
<\/td>\n\n

mptcp<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage MPTCP path manager.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

mroute<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– multicast routing cache entry.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

mrule<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– rule in multicast routing policy database.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

neighbour<\/b><\/p>\n

– manage ARP or NDISC cache entries.<\/p>\n\n\n\n\n\n
<\/td>\n\n

netns<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage network namespaces.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

ntable<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage the neighbor cache\u2019s operation.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

route<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– routing table entry.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

rule<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– rule in routing policy database.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

tcp_metrics\/tcpmetrics<\/b><\/p>\n

– manage TCP Metrics<\/p>\n\n\n\n\n\n\n
<\/td>\n\n

token<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage tokenized interface identifiers.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

tunnel<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– tunnel over IP.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

tuntap<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage TUN\/TAP devices.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

vrf<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage virtual routing and forwarding devices.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

xfrm<\/b><\/p>\n<\/td>\n

<\/td>\n\n

– manage IPSec policies.<\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

The names of all objects may be written in full or abbreviated form, for example address<\/b> can be abbreviated as addr<\/b> or just a.<\/b><\/p>\n

COMMAND<\/i>
Specifies the action to perform on the object. The set of possible actions depends on the object type. As a rule, it is possible to add<\/b>, delete<\/b> and show<\/b> (or list<\/b> ) objects, but some objects do not allow all of these operations or have some additional commands. The help<\/b> command is available for all objects. It prints out a list of available commands and argument syntax conventions.<\/p>\n

If no command is given, some default command is assumed. Usually it is list<\/b> or, if the objects of this class cannot be listed, help<\/b>.<\/p>\n

ENVIRONMENT <\/a> <\/h2>\n

COLORFGBG<\/b><\/p>\n

If set, it\u2019s value is used for detection whether background is dark or light and use contrast colors for it.<\/p>\n

COLORFGBG environment variable usually contains either two or three values separated by semicolons; we want the last value in either case. If this value is 0-6 or 8, chose colors suitable for dark background:<\/p>\n

COLORFGBG=”;0″ ip -c a<\/p>\n

EXIT STATUS <\/a> <\/h2>\n

Exit status is 0 if command was successful, and 1 if there is a syntax error. If an error was reported by the kernel exit status is 2.<\/p>\n

EXAMPLES <\/a> <\/h2>\n

ip addr<\/p>\n

Shows addresses assigned to all network interfaces.<\/p>\n

ip neigh<\/p>\n

Shows the current neighbour table in kernel.<\/p>\n

ip link set x up<\/p>\n

Bring up interface x.<\/p>\n

ip link set x down<\/p>\n

Bring down interface x.<\/p>\n

ip route<\/p>\n

Show table routes.<\/p>\n

HISTORY <\/a> <\/h2>\n

ip<\/b> was written by Alexey N. Kuznetsov and added in Linux 2.2.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

ip-address<\/b>(8), ip-addrlabel<\/b>(8), ip-ioam<\/b>(8), ip-l2tp<\/b>(8), ip-link<\/b>(8), ip-maddress<\/b>(8), ip-monitor<\/b>(8), ip-mptcp<\/b>(8), ip-mroute<\/b>(8), ip-neighbour<\/b>(8), ip-netns<\/b>(8), ip-ntable<\/b>(8), ip-route<\/b>(8), ip-rule<\/b>(8), ip-tcp_metrics<\/b>(8), ip-token<\/b>(8), ip-tunnel<\/b>(8), ip-vrf<\/b>(8), ip-xfrm<\/b>(8)
IP Command reference ip-cref.ps<\/b><\/p>\n

REPORTING BUGS <\/a> <\/h2>\n

Report any bugs to the Network Developers mailing list <\/b> where the development and maintenance is primarily done. You do not have to be subscribed to the list to send a message there.<\/p>\n

AUTHOR <\/a> <\/h2>\n

Original Manpage by Michail Litvak <\/p>\n

\n","protected":false},"excerpt":{"rendered":"

ip \u2212 show \/ manipulate routing, network devices, interfaces and tunnels <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[5,52,609,4],"class_list":["post-3487","post","type-post","status-publish","format-standard","hentry","category-8-administracion-del-sistema","tag-5","tag-administracion","tag-ip","tag-man8"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3487","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=3487"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/3487\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=3487"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=3487"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=3487"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}