lkml.org 
[lkml]   [2012]   [Jul]   [29]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
    Patch in this message
    /
    From
    SubjectRe: [RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
    Subject[RFC] netconsole.txt: "nc" needs "-p" to specify the listening port
    Date
    [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


    \
     
     \ /
      Last update: 2012-07-29 11:41    [W:0.041 / U:29.588 seconds]
    ©2003-2016 Jasper Spaans. hosted at Digital OceanAdvertise on this site