From patchwork Fri Jan 20 16:52:19 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: nick black X-Patchwork-Id: 137041 X-Patchwork-Delegate: shemminger@vyatta.com Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 39CCF1007D1 for ; Sat, 21 Jan 2012 03:52:26 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753076Ab2ATQwZ (ORCPT ); Fri, 20 Jan 2012 11:52:25 -0500 Received: from mail-gy0-f174.google.com ([209.85.160.174]:57298 "EHLO mail-gy0-f174.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752509Ab2ATQwW (ORCPT ); Fri, 20 Jan 2012 11:52:22 -0500 Received: by ghbg18 with SMTP id g18so344730ghb.19 for ; Fri, 20 Jan 2012 08:52:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:in-reply-to:user-agent; bh=fJsKIL46+syRXj4FP//K/KtNpzjo9NQ64sjL6eQXaZI=; b=FiQvsLngjaG/pKnydMxKXR32E+HlT8iujHX+vRlUhZqHqE65Ft77ZjcOwzpj02xfOI epbl6yfQf+FAJOf/atgOSIb5bOJ68o5KKW+Pj0gcCtZnt2rlQZLjMmPj+vsxdNZctVB2 w2lnyf5MgURI8/dp2UucAYuBbElqiPlMnBMu0= Received: by 10.236.141.37 with SMTP id f25mr48302724yhj.3.1327078342391; Fri, 20 Jan 2012 08:52:22 -0800 (PST) Received: from vps.qemfd.net (dank.qemfd.net. [173.230.130.29]) by mx.google.com with ESMTPS id i50sm6050007yhk.11.2012.01.20.08.52.21 (version=TLSv1/SSLv3 cipher=OTHER); Fri, 20 Jan 2012 08:52:21 -0800 (PST) Received: from recombinator.qemfd.net (localhost.localdomain [127.0.0.1]) by vps.qemfd.net (Postfix) with ESMTP id 05C182B219; Fri, 20 Jan 2012 10:52:20 -0600 (CST) Received: by recombinator.qemfd.net (Postfix, from userid 1000) id E259C1FAED; Fri, 20 Jan 2012 11:52:19 -0500 (EST) Date: Fri, 20 Jan 2012 11:52:19 -0500 From: nick black To: Andreas Henriksson Cc: Stephen Hemminger , netdev@vger.kernel.org Subject: Re: Bug#656585: iproute: "ip l" fails with RTNETLINK message Message-ID: <20120120165219.GA21936@qemfd.net> References: <20120120101233.17696.79723.reportbug@localhost> <20120120131047.GA7179@amd64.fatal.se> <20120120143922.GA20128@qemfd.net> <20120120145054.GA8443@amd64.fatal.se> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20120120145054.GA8443@amd64.fatal.se> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org 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 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),