[PATCH iproute2] man ip-link: Add notice about local netns devices

Subsystems: the rest

STALE4257d

2 messages, 2 authors, 2015-02-28 · open the first message on its own page

[PATCH iproute2] man ip-link: Add notice about local netns devices

From: Vadim Kochan <hidden>
Date: 2015-02-25 13:57:45

From: Vadim Kochan <redacted>

Added some clarification why 'ip link set netns' can not
change network namespace for some kind of devices.

Signed-off-by: Vadim Kochan <redacted>
---
 man/man8/ip-link.8.in | 29 ++++++++++++++++++++++-------
 1 file changed, 22 insertions(+), 7 deletions(-)
diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in
index 057125b..5102f75 100644
--- a/man/man8/ip-link.8.in
+++ b/man/man8/ip-link.8.in
@@ -660,14 +660,29 @@ the interface is
 .IR "POINTOPOINT" .
 
 .TP
-.BI netns " PID"
-move the device to the network namespace associated with the process
-.IR "PID".
-
-.TP
-.BI netns " NETNSNAME"
+.BI netns " NETNSNAME " \fR| " PID"
 move the device to the network namespace associated with name
-.IR "NETNSNAME".
+.IR "NETNSNAME " or
+.RI process " PID".
+
+Some devices are not allowed to change network namespace: loopback, bridge,
+ppp, wireless. These are network namespace local devices. In such case
+.B ip
+tool will return "Invalid argument" error. It is possible to find out if device is local
+to a single network namespace by checking
+.B netns-local
+flag in the output of the
+.BR ethtool ":"
+
+.in +8
+.B ethtool -k
+.I DEVICE
+.in -8
+
+To change network namespace for wireless devices the
+.B iw
+tool can be used. But it allows to change network namespace only for physical devices and by process
+.IR PID .
 
 .TP
 .BI alias " NAME"
-- 
2.2.2

Re: [PATCH iproute2] man ip-link: Add notice about local netns devices

From: Stephen Hemminger <stephen@networkplumber.org>
Date: 2015-02-28 03:02:38

On Wed, 25 Feb 2015 15:46:22 +0200
Vadim Kochan [off-list ref] wrote:
From: Vadim Kochan <redacted>

Added some clarification why 'ip link set netns' can not
change network namespace for some kind of devices.

Signed-off-by: Vadim Kochan <redacted>
Applied
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help