Patchwork Bug#656585: iproute: "ip l" fails with RTNETLINK message

login
register
mail settings
Submitter nick black
Date Jan. 20, 2012, 4:52 p.m.
Message ID <20120120165219.GA21936@qemfd.net>
Download mbox | patch
Permalink /patch/137041/
State Accepted
Delegated to: stephen hemminger
Headers show

Comments

nick black - Jan. 20, 2012, 4:52 p.m.
Andreas Henriksson left as an exercise for the reader:
> Hello again!
> 
> On Fri, Jan 20, 2012 at 09:39:22AM -0500, nick black wrote:
> > I can put together a manpage patch if you'd like, but I suspect you'd rather
> > I leave it in your capable hands.
> 
> I'd very much appreciate if you'd create a patch and submit it upstream
> (Stephen Hemminger <shemminger@vyatta.com> and the netdev mailing list)
> There are many other issues with the man pages and help output that
> you are more then willing to help dig into if you have time.
> Please see http://bugs.debian.org/src:iproute for hints on where
> documentation updates are needed.

Alrightie, I did just that.

I'm in no position to write a full ip-l2tp(8) man page. I have, however:

 * synced SYNOPSIS up with current "ip help" entries
 * made SYNOPSIS conform to "ip help"'s ordering
 * synced SYNTAX up with SYNOPSIS, pulling definitions for netns and
    ntable out from beyond the realms of my ass. please verify.
 * alphabetized the SYNTAX entries
 * synced SEE ALSO up with current "dpkg -L iproute | grep 8/ip-"

Attached and inline.
stephen hemminger - Jan. 20, 2012, 8:34 p.m.
On Fri, 20 Jan 2012 11:52:19 -0500
nick black <dankamongmen@gmail.com> wrote:

> Andreas Henriksson left as an exercise for the reader:
> > Hello again!
> > 
> > On Fri, Jan 20, 2012 at 09:39:22AM -0500, nick black wrote:
> > > I can put together a manpage patch if you'd like, but I suspect you'd rather
> > > I leave it in your capable hands.
> > 
> > I'd very much appreciate if you'd create a patch and submit it upstream
> > (Stephen Hemminger <shemminger@vyatta.com> and the netdev mailing list)
> > There are many other issues with the man pages and help output that
> > you are more then willing to help dig into if you have time.
> > Please see http://bugs.debian.org/src:iproute for hints on where
> > documentation updates are needed.
> 
> Alrightie, I did just that.
> 
> I'm in no position to write a full ip-l2tp(8) man page. I have, however:
> 
>  * synced SYNOPSIS up with current "ip help" entries
>  * made SYNOPSIS conform to "ip help"'s ordering
>  * synced SYNTAX up with SYNOPSIS, pulling definitions for netns and
>     ntable out from beyond the realms of my ass. please verify.
>  * alphabetized the SYNTAX entries
>  * synced SEE ALSO up with current "dpkg -L iproute | grep 8/ip-"
> 
> Attached and inline.

Ok, applied.
--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Patch

diff -ur /home/dank/iproute-20120105/man/man8/ip.8 /home/dank/src/iproute-20120105/man/man8/ip.8
--- /home/dank/iproute-20120105/man/man8/ip.8	2012-01-05 11:34:31.000000000 -0500
+++ /home/dank/src/iproute-20120105/man/man8/ip.8	2012-01-20 11:47:12.751632078 -0500
@@ -14,7 +14,8 @@ 
 .ti -8
 .IR OBJECT " := { "
 .BR link " | " addr " | " addrlabel " | " route " | " rule " | " neigh " | "\
- tunnel " | " maddr " | "  mroute " }"
+ ntable " | " tunnel " | " tuntap " | " maddr " | "  mroute " | " mrule " | "\
+ monitor " | " xfrm " | " netns " | "  l2tp " }"
 .sp
 
 .ti -8
@@ -103,10 +104,6 @@ 
 .I OBJECT
 
 .TP
-.B link
-- network device.
-
-.TP
 .B address
 - protocol (IP or IPv6) address on a device.
 
@@ -115,8 +112,40 @@ 
 - label configuration for protocol address selection.
 
 .TP
+.B l2tp
+- tunnel PPP over IP (L2TP).
+
+.TP
+.B link
+- network device.
+
+.TP
+.B maddress
+- multicast address.
+
+.TP
+.B monitor
+- watch for netlink messages.
+
+.TP
+.B mroute
+- multicast routing cache entry.
+
+.TP
+.B mrule
+- rule in multicast routing policy database.
+
+.TP
 .B neighbour
-- ARP or NDISC cache entry.
+- manage ARP or NDISC cache entries.
+
+.TP
+.B netns
+- manage network namespaces.
+
+.TP
+.B ntable
+- manage the neighbor cache's operation.
 
 .TP
 .B route
@@ -127,16 +156,16 @@ 
 - rule in routing policy database.
 
 .TP
-.B maddress
-- multicast address.
+.B tunnel
+- tunnel over IP.
 
 .TP
-.B mroute
-- multicast routing cache entry.
+.B tuntap
+- manage TUN/TAP devices.
 
 .TP
-.B tunnel
-- tunnel over IP.
+.B xfrm
+- manage IPSec policies.
 
 .PP
 The names of all objects may be written in full or
@@ -181,6 +210,7 @@ 
 .BR ip-monitor (8),
 .BR ip-mroute (8),
 .BR ip-neighbour (8),
+.BR ip-netns (8),
 .BR ip-ntable (8),
 .BR ip-route (8),
 .BR ip-rule (8),