From: nick black <dankamongmen@gmail.com>
To: Andreas Henriksson <andreas@fatal.se>
Cc: Stephen Hemminger <shemminger@vyatta.com>, netdev@vger.kernel.org
Subject: Re: Bug#656585: iproute: "ip l" fails with RTNETLINK message
Date: Fri, 20 Jan 2012 11:52:19 -0500 [thread overview]
Message-ID: <20120120165219.GA21936@qemfd.net> (raw)
In-Reply-To: <20120120145054.GA8443@amd64.fatal.se>
[-- Attachment #1: Type: text/plain, Size: 3106 bytes --]
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.
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),
--
nick black <nickblack@linux.com>
"if you want to make an apple pie from scratch,
you need to first invent a universe."
[-- Attachment #2: iproute-20120105.manpage-less-shitty.diff --]
[-- Type: text/x-diff, Size: 1797 bytes --]
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),
next parent reply other threads:[~2012-01-20 16:52 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <20120120101233.17696.79723.reportbug@localhost>
[not found] ` <20120120131047.GA7179@amd64.fatal.se>
[not found] ` <20120120143922.GA20128@qemfd.net>
[not found] ` <20120120145054.GA8443@amd64.fatal.se>
2012-01-20 16:52 ` nick black [this message]
2012-01-20 20:34 ` Bug#656585: iproute: "ip l" fails with RTNETLINK message Stephen Hemminger
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20120120165219.GA21936@qemfd.net \
--to=dankamongmen@gmail.com \
--cc=andreas@fatal.se \
--cc=netdev@vger.kernel.org \
--cc=shemminger@vyatta.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).