1 .TH IP\-LINK 8 "13 Dec 2012" "iproute2" "Linux"
3 ip-link \- network device configuration
12 .RI " { " COMMAND " | "
18 \fB\-V\fR[\fIersion\fR] |
19 \fB\-s\fR[\fItatistics\fR] |
20 \fB\-r\fR[\fIesolve\fR] |
21 \fB\-f\fR[\fIamily\fR] {
22 .BR inet " | " inet6 " | " ipx " | " dnet " | " link " } | "
23 \fB\-o\fR[\fIneline\fR] }
68 .BI "ip link delete " DEVICE
76 .RB "} { " up " | " down " | " arp " { " on " | " off " } |"
78 .BR promisc " { " on " | " off " } |"
80 .BR allmulticast " { " on " | " off " } |"
82 .BR dynamic " { " on " | " off " } |"
84 .BR multicast " { " on " | " off " } |"
116 .IR VLAN-QOS " ] ] ["
119 .B spoofchk { on | off }
131 .RI "[ " DEVICE " | "
136 .SS ip link add - add virtual link
140 specifies the physical device to act operate on.
143 specifies the name of the new virtual device.
146 specifies the type of the new device.
152 - Ethernet Bridge device
155 - Controller Area Network interface
158 - Dummy network interface
161 - Intermediate Functional Block device
164 - IP over Infiniband device
167 - Virtual interface base on link layer address (MAC)
170 - Virtual Local CAN interface
173 - Virtual ethernet interface
176 - 802.1q tagged virtual LAN interface
179 - Virtual eXtended LAN
182 - Virtual tunnel interface IPv4|IPv6 over IPv6
185 - Virtual tunnel interface IPv4 over IPv4
188 - Virtual tunnel interface IPv6 over IPv4
192 .BI numtxqueues " QUEUE_COUNT "
193 specifies the number of transmit queues for new device.
196 .BI numrxqueues " QUEUE_COUNT "
197 specifies the number of receive queues for new device.
203 the following additional arguments are supported:
205 .BI "ip link add " DEVICE
206 .BI type " vxlan " id " ID
234 - specifies the VXLAN Network Identifer (or VXLAN Segment
238 - specifies the physical device to use for tunnel endpoint communication.
242 - specifies the multicast IP address to join.
246 - specifies the source IP address to use in outgoing packets.
250 - specifies the TTL value to use in outgoing packets.
254 - specifies the TOS value to use in outgoing packets.
258 - specifies the range of port numbers to use as UDP
259 source ports to communicate to the remote VXLAN tunnel endpoint.
263 - specifies if unknown source link layer addresses and IP addresses
264 are entered into the VXLAN device forwarding database.
268 - specifies if route short circuit is turned on.
272 - specifies ARP proxy is turned on.
276 - specifies if netlink LLADDR miss notifications are generated.
280 - specifies if netlink IP ADDR miss notifications are generated.
284 .SS ip link delete - delete virtual link
286 specifies the virtual device to act operate on.
288 specifies the type of the device.
293 specifies the physical device to act operate on.
295 .SS ip link set - change device attributes
300 specifies network device to operate on. When configuring SR-IOV Virtual Function
301 (VF) devices, this keyword should specify the associated Physical Function (PF)
307 has a dual role: If both group and dev are present, then move the device to the
308 specified group. If only a group is specified, then the command operates on
309 all devices in that group.
313 change the state of the device to
319 .BR "arp on " or " arp off"
325 .BR "multicast on " or " multicast off"
331 .BR "dynamic on " or " dynamic off"
338 change the name of the device. This operation is not
339 recommended if the device is running or has some addresses
343 .BI txqueuelen " NUMBER"
346 change the transmit queue length of the device.
355 .BI address " LLADDRESS"
356 change the station address of the interface.
359 .BI broadcast " LLADDRESS"
363 .BI peer " LLADDRESS"
364 change the link layer broadcast address or the peer address when
370 move the device to the network namespace associated with the process
374 .BI netns " NETNSNAME"
375 move the device to the network namespace associated with name
380 give the device a symbolic name for easy reference.
384 specify the group the device belongs to.
385 The available groups are listed in file
386 .BR "@SYSCONFDIR@/group" .
390 specify a Virtual Function device to be configured. The associated PF device
391 must be specified using the
397 - change the station address for the specified VF. The
399 parameter must be specified.
403 - change the assigned VLAN for the specified VF. When specified, all traffic
404 sent from the VF will be tagged with the specified VLAN ID. Incoming traffic
405 will be filtered for the specified VLAN ID, and will have all VLAN tags
406 stripped before being passed to the VF. Setting this parameter to 0 disables
407 VLAN tagging and filtering. The
409 parameter must be specified.
413 - assign VLAN QOS (priority) bits for the VLAN tag. When specified, all VLAN
414 tags transmitted by the VF will include the specified priority bits in the
415 VLAN tag. If not specified, the value is assumed to be 0. Both the
419 parameters must be specified. Setting both
423 as 0 disables VLAN tagging and filtering for the VF.
427 - change the allowed transmit bandwidth, in Mbps, for the specified VF.
428 Setting this parameter to 0 disables rate limiting. The
430 parameter must be specified.
433 .BI spoofchk " on|off"
434 - turn packet spoof checking on or off for the specified VF.
439 set master device of the device (enslave device).
443 unset master device of the device (release device).
447 If multiple parameter changes are requested,
449 aborts immediately after any of the changes have failed.
450 This is the only case when
452 can move the system to an unpredictable state. The solution
453 is to avoid changing several parameters with one
457 .SS ip link show - display device attributes
460 .BI dev " NAME " (default)
462 specifies the network device to show.
463 If this argument is omitted all devices in the default group are listed.
468 specifies what group of devices to show.
472 only display running interfaces.
478 Shows the state of all network interfaces on the system.
481 ip link set dev ppp0 mtu 1400
483 Change the MTU the ppp0 device.
486 ip link add link eth0 name eth0.10 type vlan id 10
488 Creates a new vlan device eth0.10 on device eth0.
491 ip link delete dev eth0.10
501 Original Manpage by Michail Litvak <mci@owl.openwall.com>