Milton Miller <milt...@bga.com> writes: > [adding Rob as Doc maintanier] > > On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote: >> Borislav Petkov <b...@alien8.de> writes: >> >> > On Fri, Jul 27, 2012 at 11:24:53AM +0200, Dirk Gouders wrote: >> >> Cong Wang <xiyou.wangc...@gmail.com> writes: >> >> >> >> > On Fri, Jul 27, 2012 at 2:35 PM, Dirk Gouders >> >> > <goud...@et.bocholt.fh-gelsenkirchen.de> wrote: >> >> >> Hi Jesse, >> >> >> >> >> >> I would like to ask you to check if the documentation of "nc" in >> >> >> netconsole.txt is still correct. I tried two different netcat packages >> >> >> and both require "-p" to specify the listening port. I am wondering if >> >> >> that changed after the use of "nc" has been documented. >> >> > >> >> > On Fedora 16, `nc -u -l <port number>` works fine. >> >> >> >> Thanks for checking that. >> >> >> >> If the information I found is correct, Fedora uses OpenBSD's nc >> >> codebase. The two netcat packages I tested on a Gentoo system differ in >> >> requiring the -p switch for the port specification. >> > >> > So say exactly that in the doc: that the *BSD's version of nc doesn't >> > need the port number specified with '-p' and you're covered. >> OK, I tried that in the attached patch. >> I'm not sure if every exeption needs to/should be documented, though. >> >> >From 3cdeac3e814471053129145c5fa8391acb365fd8 Mon Sep 17 00:00:00 2001 >> From: Dirk Gouders <goud...@et.bocholt.fh-gelsenkirchen.de> >> Date: Sat, 28 Jul 2012 12:32:49 +0200 >> Subject: [PATCH] netconsole.txt: non-BSD versions of nc(1) require '-p' >> switch >> >> Gentoo for example uses non-BSD versions of nc(1) which require >> the '-p' switch to specify the listening port. >> >> --- >> Documentation/networking/netconsole.txt | 3 ++- >> 1 files changed, 2 insertions(+), 1 deletions(-) >> >> diff --git a/Documentation/networking/netconsole.txt >> b/Documentation/networking/netconsole.txt >> index 8d02207..9a362f8 100644 >> --- a/Documentation/networking/netconsole.txt >> +++ b/Documentation/networking/netconsole.txt >> @@ -52,7 +52,8 @@ initialized and attempts to bring up the supplied dev at >> the supplied >> address. >> >> The remote host can run either 'netcat -u -l -p <port>', > > So the above line shows usage with -p > >> -'nc -l -u <port>' or syslogd. >> +'nc -l -u <port>' (BSD version of nc(1) e.g. Fedora), > > now you add a comment about BSD and say Fedora which is not obviously > BSD (this is Documentation; reading the git history for clarification > is not approprate).
Thanks for your comments. Perhaps I should have written "(BSD version of nc(1) which is used on Fedora, for example)" >> +'nc -l -u -p <port>' or syslogd. > > And now you add the original -p which you probably skipped over > since it was on the previous line? Well, this has been intentionally. Probably this is because of the Gentoo system I use as a reference. It offers three netcat packages, one is "gnu-netcat" which provides /usr/bin/netcat, the other two are "netcat" and "netcat6", both of which provide /usr/bin/nc (those packages cannot be installed at the same time). All of these netcat implementations require the '-p' switch. I will check other distributions to see what netcat implementations they provide; probably Gentoo is an exception in which case it might be overdone to change the documentation for that special case... Dirk > >> >> Dynamic reconfiguration: >> ======================== > > milton -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
