1 .TH IP\-LINK 8 "20 Dec 2011" "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] }
26 .BI "ip link add link " DEVICE
46 .BR vlan " | " veth " | " vcan " | " dummy " | " ifb " | " macvlan " | " can " | " bridge " ]"
49 .BI "ip link delete " DEVICE
57 .RB "} { " up " | " down " | " arp " { " on " | " off " } |"
59 .BR promisc " { " on " | " off " } |"
61 .BR allmulticast " { " on " | " off " } |"
63 .BR dynamic " { " on " | " off " } |"
65 .BR multicast " { " on " | " off " } |"
100 .B spoofchk { on | off }
112 .RI "[ " DEVICE " | "
117 .SS ip link add - add virtual link
121 specifies the physical device to act operate on.
124 specifies the name of the new virtual device.
127 specifies the type of the new device.
133 - 802.1q tagged virtual LAN interface
136 - Virtual ethernet interface
139 - Virtual Local CAN interface
142 - Dummy network interface
145 - Intermediate Functional Block device
148 - virtual interface base on link layer address (MAC)
151 - Controller Area Network interface
154 - Ethernet Bridge device
157 .SS ip link delete - delete virtual link
159 specifies the virtual device to act operate on.
161 specifies the type of the device.
166 specifies the physical device to act operate on.
168 .SS ip link set - change device attributes
173 specifies network device to operate on. When configuring SR-IOV Virtual Fuction
174 (VF) devices, this keyword should specify the associated Physical Function (PF)
180 has a dual role: If both group and dev are present, then move the device to the
181 specified group. If only a group is specified, then the command operates on
182 all devices in that group.
186 change the state of the device to
192 .BR "arp on " or " arp off"
198 .BR "multicast on " or " multicast off"
204 .BR "dynamic on " or " dynamic off"
211 change the name of the device. This operation is not
212 recommended if the device is running or has some addresses
216 .BI txqueuelen " NUMBER"
219 change the transmit queue length of the device.
228 .BI address " LLADDRESS"
229 change the station address of the interface.
232 .BI broadcast " LLADDRESS"
236 .BI peer " LLADDRESS"
237 change the link layer broadcast address or the peer address when
243 move the device to the network namespace associated with the process
247 .BI netns " NETNSNAME"
248 move the device to the network namespace associated with name
253 give the device a symbolic name for easy reference.
257 specify the group the device belongs to.
258 The available groups are listed in file
259 .BR "/etc/iproute2/group" .
263 specify a Virtual Function device to be configured. The associated PF device
264 must be specified using the
270 - change the station address for the specified VF. The
272 parameter must be specified.
276 - change the assigned VLAN for the specified VF. When specified, all traffic
277 sent from the VF will be tagged with the specified VLAN ID. Incoming traffic
278 will be filtered for the specified VLAN ID, and will have all VLAN tags
279 stripped before being passed to the VF. Setting this parameter to 0 disables
280 VLAN tagging and filtering. The
282 parameter must be specified.
286 - assign VLAN QOS (priority) bits for the VLAN tag. When specified, all VLAN
287 tags transmitted by the VF will include the specified priority bits in the
288 VLAN tag. If not specified, the value is assumed to be 0. Both the
292 parameters must be specified. Setting both
296 as 0 disables VLAN tagging and filtering for the VF.
300 - change the allowed transmit bandwidth, in Mbps, for the specified VF.
301 Setting this parameter to 0 disables rate limiting. The
303 parameter must be specified.
306 .BI spoofchk " on|off"
307 - turn packet spoof checking on or off for the specified VF.
312 set master device of the device (enslave device).
316 unset master device of the device (release device).
320 If multiple parameter changes are requested,
322 aborts immediately after any of the changes have failed.
323 This is the only case when
325 can move the system to an unpredictable state. The solution
326 is to avoid changing several parameters with one
330 .SS ip link show - display device attributes
333 .BI dev " NAME " (default)
335 specifies the network device to show.
336 If this argument is omitted all devices in the default group are listed.
341 specifies what group of devices to show.
345 only display running interfaces.
351 Shows the state of all network interfaces on the system.
354 ip link set dev ppp0 mtu 1400
356 Change the MTU the ppp0 device.
359 ip link add link eth0 name eth0.10 type vlan id 10
361 Creates a new vlan device eth0.10 on device eth0.
364 ip link delete dev eth0.10
374 Original Manpage by Michail Litvak <mci@owl.openwall.com>