* [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port
@ 2012-07-27 6:35 Dirk Gouders
2012-07-27 9:02 ` Cong Wang
2012-08-02 19:57 ` [RFC PATCH] " Jan Engelhardt
0 siblings, 2 replies; 17+ messages in thread
From: Dirk Gouders @ 2012-07-27 6:35 UTC (permalink / raw)
To: Jesse Barnes; +Cc: Linux Kernel
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.
Best regards,
Dirk
Signed-off-by: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
---
Documentation/networking/netconsole.txt | 2 +-
1 files changed, 1 insertions(+), 1 deletions(-)
diff --git a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
index 8d02207..ffe30a7 100644
--- a/Documentation/networking/netconsole.txt
+++ b/Documentation/networking/netconsole.txt
@@ -52,7 +52,7 @@ 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 -p <port>' or syslogd.
Dynamic reconfiguration:
========================
--
1.7.8.6
^ permalink raw reply related [flat|nested] 17+ messages in thread
* Re: [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-27 6:35 [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port Dirk Gouders
@ 2012-07-27 9:02 ` Cong Wang
2012-07-27 9:24 ` Dirk Gouders
2012-08-02 19:57 ` [RFC PATCH] " Jan Engelhardt
1 sibling, 1 reply; 17+ messages in thread
From: Cong Wang @ 2012-07-27 9:02 UTC (permalink / raw)
To: Dirk Gouders; +Cc: Jesse Barnes, Linux Kernel
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.
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-27 9:02 ` Cong Wang
@ 2012-07-27 9:24 ` Dirk Gouders
2012-07-27 13:15 ` Borislav Petkov
0 siblings, 1 reply; 17+ messages in thread
From: Dirk Gouders @ 2012-07-27 9:24 UTC (permalink / raw)
To: Cong Wang; +Cc: Jesse Barnes, Linux Kernel
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.
Dirk
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-27 9:24 ` Dirk Gouders
@ 2012-07-27 13:15 ` Borislav Petkov
2012-07-28 11:08 ` Dirk Gouders
0 siblings, 1 reply; 17+ messages in thread
From: Borislav Petkov @ 2012-07-27 13:15 UTC (permalink / raw)
To: Dirk Gouders; +Cc: Cong Wang, Jesse Barnes, Linux Kernel
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.
--
Regards/Gruss,
Boris.
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-27 13:15 ` Borislav Petkov
@ 2012-07-28 11:08 ` Dirk Gouders
2012-07-29 8:40 ` [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port, [RFC] " Milton Miller
0 siblings, 1 reply; 17+ messages in thread
From: Dirk Gouders @ 2012-07-28 11:08 UTC (permalink / raw)
To: Borislav Petkov; +Cc: Cong Wang, Jesse Barnes, Linux Kernel
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
^ permalink raw reply related [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port, [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-28 11:08 ` Dirk Gouders
@ 2012-07-29 8:40 ` Milton Miller
2012-07-29 11:52 ` Dirk Gouders
2012-08-01 14:06 ` Rob Landley
0 siblings, 2 replies; 17+ messages in thread
From: Milton Miller @ 2012-07-29 8:40 UTC (permalink / raw)
To: Dirk Gouders, Dirk Gouders
Cc: Borislav Petkov, Cong Wang, Jesse Barnes, Linux Kernel, Rob Landley
[adding Rob as Doc maintanier]
On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
> 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.
>
> >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>',
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).
> +'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?
>
> Dynamic reconfiguration:
> ========================
milton
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-29 8:40 ` [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port, [RFC] " Milton Miller
@ 2012-07-29 11:52 ` Dirk Gouders
2012-08-01 14:06 ` Rob Landley
1 sibling, 0 replies; 17+ messages in thread
From: Dirk Gouders @ 2012-07-29 11:52 UTC (permalink / raw)
To: Milton Miller
Cc: Borislav Petkov, Cong Wang, Jesse Barnes, Linux Kernel, Rob Landley
Milton Miller <miltonm@bga.com> writes:
> [adding Rob as Doc maintanier]
>
> On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
>> 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.
>>
>> >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>',
>
> 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
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-29 8:40 ` [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port, [RFC] " Milton Miller
2012-07-29 11:52 ` Dirk Gouders
@ 2012-08-01 14:06 ` Rob Landley
2012-08-01 15:46 ` Dirk Gouders
1 sibling, 1 reply; 17+ messages in thread
From: Rob Landley @ 2012-08-01 14:06 UTC (permalink / raw)
To: Milton Miller
Cc: Dirk Gouders, Borislav Petkov, Cong Wang, Jesse Barnes, Linux Kernel
On 07/29/2012 03:40 AM, Milton Miller wrote:
> [adding Rob as Doc maintanier]
>
> On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
>> 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.
>>
>> >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(-)
Did this ever resolve to a specific recommended patch? The one at the
start of the thread:
http://lkml.indiana.edu/hypermail/linux/kernel/1207.3/01995.html
Apparently isn't it...?
Rob
--
GNU/Linux isn't: Linux=GPLv2, GNU=GPLv3+, they can't share code.
Either it's "mere aggregation", or a license violation. Pick one.
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-01 14:06 ` Rob Landley
@ 2012-08-01 15:46 ` Dirk Gouders
2012-08-02 20:39 ` Dirk Gouders
0 siblings, 1 reply; 17+ messages in thread
From: Dirk Gouders @ 2012-08-01 15:46 UTC (permalink / raw)
To: Rob Landley
Cc: Milton Miller, Borislav Petkov, Cong Wang, Jesse Barnes, Linux Kernel
Rob Landley <rob@landley.net> writes:
> On 07/29/2012 03:40 AM, Milton Miller wrote:
>> [adding Rob as Doc maintanier]
>>
>> On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
>>> 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.
>>>
>>> >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(-)
>
> Did this ever resolve to a specific recommended patch? The one at the
> start of the thread:
>
> http://lkml.indiana.edu/hypermail/linux/kernel/1207.3/01995.html
>
> Apparently isn't it...?
Sorry for the delay.
I tested the situation on a few distributions and am still thinking
about a proper way to write it in a way without netconsole.txt becoming
a kind of "netcat.txt".
I would be glad about comments to what I currently have -- also, because
I am not a native English speaker:
------------------------------------------------------------------------
The remote host can run syslogd or netcat to receive the kernel
messages. On distributions using a BSD-based netcat version
(e.g. Fedora, openSUSE and Ubuntu) the listening port must be
specified without the -p switch:
'nc -u -l -p <port>' / 'nc -u -l <port>' or
'netcat -u -l -p <port>' / 'netcat -u -l <port>'
------------------------------------------------------------------------
At the end, I also attach what I have noted during the tests with the
different distributions.
Dirk
------------------------------------------------------------------------
Problem on systems where the gnu-netcat package provides a symbolic
link /usr/bin/nc -> /usr/bin/netcat:
gnu-netcat requires -p to specify the local port but does not complain
if invoked as `nc -l -u <port>'; you need to use -v to see that it
does not do what you might expect:
# nc -l -u 4444 -v
Warning: Inverse name lookup failed for `0.0.17.92'
------------------------------------------------------------------------
Distro Package needs -p
Command invocation
========================================================================
Arch gnu-netcat yes
(Website nc | netcat
documentation)
openbsd-netcat no
nc.openbsd
------------------------------------------------------------------------
Debian-6.0.5 netcat-openbsd no
nc | netcat | nc.openbsd
netcat / netcat-traditional (preinstalled) yes
nc | netcat
netcat6 yes
nc | netcat | nc6
------------------------------------------------------------------------
Fedora-17 nc (preinstalled) no
nc
nc6
nc6 yes
------------------------------------------------------------------------
Gentoo gnu-netcat yes
netcat
netcat yes
nc
netcat6 yes
nc | nc6
------------------------------------------------------------------------
OpenSUSE-12.1 netcat-openbsd no
nc | netcat
------------------------------------------------------------------------
Ubuntu-12.04 netcat-openbsd (preinstalled) no
Desktop nc | netcat | nc.openbsd
netcat / netcat-traditional yes
nc | netcat
netcat6 yes
nc | netcat | nc6
------------------------------------------------------------------------
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-07-27 6:35 [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port Dirk Gouders
2012-07-27 9:02 ` Cong Wang
@ 2012-08-02 19:57 ` Jan Engelhardt
1 sibling, 0 replies; 17+ messages in thread
From: Jan Engelhardt @ 2012-08-02 19:57 UTC (permalink / raw)
To: Dirk Gouders; +Cc: Jesse Barnes, Linux Kernel
On Friday 2012-07-27 08:35, Dirk Gouders wrote:
>diff --git a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
>index 8d02207..ffe30a7 100644
>--- a/Documentation/networking/netconsole.txt
>+++ b/Documentation/networking/netconsole.txt
>@@ -52,7 +52,7 @@ 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 -p <port>' or syslogd.
While at it, could you add
socat udp-recv:<port> -
since netcat is _really_ archaic ;-)
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-01 15:46 ` Dirk Gouders
@ 2012-08-02 20:39 ` Dirk Gouders
2012-08-02 20:41 ` Jesse Barnes
` (2 more replies)
0 siblings, 3 replies; 17+ messages in thread
From: Dirk Gouders @ 2012-08-02 20:39 UTC (permalink / raw)
To: Rob Landley
Cc: Milton Miller, Borislav Petkov, Cong Wang, Jesse Barnes,
Jan Engelhardt, Linux Kernel
Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de> writes:
> Rob Landley <rob@landley.net> writes:
>
>> On 07/29/2012 03:40 AM, Milton Miller wrote:
>>> [adding Rob as Doc maintanier]
>>>
>>> On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
>>>> 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.
>>>>
>>>> >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(-)
>>
>> Did this ever resolve to a specific recommended patch? The one at the
>> start of the thread:
>>
>> http://lkml.indiana.edu/hypermail/linux/kernel/1207.3/01995.html
>>
>> Apparently isn't it...?
>
> Sorry for the delay.
> I tested the situation on a few distributions and am still thinking
> about a proper way to write it in a way without netconsole.txt becoming
> a kind of "netcat.txt".
>
> I would be glad about comments to what I currently have -- also, because
> I am not a native English speaker:
>
> ------------------------------------------------------------------------
> The remote host can run syslogd or netcat to receive the kernel
> messages. On distributions using a BSD-based netcat version
> (e.g. Fedora, openSUSE and Ubuntu) the listening port must be
> specified without the -p switch:
>
> 'nc -u -l -p <port>' / 'nc -u -l <port>' or
> 'netcat -u -l -p <port>' / 'netcat -u -l <port>'
> ------------------------------------------------------------------------
>
> At the end, I also attach what I have noted during the tests with the
> different distributions.
>
> Dirk
>
> ------------------------------------------------------------------------
> Problem on systems where the gnu-netcat package provides a symbolic
> link /usr/bin/nc -> /usr/bin/netcat:
>
> gnu-netcat requires -p to specify the local port but does not complain
> if invoked as `nc -l -u <port>'; you need to use -v to see that it
> does not do what you might expect:
>
> # nc -l -u 4444 -v
> Warning: Inverse name lookup failed for `0.0.17.92'
> ------------------------------------------------------------------------
>
> Distro Package needs -p
> Command invocation
> ========================================================================
> Arch gnu-netcat yes
> (Website nc | netcat
> documentation)
> openbsd-netcat no
> nc.openbsd
> ------------------------------------------------------------------------
> Debian-6.0.5 netcat-openbsd no
> nc | netcat | nc.openbsd
>
> netcat / netcat-traditional (preinstalled) yes
> nc | netcat
>
> netcat6 yes
> nc | netcat | nc6
> ------------------------------------------------------------------------
> Fedora-17 nc (preinstalled) no
> nc
>
> nc6
> nc6 yes
> ------------------------------------------------------------------------
> Gentoo gnu-netcat yes
> netcat
>
> netcat yes
> nc
>
> netcat6 yes
> nc | nc6
> ------------------------------------------------------------------------
> OpenSUSE-12.1 netcat-openbsd no
> nc | netcat
> ------------------------------------------------------------------------
> Ubuntu-12.04 netcat-openbsd (preinstalled) no
> Desktop nc | netcat | nc.openbsd
>
> netcat / netcat-traditional yes
> nc | netcat
>
> netcat6 yes
> nc | netcat | nc6
> ------------------------------------------------------------------------
Here is a patch that also includes Jan's suggestion for socat(1).
The problem with the patch is that the netcat part does not cover every
possible distribution/netcat-package situation but in my opinion it is a
bearable compromise with respect to keeping the example section compact.
Dirk
>From d756d2750e4cf07d3c0942dc3c491d57631d4338 Mon Sep 17 00:00:00 2001
From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
Date: Thu, 2 Aug 2012 22:20:16 +0200
Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
There are at least 4 implementations of netcat with the BSD-based
being the only one that has to be used without the -p switch to
specify the listening port.
Jan Engelhardt suggested to add an example for socat(1).
---
Documentation/networking/netconsole.txt | 19 +++++++++++++++++--
1 files changed, 17 insertions(+), 2 deletions(-)
diff --git a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
index 8d02207..2e9e0ae2 100644
--- a/Documentation/networking/netconsole.txt
+++ b/Documentation/networking/netconsole.txt
@@ -51,8 +51,23 @@ Built-in netconsole starts immediately after the TCP stack is
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.
+The remote host has several options to receive the kernel messages,
+for example:
+
+1) syslogd
+
+2) netcat
+
+ On distributions using a BSD-based netcat version (e.g. Fedora,
+ openSUSE and Ubuntu) the listening port must be specified without
+ the -p switch:
+
+ 'nc -u -l -p <port>' / 'nc -u -l <port>' or
+ 'netcat -u -l -p <port>' / 'netcat -u -l <port>'
+
+3) socat
+
+ 'socat udp-recv:<port> -'
Dynamic reconfiguration:
========================
--
1.7.8.6
^ permalink raw reply related [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-02 20:39 ` Dirk Gouders
@ 2012-08-02 20:41 ` Jesse Barnes
2012-08-03 5:30 ` Cong Wang
2012-08-16 11:46 ` Rob Landley
2 siblings, 0 replies; 17+ messages in thread
From: Jesse Barnes @ 2012-08-02 20:41 UTC (permalink / raw)
To: Dirk Gouders
Cc: Rob Landley, Milton Miller, Borislav Petkov, Cong Wang,
Jan Engelhardt, Linux Kernel
On Thu, 02 Aug 2012 22:39:28 +0200
Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de> wrote:
> Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de> writes:
>
> > Rob Landley <rob@landley.net> writes:
> >
> >> On 07/29/2012 03:40 AM, Milton Miller wrote:
> >>> [adding Rob as Doc maintanier]
> >>>
> >>> On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
> >>>> 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.
> >>>>
> >>>> >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(-)
> >>
> >> Did this ever resolve to a specific recommended patch? The one at the
> >> start of the thread:
> >>
> >> http://lkml.indiana.edu/hypermail/linux/kernel/1207.3/01995.html
> >>
> >> Apparently isn't it...?
> >
> > Sorry for the delay.
> > I tested the situation on a few distributions and am still thinking
> > about a proper way to write it in a way without netconsole.txt becoming
> > a kind of "netcat.txt".
> >
> > I would be glad about comments to what I currently have -- also, because
> > I am not a native English speaker:
> >
> > ------------------------------------------------------------------------
> > The remote host can run syslogd or netcat to receive the kernel
> > messages. On distributions using a BSD-based netcat version
> > (e.g. Fedora, openSUSE and Ubuntu) the listening port must be
> > specified without the -p switch:
> >
> > 'nc -u -l -p <port>' / 'nc -u -l <port>' or
> > 'netcat -u -l -p <port>' / 'netcat -u -l <port>'
> > ------------------------------------------------------------------------
> >
> > At the end, I also attach what I have noted during the tests with the
> > different distributions.
> >
> > Dirk
> >
> > ------------------------------------------------------------------------
> > Problem on systems where the gnu-netcat package provides a symbolic
> > link /usr/bin/nc -> /usr/bin/netcat:
> >
> > gnu-netcat requires -p to specify the local port but does not complain
> > if invoked as `nc -l -u <port>'; you need to use -v to see that it
> > does not do what you might expect:
> >
> > # nc -l -u 4444 -v
> > Warning: Inverse name lookup failed for `0.0.17.92'
> > ------------------------------------------------------------------------
> >
> > Distro Package needs -p
> > Command invocation
> > ========================================================================
> > Arch gnu-netcat yes
> > (Website nc | netcat
> > documentation)
> > openbsd-netcat no
> > nc.openbsd
> > ------------------------------------------------------------------------
> > Debian-6.0.5 netcat-openbsd no
> > nc | netcat | nc.openbsd
> >
> > netcat / netcat-traditional (preinstalled) yes
> > nc | netcat
> >
> > netcat6 yes
> > nc | netcat | nc6
> > ------------------------------------------------------------------------
> > Fedora-17 nc (preinstalled) no
> > nc
> >
> > nc6
> > nc6 yes
> > ------------------------------------------------------------------------
> > Gentoo gnu-netcat yes
> > netcat
> >
> > netcat yes
> > nc
> >
> > netcat6 yes
> > nc | nc6
> > ------------------------------------------------------------------------
> > OpenSUSE-12.1 netcat-openbsd no
> > nc | netcat
> > ------------------------------------------------------------------------
> > Ubuntu-12.04 netcat-openbsd (preinstalled) no
> > Desktop nc | netcat | nc.openbsd
> >
> > netcat / netcat-traditional yes
> > nc | netcat
> >
> > netcat6 yes
> > nc | netcat | nc6
> > ------------------------------------------------------------------------
>
> Here is a patch that also includes Jan's suggestion for socat(1).
>
> The problem with the patch is that the netcat part does not cover every
> possible distribution/netcat-package situation but in my opinion it is a
> bearable compromise with respect to keeping the example section compact.
>
> Dirk
>
> From d756d2750e4cf07d3c0942dc3c491d57631d4338 Mon Sep 17 00:00:00 2001
> From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
> Date: Thu, 2 Aug 2012 22:20:16 +0200
> Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
>
> There are at least 4 implementations of netcat with the BSD-based
> being the only one that has to be used without the -p switch to
> specify the listening port.
>
> Jan Engelhardt suggested to add an example for socat(1).
> ---
> Documentation/networking/netconsole.txt | 19 +++++++++++++++++--
> 1 files changed, 17 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
> index 8d02207..2e9e0ae2 100644
> --- a/Documentation/networking/netconsole.txt
> +++ b/Documentation/networking/netconsole.txt
> @@ -51,8 +51,23 @@ Built-in netconsole starts immediately after the TCP stack is
> 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.
> +The remote host has several options to receive the kernel messages,
> +for example:
> +
> +1) syslogd
> +
> +2) netcat
> +
> + On distributions using a BSD-based netcat version (e.g. Fedora,
> + openSUSE and Ubuntu) the listening port must be specified without
> + the -p switch:
> +
> + 'nc -u -l -p <port>' / 'nc -u -l <port>' or
> + 'netcat -u -l -p <port>' / 'netcat -u -l <port>'
> +
> +3) socat
> +
> + 'socat udp-recv:<port> -'
>
> Dynamic reconfiguration:
> ========================
Looks good to me, thanks Dirk.
Reviewed-by: Jesse Barnes <jbarnes@virtuousgeek.org>
--
Jesse Barnes, Intel Open Source Technology Center
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-02 20:39 ` Dirk Gouders
2012-08-02 20:41 ` Jesse Barnes
@ 2012-08-03 5:30 ` Cong Wang
2012-08-03 6:33 ` Dirk Gouders
2012-08-16 11:46 ` Rob Landley
2 siblings, 1 reply; 17+ messages in thread
From: Cong Wang @ 2012-08-03 5:30 UTC (permalink / raw)
To: Dirk Gouders
Cc: Rob Landley, Milton Miller, Borislav Petkov, Jesse Barnes,
Jan Engelhardt, Linux Kernel
On Fri, Aug 3, 2012 at 4:39 AM, Dirk Gouders
<gouders@et.bocholt.fh-gelsenkirchen.de> wrote:
>
> From d756d2750e4cf07d3c0942dc3c491d57631d4338 Mon Sep 17 00:00:00 2001
> From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
> Date: Thu, 2 Aug 2012 22:20:16 +0200
> Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
>
> There are at least 4 implementations of netcat with the BSD-based
> being the only one that has to be used without the -p switch to
> specify the listening port.
>
> Jan Engelhardt suggested to add an example for socat(1).
Looks good, but you missed your SOB.
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-03 5:30 ` Cong Wang
@ 2012-08-03 6:33 ` Dirk Gouders
2012-08-08 15:36 ` Cong Wang
0 siblings, 1 reply; 17+ messages in thread
From: Dirk Gouders @ 2012-08-03 6:33 UTC (permalink / raw)
To: Cong Wang
Cc: Rob Landley, Milton Miller, Borislav Petkov, Jesse Barnes,
Jan Engelhardt, Linux Kernel
Cong Wang <xiyou.wangcong@gmail.com> writes:
> On Fri, Aug 3, 2012 at 4:39 AM, Dirk Gouders
> <gouders@et.bocholt.fh-gelsenkirchen.de> wrote:
>>
>> From d756d2750e4cf07d3c0942dc3c491d57631d4338 Mon Sep 17 00:00:00 2001
>> From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
>> Date: Thu, 2 Aug 2012 22:20:16 +0200
>> Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
>>
>> There are at least 4 implementations of netcat with the BSD-based
>> being the only one that has to be used without the -p switch to
>> specify the listening port.
>>
>> Jan Engelhardt suggested to add an example for socat(1).
>
>
> Looks good, but you missed your SOB.
Thanks for noticing that, attached is the amended patch.
Dirk
>From b3aec70d785d338b1b643fece6606cd32addaf0c Mon Sep 17 00:00:00 2001
From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
Date: Thu, 2 Aug 2012 22:20:16 +0200
Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
There are at least 4 implementations of netcat with the BSD-based
being the only one that has to be used without the -p switch to
specify the listening port.
Jan Engelhardt suggested to add an example for socat(1).
Signed-off-by: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
---
Documentation/networking/netconsole.txt | 19 +++++++++++++++++--
1 files changed, 17 insertions(+), 2 deletions(-)
diff --git a/Documentation/networking/netconsole.txt b/Documentation/networking/netconsole.txt
index 8d02207..2e9e0ae2 100644
--- a/Documentation/networking/netconsole.txt
+++ b/Documentation/networking/netconsole.txt
@@ -51,8 +51,23 @@ Built-in netconsole starts immediately after the TCP stack is
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.
+The remote host has several options to receive the kernel messages,
+for example:
+
+1) syslogd
+
+2) netcat
+
+ On distributions using a BSD-based netcat version (e.g. Fedora,
+ openSUSE and Ubuntu) the listening port must be specified without
+ the -p switch:
+
+ 'nc -u -l -p <port>' / 'nc -u -l <port>' or
+ 'netcat -u -l -p <port>' / 'netcat -u -l <port>'
+
+3) socat
+
+ 'socat udp-recv:<port> -'
Dynamic reconfiguration:
========================
--
1.7.8.6
^ permalink raw reply related [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-03 6:33 ` Dirk Gouders
@ 2012-08-08 15:36 ` Cong Wang
2012-08-09 6:41 ` Dirk Gouders
0 siblings, 1 reply; 17+ messages in thread
From: Cong Wang @ 2012-08-08 15:36 UTC (permalink / raw)
To: Dirk Gouders
Cc: Rob Landley, Milton Miller, Borislav Petkov, Jesse Barnes,
Jan Engelhardt, Linux Kernel
On 08/03/2012 02:33 PM, Dirk Gouders wrote:
>
> From b3aec70d785d338b1b643fece6606cd32addaf0c Mon Sep 17 00:00:00 2001
> From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
> Date: Thu, 2 Aug 2012 22:20:16 +0200
> Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
>
> There are at least 4 implementations of netcat with the BSD-based
> being the only one that has to be used without the -p switch to
> specify the listening port.
>
> Jan Engelhardt suggested to add an example for socat(1).
>
> Signed-off-by: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
It looks like no one takes this patch, so I will take it together with
my other netpoll/netconsole patches and send them to netdev.
Thanks!
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-08 15:36 ` Cong Wang
@ 2012-08-09 6:41 ` Dirk Gouders
0 siblings, 0 replies; 17+ messages in thread
From: Dirk Gouders @ 2012-08-09 6:41 UTC (permalink / raw)
To: Cong Wang
Cc: Rob Landley, Milton Miller, Borislav Petkov, Jesse Barnes,
Jan Engelhardt, Linux Kernel
Cong Wang <xiyou.wangcong@gmail.com> writes:
> On 08/03/2012 02:33 PM, Dirk Gouders wrote:
>>
>> From b3aec70d785d338b1b643fece6606cd32addaf0c Mon Sep 17 00:00:00 2001
>> From: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
>> Date: Thu, 2 Aug 2012 22:20:16 +0200
>> Subject: [PATCH] netconsole.txt: revision of examples for the receiver of kernel messages
>>
>> There are at least 4 implementations of netcat with the BSD-based
>> being the only one that has to be used without the -p switch to
>> specify the listening port.
>>
>> Jan Engelhardt suggested to add an example for socat(1).
>>
>> Signed-off-by: Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de>
>
> It looks like no one takes this patch, so I will take it together with
> my other netpoll/netconsole patches and send them to netdev.
Thank you for taking care of it.
Dirk
^ permalink raw reply [flat|nested] 17+ messages in thread
* Re: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
2012-08-02 20:39 ` Dirk Gouders
2012-08-02 20:41 ` Jesse Barnes
2012-08-03 5:30 ` Cong Wang
@ 2012-08-16 11:46 ` Rob Landley
2 siblings, 0 replies; 17+ messages in thread
From: Rob Landley @ 2012-08-16 11:46 UTC (permalink / raw)
To: Dirk Gouders
Cc: Milton Miller, Borislav Petkov, Cong Wang, Jesse Barnes,
Jan Engelhardt, Linux Kernel
On 08/02/2012 03:39 PM, Dirk Gouders wrote:
> Dirk Gouders <gouders@et.bocholt.fh-gelsenkirchen.de> writes:
>
>> Rob Landley <rob@landley.net> writes:
>>
>>> On 07/29/2012 03:40 AM, Milton Miller wrote:
>>>> [adding Rob as Doc maintanier]
>>>>
>>>> On Sat, 28 Jul 2012 about 11:08:16 -0000, Dirk Gouders wrote:
>>>>> 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.
>>>>>
>>>>> >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(-)
>>>
>>> Did this ever resolve to a specific recommended patch? The one at the
>>> start of the thread:
>>>
>>> http://lkml.indiana.edu/hypermail/linux/kernel/1207.3/01995.html
>>>
>>> Apparently isn't it...?
>>
>> Sorry for the delay.
>> I tested the situation on a few distributions and am still thinking
>> about a proper way to write it in a way without netconsole.txt becoming
>> a kind of "netcat.txt".
>>
>> I would be glad about comments to what I currently have -- also, because
>> I am not a native English speaker:
>>
>> ------------------------------------------------------------------------
>> The remote host can run syslogd or netcat to receive the kernel
>> messages. On distributions using a BSD-based netcat version
>> (e.g. Fedora, openSUSE and Ubuntu) the listening port must be
>> specified without the -p switch:
>>
>> 'nc -u -l -p <port>' / 'nc -u -l <port>' or
>> 'netcat -u -l -p <port>' / 'netcat -u -l <port>'
>> ------------------------------------------------------------------------
>>
>> At the end, I also attach what I have noted during the tests with the
>> different distributions.
>>
>> Dirk
>>
>> ------------------------------------------------------------------------
>> Problem on systems where the gnu-netcat package provides a symbolic
>> link /usr/bin/nc -> /usr/bin/netcat:
>>
>> gnu-netcat requires -p to specify the local port but does not complain
>> if invoked as `nc -l -u <port>'; you need to use -v to see that it
>> does not do what you might expect:
>>
>> # nc -l -u 4444 -v
>> Warning: Inverse name lookup failed for `0.0.17.92'
>> ------------------------------------------------------------------------
>>
>> Distro Package needs -p
>> Command invocation
>> ========================================================================
>> Arch gnu-netcat yes
>> (Website nc | netcat
>> documentation)
>> openbsd-netcat no
>> nc.openbsd
>> ------------------------------------------------------------------------
>> Debian-6.0.5 netcat-openbsd no
>> nc | netcat | nc.openbsd
>>
>> netcat / netcat-traditional (preinstalled) yes
>> nc | netcat
>>
>> netcat6 yes
>> nc | netcat | nc6
>> ------------------------------------------------------------------------
>> Fedora-17 nc (preinstalled) no
>> nc
>>
>> nc6
>> nc6 yes
>> ------------------------------------------------------------------------
>> Gentoo gnu-netcat yes
>> netcat
>>
>> netcat yes
>> nc
>>
>> netcat6 yes
>> nc | nc6
>> ------------------------------------------------------------------------
>> OpenSUSE-12.1 netcat-openbsd no
>> nc | netcat
>> ------------------------------------------------------------------------
>> Ubuntu-12.04 netcat-openbsd (preinstalled) no
>> Desktop nc | netcat | nc.openbsd
>>
>> netcat / netcat-traditional yes
>> nc | netcat
>>
>> netcat6 yes
>> nc | netcat | nc6
>> ------------------------------------------------------------------------
>
> Here is a patch that also includes Jan's suggestion for socat(1).
Or you could use the bash built-in functionality of /dev/udp/host/port
with redirection. Or you can write a program to do it using the C API.
This seems about as silly as trying to document /proc/sys/vm/drop-caches
by listing the various ways you can write to a file.
Rob
--
GNU/Linux isn't: Linux=GPLv2, GNU=GPLv3+, they can't share code.
Either it's "mere aggregation", or a license violation. Pick one.
^ permalink raw reply [flat|nested] 17+ messages in thread
end of thread, other threads:[~2012-08-16 12:08 UTC | newest]
Thread overview: 17+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2012-07-27 6:35 [RFC PATCH] netconsole.txt: "nc" needs "-p" to specify the listening port Dirk Gouders
2012-07-27 9:02 ` Cong Wang
2012-07-27 9:24 ` Dirk Gouders
2012-07-27 13:15 ` Borislav Petkov
2012-07-28 11:08 ` Dirk Gouders
2012-07-29 8:40 ` [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port, [RFC] " Milton Miller
2012-07-29 11:52 ` Dirk Gouders
2012-08-01 14:06 ` Rob Landley
2012-08-01 15:46 ` Dirk Gouders
2012-08-02 20:39 ` Dirk Gouders
2012-08-02 20:41 ` Jesse Barnes
2012-08-03 5:30 ` Cong Wang
2012-08-03 6:33 ` Dirk Gouders
2012-08-08 15:36 ` Cong Wang
2012-08-09 6:41 ` Dirk Gouders
2012-08-16 11:46 ` Rob Landley
2012-08-02 19:57 ` [RFC PATCH] " Jan Engelhardt
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).