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