Re: [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port

[Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>]

Borislav Petkov <bp@alien8.de> writes:

> On Fri, Jul 27, 2012 at 11:24:53AM +0200, Dirk Gouders wrote:
>> Cong Wang <xiyou.wangcong@gmail.com> writes:
>> 
>> > On Fri, Jul 27, 2012 at 2:35 PM, Dirk Gouders
>> > <gouders@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.

Dirk

>From 3cdeac3e814471053129145c5fa8391acb365fd8 Mon Sep 17 00:00:00 2001
From: Dirk Gouders <gouders@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>',
-'nc -l -u <port>' or syslogd.
+'nc -l -u <port>' (BSD version of nc(1) e.g. Fedora),
+'nc -l -u -p <port>' or syslogd.
 
 Dynamic reconfiguration:
 ========================
-- 
1.7.8.6