* [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set'
@ 2019-10-16 15:00 Nicolas Dichtel
2019-10-16 15:00 ` [PATCH iproute2 2/2] ip-netns.8: document target-nsid and nsid options of list-id Nicolas Dichtel
2019-10-16 20:25 ` [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set' Stephen Hemminger
0 siblings, 2 replies; 3+ messages in thread
From: Nicolas Dichtel @ 2019-10-16 15:00 UTC (permalink / raw)
To: stephen; +Cc: netdev, dsahern, Nicolas Dichtel
This is a follow up of the commit ebe3ce2fcc5f ("ipnetns: parse nsid as a
signed integer").
Signed-off-by: Nicolas Dichtel <nicolas.dichtel@6wind.com>
---
man/man8/ip-netns.8 | 3 +++
1 file changed, 3 insertions(+)
diff --git a/man/man8/ip-netns.8 b/man/man8/ip-netns.8
index 39a10e765083..961bcf03f609 100644
--- a/man/man8/ip-netns.8
+++ b/man/man8/ip-netns.8
@@ -31,6 +31,9 @@ ip-netns \- process network namespace management
.B ip netns set
.I NETNSNAME NETNSID
+.ti -8
+.IR NETNSID " := " auto " | " POSITIVE-INT
+
.ti -8
.BR "ip netns identify"
.RI "[ " PID " ]"
--
2.23.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* [PATCH iproute2 2/2] ip-netns.8: document target-nsid and nsid options of list-id
2019-10-16 15:00 [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set' Nicolas Dichtel
@ 2019-10-16 15:00 ` Nicolas Dichtel
2019-10-16 20:25 ` [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set' Stephen Hemminger
1 sibling, 0 replies; 3+ messages in thread
From: Nicolas Dichtel @ 2019-10-16 15:00 UTC (permalink / raw)
To: stephen; +Cc: netdev, dsahern, Nicolas Dichtel
This is a follow up of the commit eaefb07804a1 ("ipnetns: enable to dump
nsid conversion table").
Signed-off-by: Nicolas Dichtel <nicolas.dichtel@6wind.com>
---
man/man8/ip-netns.8 | 48 +++++++++++++++++++++++++++++++++++++++++++--
1 file changed, 46 insertions(+), 2 deletions(-)
diff --git a/man/man8/ip-netns.8 b/man/man8/ip-netns.8
index 961bcf03f609..c75917dac8b1 100644
--- a/man/man8/ip-netns.8
+++ b/man/man8/ip-netns.8
@@ -51,6 +51,7 @@ ip-netns \- process network namespace management
.ti -8
.BR "ip netns list-id"
+.RI "[ target-nsid " POSITIVE-INT " ] [ nsid " POSITIVE-INT " ]"
.SH DESCRIPTION
A network namespace is logically another copy of the network stack,
@@ -196,12 +197,28 @@ This command watches network namespace name addition and deletion events
and prints a line for each event it sees.
.TP
-.B ip netns list-id - list network namespace ids (nsid)
+.B ip netns list-id [target-nsid POSITIVE-INT] [nsid POSITIVE-INT] - list network namespace ids (nsid)
.sp
Network namespace ids are used to identify a peer network namespace. This
-command displays nsid of the current network namespace and provides the
+command displays nsids of the current network namespace and provides the
corresponding iproute2 netns name (from /var/run/netns) if any.
+The
+.B target-nsid
+option enables to display nsids of the specified network namespace instead of the current network
+namespace. This
+.B target-nsid
+is a nsid from the current network namespace.
+
+The
+.B nsid
+option enables to display only this nsid. It is a nsid from the current network namespace. In
+combination with the
+.B target-nsid
+option, it enables to convert a specific nsid from the current network namespace to a nsid of the
+.B target-nsid
+network namespace.
+
.SH EXAMPLES
.PP
ip netns list
@@ -218,6 +235,31 @@ ip netns exec vpn ip link set lo up
.RS
Bring up the loopback interface in the vpn network namespace.
.RE
+.PP
+ip netns add foo
+.br
+ip netns add bar
+.br
+ip netns set foo 12
+.br
+ip netns set bar 13
+.br
+ip -n foo netns set foo 22
+.br
+ip -n foo netns set bar 23
+.br
+ip -n bar netns set foo 32
+.br
+ip -n bar netns set bar 33
+.br
+ip netns list-id target-nsid 12
+.RS
+Shows the list of nsids from the network namespace foo.
+.RE
+ip netns list-id target-nsid 12 nsid 13
+.RS
+Get nsid of bar from the network namespace foo (result is 23).
+.RE
.SH SEE ALSO
.br
@@ -225,3 +267,5 @@ Bring up the loopback interface in the vpn network namespace.
.SH AUTHOR
Original Manpage by Eric W. Biederman
+.br
+Manpage revised by Nicolas Dichtel <nicolas.dichtel@6wind.com>
--
2.23.0
^ permalink raw reply related [flat|nested] 3+ messages in thread
* Re: [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set'
2019-10-16 15:00 [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set' Nicolas Dichtel
2019-10-16 15:00 ` [PATCH iproute2 2/2] ip-netns.8: document target-nsid and nsid options of list-id Nicolas Dichtel
@ 2019-10-16 20:25 ` Stephen Hemminger
1 sibling, 0 replies; 3+ messages in thread
From: Stephen Hemminger @ 2019-10-16 20:25 UTC (permalink / raw)
To: Nicolas Dichtel; +Cc: netdev, dsahern
On Wed, 16 Oct 2019 17:00:51 +0200
Nicolas Dichtel <nicolas.dichtel@6wind.com> wrote:
> This is a follow up of the commit ebe3ce2fcc5f ("ipnetns: parse nsid as a
> signed integer").
>
> Signed-off-by: Nicolas Dichtel <nicolas.dichtel@6wind.com>
Thank you for following up.
Applied
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2019-10-16 20:25 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2019-10-16 15:00 [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set' Nicolas Dichtel
2019-10-16 15:00 ` [PATCH iproute2 2/2] ip-netns.8: document target-nsid and nsid options of list-id Nicolas Dichtel
2019-10-16 20:25 ` [PATCH iproute2 1/2] ip-netns.8: document the 'auto' keyword of 'ip netns set' Stephen Hemminger
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).