man/man8/ip-link.8.in

   1 .TH IP\-LINK 8 "13 Dec 2012" "iproute2" "Linux"
   2 .SH "NAME"
   3 ip-link \- network device configuration
   4 .SH "SYNOPSIS"
   5 .sp
   6 .ad l
   7 .in +8
   8 .ti -8
   9 .B ip
  10 .RI "[ " OPTIONS " ]"
  11 .B link
  12 .RI  " { " COMMAND " | "
  13 .BR help " }"
  14 .sp
  15
  16 .ti -8
  17 .IR OPTIONS " := { "
  18 \fB\-V\fR[\fIersion\fR] |
  19 \fB\-h\fR[\fIuman-readable\fR] |
  20 \fB\-s\fR[\fItatistics\fR] |
  21 \fB\-r\fR[\fIesolve\fR] |
  22 \fB\-f\fR[\fIamily\fR] {
  23 .BR inet " | " inet6 " | " ipx " | " dnet " | " link " } | "
  24 \fB\-o\fR[\fIneline\fR] }
  25
  26 .ti -8
  27 .BI "ip link add"
  28 .RB "[ " link
  29 .IR DEVICE " ]"
  30 .RB "[ " name " ]"
  31 .I NAME
  32 .br
  33 .RB "[ " txqueuelen
  34 .IR PACKETS " ]"
  35 .br
  36 .RB "[ " address
  37 .IR LLADDR " ]"
  38 .RB "[ " broadcast
  39 .IR LLADDR " ]"
  40 .br
  41 .RB "[ " mtu
  42 .IR MTU " ]"
  43 .RB "[ " index
  44 .IR IDX " ]"
  45 .br
  46 .RB "[ " numtxqueues
  47 .IR QUEUE_COUNT " ]"
  48 .RB "[ " numrxqueues
  49 .IR QUEUE_COUNT " ]"
  50 .br
  51 .BR type " TYPE"
  52 .RI "[ " ARGS " ]"
  53
  54 .ti -8
  55 .IR TYPE " := [ "
  56 .BR bridge " | "
  57 .BR bond " | "
  58 .BR can " | "
  59 .BR dummy " | "
  60 .BR hsr " | "
  61 .BR ifb " | "
  62 .BR ipoib " |"
  63 .BR macvlan  " | "
  64 .BR macvtap  " | "
  65 .BR vcan " | "
  66 .BR veth " | "
  67 .BR vlan " | "
  68 .BR vxlan " |"
  69 .BR ip6tnl " |"
  70 .BR ipip " |"
  71 .BR sit " |"
  72 .BR gre " |"
  73 .BR gretap " |"
  74 .BR ip6gre " |"
  75 .BR ip6gretap " ]"
  76
  77 .ti -8
  78 .BI "ip link delete " DEVICE
  79 .BI type " TYPE"
  80 .RI "[ " ARGS " ]"
  81
  82 .ti -8
  83 .BR "ip link set " {
  84 .IR DEVICE " | "
  85 .BI "group " GROUP
  86 .RB "} { " up " | " down " | " arp " { " on " | " off " } |"
  87 .br
  88 .BR promisc " { " on " | " off " } |"
  89 .br
  90 .BR allmulticast " { " on " | " off " } |"
  91 .br
  92 .BR dynamic " { " on " | " off " } |"
  93 .br
  94 .BR multicast " { " on " | " off " } |"
  95 .br
  96 .B  txqueuelen
  97 .IR PACKETS " |"
  98 .br
  99 .B  name
 100 .IR NEWNAME " |"
 101 .br
 102 .B  address
 103 .IR LLADDR " |"
 104 .B  broadcast
 105 .IR LLADDR " |"
 106 .br
 107 .B  mtu
 108 .IR MTU " |"
 109 .br
 110 .B  netns
 111 .IR PID " |"
 112 .br
 113 .B  netns
 114 .IR NETNSNAME " |"
 115 .br
 116 .B alias
 117 .IR NAME  " |"
 118 .br
 119 .B vf
 120 .IR NUM " ["
 121 .B  mac
 122 .IR LLADDR " ] ["
 123 .B vlan
 124 .IR VLANID " [ "
 125 .B qos
 126 .IR VLAN-QOS " ] ] ["
 127 .B rate
 128 .IR TXRATE " ] ["
 129 .B max_tx_rate
 130 .IR TXRATE " ] ["
 131 .B min_tx_rate
 132 .IR TXRATE " ] ["
 133 .B spoofchk { on | off } ] [
 134 .B state { auto | enable | disable}
 135 ] |
 136 .br
 137 .B master
 138 .IR DEVICE
 139 .br
 140 .B nomaster
 141 .BR " }"
 142
 143
 144 .ti -8
 145 .B ip link show
 146 .RI "[ " DEVICE " | "
 147 .B group
 148 .IR GROUP " | "
 149 .BR up " | "
 150 .B master
 151 .IR DEVICE " | "
 152 .B type
 153 .IR TYPE " ]"
 154
 155 .ti -8
 156 .B ip link help
 157 .RI "[ " TYPE " ]"
 158
 159 .SH "DESCRIPTION"
 160 .SS ip link add - add virtual link
 161
 162 .TP
 163 .BI link " DEVICE "
 164 specifies the physical device to act operate on.
 165
 166 .I NAME
 167 specifies the name of the new virtual device.
 168
 169 .I TYPE
 170 specifies the type of the new device.
 171 .sp
 172 Link types:
 173
 174 .in +8
 175 .B bridge
 176 - Ethernet Bridge device
 177 .sp
 178 .B bond
 179 - Bonding device
 180 .sp
 181 .B dummy
 182 - Dummy network interface
 183 .sp
 184 .B hsr
 185 - High-availability Seamless Redundancy device
 186 .sp
 187 .B ifb
 188 - Intermediate Functional Block device
 189 .sp
 190 .B ipoib
 191 - IP over Infiniband device
 192 .sp
 193 .B macvlan
 194 - Virtual interface base on link layer address (MAC)
 195 .sp
 196 .B macvtap
 197 - Virtual interface based on link layer address (MAC) and TAP.
 198 .sp
 199 .B vcan
 200 - Virtual Controller Area Network interface
 201 .sp
 202 .B veth
 203 - Virtual ethernet interface
 204 .sp
 205 .BR vlan
 206 - 802.1q tagged virtual LAN interface
 207 .sp
 208 .BR vxlan
 209 - Virtual eXtended LAN
 210 .sp
 211 .BR ip6tnl
 212 - Virtual tunnel interface IPv4|IPv6 over IPv6
 213 .sp
 214 .BR ipip
 215 - Virtual tunnel interface IPv4 over IPv4
 216 .sp
 217 .BR sit
 218 - Virtual tunnel interface IPv6 over IPv4
 219 .sp
 220 .BR gre
 221 - Virtual tunnel interface GRE over IPv4
 222 .sp
 223 .BR gretap
 224 - Virtual L2 tunnel interface GRE over IPv4
 225 .sp
 226 .BR ip6gre
 227 - Virtual tunnel interface GRE over IPv6
 228 .sp
 229 .BR ip6gretap
 230 - Virtual L2 tunnel interface GRE over IPv6
 231 .in -8
 232
 233 .TP
 234 .BI numtxqueues " QUEUE_COUNT "
 235 specifies the number of transmit queues for new device.
 236
 237 .TP
 238 .BI numrxqueues " QUEUE_COUNT "
 239 specifies the number of receive queues for new device.
 240
 241 .TP
 242 .BI index " IDX "
 243 specifies the desired index of the new virtual device. The link creation fails, if the index is busy.
 244
 245 .TP
 246 VXLAN Type Support
 247 For a link of type
 248 .I VXLAN
 249 the following additional arguments are supported:
 250
 251 .BI "ip link add " DEVICE
 252 .BI type " vxlan " id " ID"
 253 .R " [ "
 254 .BI dev " PHYS_DEV "
 255 .RB " ] [ { " group " | " remote " } "
 256 .I IPADDR
 257 .R " ] [ "
 258 .BI local " IPADDR "
 259 .R " ] [ "
 260 .BI ttl " TTL "
 261 .R " ] [ "
 262 .BI tos " TOS "
 263 .R " ] [ "
 264 .BI port " MIN MAX "
 265 .R " ] [ "
 266 .I "[no]learning "
 267 .R " ] [ "
 268 .I "[no]proxy "
 269 .R " ] [ "
 270 .I "[no]rsc "
 271 .R " ] [ "
 272 .I "[no]l2miss "
 273 .R " ] [ "
 274 .I "[no]l3miss "
 275 .R " ] [ "
 276 .BI ageing " SECONDS "
 277 .R " ] [ "
 278 .BI maxaddress " NUMBER "
 279 .R " ] [ "
 280 .B gbp
 281 .R " ]"
 282
 283 .in +8
 284 .sp
 285 .BI  id " VNI "
 286 - specifies the VXLAN Network Identifer (or VXLAN Segment
 287 Identifier) to use.
 288
 289 .BI dev " PHYS_DEV"
 290 - specifies the physical device to use for tunnel endpoint communication.
 291
 292 .sp
 293 .BI group " IPADDR"
 294 - specifies the multicast IP address to join.
 295 This parameter cannot be specified with the
 296 .B remote
 297 parameter.
 298
 299 .sp
 300 .BI remote " IPADDR"
 301 - specifies the unicast destination IP address to use in outgoing packets
 302 when the destination link layer address is not known in the VXLAN device
 303 forwarding database.  This parameter cannot be specified with the
 304 .B group
 305 parameter.
 306
 307 .sp
 308 .BI local " IPADDR"
 309 - specifies the source IP address to use in outgoing packets.
 310
 311 .sp
 312 .BI ttl " TTL"
 313 - specifies the TTL value to use in outgoing packets.
 314
 315 .sp
 316 .BI tos " TOS"
 317 - specifies the TOS value to use in outgoing packets.
 318
 319 .sp
 320 .BI port " MIN MAX"
 321 - specifies the range of port numbers to use as UDP
 322 source ports to communicate to the remote VXLAN tunnel endpoint.
 323
 324 .sp
 325 .I [no]learning
 326 - specifies if unknown source link layer addresses and IP addresses
 327 are entered into the VXLAN device forwarding database.
 328
 329 .sp
 330 .I [no]rsc
 331 - specifies if route short circuit is turned on.
 332
 333 .sp
 334 .I [no]proxy
 335 - specifies ARP proxy is turned on.
 336
 337 .sp
 338 .I [no]l2miss
 339 - specifies if netlink LLADDR miss notifications are generated.
 340
 341 .sp
 342 .I [no]l3miss
 343 - specifies if netlink IP ADDR miss notifications are generated.
 344
 345 .sp
 346 .BI ageing " SECONDS"
 347 - specifies the lifetime in seconds of FDB entries learnt by the kernel.
 348
 349 .sp
 350 .BI maxaddress " NUMBER"
 351 - specifies the maximum number of FDB entries.
 352
 353 .sp
 354 .B gbp
 355 - enables the Group Policy extension (VXLAN-GBP).
 356
 357 .in +4
 358 Allows to transport group policy context across VXLAN network peers.
 359 If enabled, includes the mark of a packet in the VXLAN header for outgoing
 360 packets and fills the packet mark based on the information found in the
 361 VXLAN header for incomming packets.
 362
 363 Format of upper 16 bits of packet mark (flags);
 364
 365 .in +2
 366 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 367 .br
 368 |-|-|-|-|-|-|-|-|-|D|-|-|A|-|-|-|
 369 .br
 370 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 371
 372 .B D :=
 373 Don't Learn bit. When set, this bit indicates that the egress
 374 VTEP MUST NOT learn the source address of the encapsulated frame.
 375
 376 .B A :=
 377 Indicates that the group policy has already been applied to
 378 this packet. Policies MUST NOT be applied by devices when the A bit is set.
 379 .in -2
 380
 381 Format of lower 16 bits of packet mark (policy ID):
 382
 383 .in +2
 384 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 385 .br
 386 |        Group Policy ID        |
 387 .br
 388 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
 389 .in -2
 390
 391 Example:
 392   iptables -A OUTPUT [...] -j MARK --set-mark 0x800FF
 393
 394 .in -4
 395
 396 .in -8
 397
 398 .TP
 399 GRE, IPIP, SIT Type Support
 400 For a link of types
 401 .I GRE/IPIP/SIT
 402 the following additional arguments are supported:
 403
 404 .BI "ip link add " DEVICE
 405 .BR type " { gre | ipip | sit } "
 406 .BI " remote " ADDR " local " ADDR
 407 .R " [ "
 408 .BR encap " { fou | gue | none } "
 409 .R " ] [ "
 410 .BI "encap-sport { " PORT " | auto } "
 411 .R " ] [ "
 412 .BI "encap-dport " PORT
 413 .R " ] [ "
 414 .I " [no]encap-csum "
 415 .R " ] [ "
 416 .I " [no]encap-remcsum "
 417 .R " ]"
 418
 419 .in +8
 420 .sp
 421 .BI  remote " ADDR "
 422 - specifies the remote address of the tunnel.
 423
 424 .sp
 425 .BI  local " ADDR "
 426 - specifies the fixed local address for tunneled packets.
 427 It must be an address on another interface on this host.
 428
 429 .sp
 430 .BR encap " { fou | gue | none } "
 431 - specifies type of secondary UDP encapsulation. "fou" indicates
 432 Foo-Over-UDP, "gue" indicates Generic UDP Encapsulation.
 433
 434 .sp
 435 .BI "encap-sport { " PORT " | auto } "
 436 - specifies the source port in UDP encapsulation.
 437 .IR PORT
 438 indicates the port by number, "auto"
 439 indicates that the port number should be chosen automatically
 440 (the kernel picks a flow based on the flow hash of the
 441 encapsulated packet).
 442
 443 .sp
 444 .I [no]encap-csum
 445 - specifies if UDP checksums are enabled in the secondary
 446 encapsulation.
 447
 448 .sp
 449 .I [no]encap-remcsum
 450 - specifies if Remote Checksum Offload is enabled. This is only
 451 applicable for Generic UDP Encapsulation.
 452
 453 .in -8
 454
 455 .TP
 456 IP6GRE/IP6GRETAP Type Support
 457 For a link of type
 458 .I IP6GRE/IP6GRETAP
 459 the following additional arguments are supported:
 460
 461 .BI "ip link add " DEVICE
 462 .BI type " { ip6gre | ip6gretap }  " remote " ADDR " local " ADDR
 463 .R " [ "
 464 .I "[i|o]seq]"
 465 .R " ] [ "
 466 .I "[i|o]key" KEY
 467 .R " ] [ "
 468 .I " [i|o]csum "
 469 .R " ] [ "
 470 .BI hoplimit " TTL "
 471 .R " ] [ "
 472 .BI encaplimit " ELIM "
 473 .R " ] [ "
 474 .BI tclass " TCLASS "
 475 .R " ] [ "
 476 .BI flowlabel " FLOWLABEL "
 477 .R " ] [ "
 478 .BI "dscp inherit"
 479 .R " ] [ "
 480 .BI dev " PHYS_DEV "
 481 .R " ]"
 482
 483 .in +8
 484 .sp
 485 .BI  remote " ADDR "
 486 - specifies the remote IPv6 address of the tunnel.
 487
 488 .sp
 489 .BI  local " ADDR "
 490 - specifies the fixed local IPv6 address for tunneled packets.
 491 It must be an address on another interface on this host.
 492
 493 .sp
 494 .BI  [i|o]seq
 495 - serialize packets.
 496 The
 497 .B oseq
 498 flag enables sequencing of outgoing packets.
 499 The
 500 .B iseq
 501 flag requires that all input packets are serialized.
 502
 503 .sp
 504 .BI  [i|o]key " KEY"
 505 - use keyed GRE with key
 506 .IR KEY ". "KEY
 507 is either a number or an IPv4 address-like dotted quad.
 508 The
 509 .B key
 510 parameter specifies the same key to use in both directions.
 511 The
 512 .BR ikey " and " okey
 513 parameters specify different keys for input and output.
 514
 515 .sp
 516 .BI  [i|o]csum
 517 - generate/require checksums for tunneled packets.
 518 The
 519 .B ocsum
 520 flag calculates checksums for outgoing packets.
 521 The
 522 .B icsum
 523 flag requires that all input packets have the correct
 524 checksum.  The
 525 .B csum
 526 flag is equivalent to the combination
 527 .BR "icsum ocsum" .
 528
 529 .sp
 530 .BI  hoplimit " TTL"
 531 - specifies Hop Limit value to use in outgoing packets.
 532
 533 .sp
 534 .BI  encaplimit " ELIM"
 535 - specifies a fixed encapsulation limit.  Default is 4.
 536
 537 .sp
 538 .BI  flowlabel " FLOWLABEL"
 539 - specifies a fixed flowlabel.
 540
 541 .sp
 542 .BI  tclass " TCLASS"
 543 - specifies the traffic class field on
 544 tunneled packets, which can be specified as either a two-digit
 545 hex value (e.g. c0) or a predefined string (e.g. internet).
 546 The value
 547 .B inherit
 548 causes the field to be copied from the original IP header. The
 549 values
 550 .BI "inherit/" STRING
 551 or
 552 .BI "inherit/" 00 ".." ff
 553 will set the field to
 554 .I STRING
 555 or
 556 .IR 00 ".." ff
 557 when tunneling non-IP packets. The default value is 00.
 558
 559 .in -8
 560
 561 .TP
 562 IPoIB Type Support
 563 For a link of type
 564 .I IPoIB
 565 the following additional arguments are supported:
 566
 567 .BI "ip link add " DEVICE " name " NAME
 568 .BI type " ipoib [ " pkey " PKEY ] [" mode " MODE " ]
 569
 570 .in +8
 571 .sp
 572 .BI  pkey " PKEY "
 573 - specifies the IB P-Key to use.
 574
 575 .BI  mode " MODE "
 576 - specifies the mode (datagram or connected) to use.
 577
 578 .SS ip link delete - delete virtual link
 579 .I DEVICE
 580 specifies the virtual  device to act operate on.
 581 .I TYPE
 582 specifies the type of the device.
 583
 584
 585 .TP
 586 .BI dev " DEVICE "
 587 specifies the physical device to act operate on.
 588
 589 .SS ip link set - change device attributes
 590
 591 .TP
 592 .BI dev " DEVICE "
 593 .I DEVICE
 594 specifies network device to operate on. When configuring SR-IOV Virtual Function
 595 (VF) devices, this keyword should specify the associated Physical Function (PF)
 596 device.
 597
 598 .TP
 599 .BI group " GROUP "
 600 .I GROUP
 601 has a dual role: If both group and dev are present, then move the device to the
 602 specified group.  If only a group is specified, then the command operates on
 603 all devices in that group.
 604
 605 .TP
 606 .BR up " and " down
 607 change the state of the device to
 608 .B UP
 609 or
 610 .BR "DOWN" .
 611
 612 .TP
 613 .BR "arp on " or " arp off"
 614 change the
 615 .B NOARP
 616 flag on the device.
 617
 618 .TP
 619 .BR "multicast on " or " multicast off"
 620 change the
 621 .B MULTICAST
 622 flag on the device.
 623
 624 .TP
 625 .BR "dynamic on " or " dynamic off"
 626 change the
 627 .B DYNAMIC
 628 flag on the device. Indicates that address can change when interface goes down (currently
 629 .B NOT
 630 used by the Linux).
 631
 632 .TP
 633 .BI name " NAME"
 634 change the name of the device.  This operation is not
 635 recommended if the device is running or has some addresses
 636 already configured.
 637
 638 .TP
 639 .BI txqueuelen " NUMBER"
 640 .TP
 641 .BI txqlen " NUMBER"
 642 change the transmit queue length of the device.
 643
 644 .TP
 645 .BI mtu " NUMBER"
 646 change the
 647 .I MTU
 648 of the device.
 649
 650 .TP
 651 .BI address " LLADDRESS"
 652 change the station address of the interface.
 653
 654 .TP
 655 .BI broadcast " LLADDRESS"
 656 .TP
 657 .BI brd " LLADDRESS"
 658 .TP
 659 .BI peer " LLADDRESS"
 660 change the link layer broadcast address or the peer address when
 661 the interface is
 662 .IR "POINTOPOINT" .
 663
 664 .TP
 665 .BI netns " NETNSNAME " \fR| " PID"
 666 move the device to the network namespace associated with name
 667 .IR "NETNSNAME " or
 668 .RI process " PID".
 669
 670 Some devices are not allowed to change network namespace: loopback, bridge,
 671 ppp, wireless. These are network namespace local devices. In such case
 672 .B ip
 673 tool will return "Invalid argument" error. It is possible to find out if device is local
 674 to a single network namespace by checking
 675 .B netns-local
 676 flag in the output of the
 677 .BR ethtool ":"
 678
 679 .in +8
 680 .B ethtool -k
 681 .I DEVICE
 682 .in -8
 683
 684 To change network namespace for wireless devices the
 685 .B iw
 686 tool can be used. But it allows to change network namespace only for physical devices and by process
 687 .IR PID .
 688
 689 .TP
 690 .BI alias " NAME"
 691 give the device a symbolic name for easy reference.
 692
 693 .TP
 694 .BI group " GROUP"
 695 specify the group the device belongs to.
 696 The available groups are listed in file
 697 .BR "@SYSCONFDIR@/group" .
 698
 699 .TP
 700 .BI vf " NUM"
 701 specify a Virtual Function device to be configured. The associated PF device
 702 must be specified using the
 703 .B dev
 704 parameter.
 705
 706 .in +8
 707 .BI mac " LLADDRESS"
 708 - change the station address for the specified VF. The
 709 .B vf
 710 parameter must be specified.
 711
 712 .sp
 713 .BI vlan " VLANID"
 714 - change the assigned VLAN for the specified VF. When specified, all traffic
 715 sent from the VF will be tagged with the specified VLAN ID. Incoming traffic
 716 will be filtered for the specified VLAN ID, and will have all VLAN tags
 717 stripped before being passed to the VF. Setting this parameter to 0 disables
 718 VLAN tagging and filtering. The
 719 .B vf
 720 parameter must be specified.
 721
 722 .sp
 723 .BI qos " VLAN-QOS"
 724 - assign VLAN QOS (priority) bits for the VLAN tag. When specified, all VLAN
 725 tags transmitted by the VF will include the specified priority bits in the
 726 VLAN tag. If not specified, the value is assumed to be 0. Both the
 727 .B vf
 728 and
 729 .B vlan
 730 parameters must be specified. Setting both
 731 .B vlan
 732 and
 733 .B qos
 734 as 0 disables VLAN tagging and filtering for the VF.
 735
 736 .sp
 737 .BI rate " TXRATE"
 738 -- change the allowed transmit bandwidth, in Mbps, for the specified VF.
 739 Setting this parameter to 0 disables rate limiting.
 740 .B vf
 741 parameter must be specified.
 742 Please use new API
 743 .B "max_tx_rate"
 744 option instead.
 745
 746 .sp
 747 .BI max_tx_rate " TXRATE"
 748 - change the allowed maximum transmit bandwidth, in Mbps, for the specified VF.
 749 .B vf
 750 parameter must be specified.
 751
 752 .sp
 753 .BI min_tx_rate " TXRATE"
 754 - change the allowed minimum transmit bandwidth, in Mbps, for the specified VF.
 755 Minimum TXRATE should be always <= Maximum TXRATE.
 756 .B vf
 757 parameter must be specified.
 758
 759 .sp
 760 .BI spoofchk " on|off"
 761 - turn packet spoof checking on or off for the specified VF.
 762 .sp
 763 .BI state " auto|enable|disable"
 764 - set the virtual link state as seen by the specified VF. Setting to auto means a
 765 reflection of the PF link state, enable lets the VF to communicate with other VFs on
 766 this host even if the PF link state is down, disable causes the HW to drop any packets
 767 sent by the VF.
 768 .in -8
 769
 770 .TP
 771 .BI master " DEVICE"
 772 set master device of the device (enslave device).
 773
 774 .TP
 775 .BI nomaster
 776 unset master device of the device (release device).
 777
 778 .PP
 779 .B Warning:
 780 If multiple parameter changes are requested,
 781 .B ip
 782 aborts immediately after any of the changes have failed.
 783 This is the only case when
 784 .B ip
 785 can move the system to an unpredictable state.  The solution
 786 is to avoid changing several parameters with one
 787 .B ip link set
 788 call.
 789
 790 .SS  ip link show - display device attributes
 791
 792 .TP
 793 .BI dev " NAME " (default)
 794 .I NAME
 795 specifies the network device to show.
 796 If this argument is omitted all devices in the default group are listed.
 797
 798 .TP
 799 .BI group " GROUP "
 800 .I GROUP
 801 specifies what group of devices to show.
 802
 803 .TP
 804 .B up
 805 only display running interfaces.
 806
 807 .TP
 808 .BI master " DEVICE "
 809 .I DEVICE
 810 specifies the master device which enslaves devices to show.
 811
 812 .TP
 813 .BI type " TYPE "
 814 .I TYPE
 815 specifies the type of devices to show.
 816
 817 .TP
 818 The show command has additional formatting options:
 819
 820 .RS
 821 .TP
 822 .BR "\-s" , " \-stats", " \-statistics"
 823 output more statistics about packet usage.
 824
 825 .TP
 826 .BR "\-d", " \-details"
 827 output more detailed information.
 828
 829 .TP
 830 .BR "\-h", " \-human", " \-human-readble"
 831 output statistics with human readable values number followed by suffix
 832
 833 .TP
 834 .BR "\-iec"
 835 print human readable rates in IEC units (ie. 1K = 1024).
 836 .RE
 837
 838 .SS  ip link help - display help
 839
 840 .PP
 841 .I "TYPE"
 842 specifies which help of link type to dislpay.
 843
 844 .SS
 845 .I GROUP
 846 may be a number or a string from the file
 847 .B /etc/iproute2/group
 848 which can be manually filled.
 849
 850 .SH "EXAMPLES"
 851 .PP
 852 ip link show
 853 .RS 4
 854 Shows the state of all network interfaces on the system.
 855 .RE
 856 .PP
 857 ip link show type bridge
 858 .RS 4
 859 Shows the bridge devices.
 860 .RE
 861 .PP
 862 ip link show type vlan
 863 .RS 4
 864 Shows the vlan devices.
 865 .RE
 866 .PP
 867 ip link show master br0
 868 .RS 4
 869 Shows devices enslaved by br0
 870 .RE
 871 .PP
 872 ip link set dev ppp0 mtu 1400
 873 .RS 4
 874 Change the MTU the ppp0 device.
 875 .RE
 876 .PP
 877 ip link add link eth0 name eth0.10 type vlan id 10
 878 .RS 4
 879 Creates a new vlan device eth0.10 on device eth0.
 880 .RE
 881 .PP
 882 ip link delete dev eth0.10
 883 .RS 4
 884 Removes vlan device.
 885 .RE
 886
 887 ip link help gre
 888 .RS 4
 889 Display help for the gre link type.
 890 .RE
 891 .PP
 892 ip link add name tun1 type ipip remote 192.168.1.1
 893 local 192.168.1.2 ttl 225 encap gue encap-sport auto
 894 encap-dport 5555 encap-csum encap-remcsum
 895 .RS 4
 896 Creates an IPIP that is encapsulated with Generic UDP Encapsulation,
 897 and the outer UDP checksum and remote checksum offload are enabled.
 898
 899 .RE
 900
 901 .SH SEE ALSO
 902 .br
 903 .BR ip (8),
 904 .BR ip-netns (8)
 905
 906 .SH AUTHOR
 907 Original Manpage by Michail Litvak <mci@owl.openwall.com>