Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-5.5 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_PASS,USER_AGENT_MUTT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8F4A2C282C4 for ; Tue, 12 Feb 2019 15:42:49 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 6633D21773 for ; Tue, 12 Feb 2019 15:42:49 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730567AbfBLPms (ORCPT ); Tue, 12 Feb 2019 10:42:48 -0500 Received: from orbyte.nwl.cc ([151.80.46.58]:58984 "EHLO orbyte.nwl.cc" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726238AbfBLPms (ORCPT ); Tue, 12 Feb 2019 10:42:48 -0500 Received: from n0-1 by orbyte.nwl.cc with local (Exim 4.91) (envelope-from ) id 1gtaCr-0005vc-A6; Tue, 12 Feb 2019 16:42:45 +0100 Date: Tue, 12 Feb 2019 16:42:45 +0100 From: Phil Sutter To: Stephen Hemminger Cc: netdev@vger.kernel.org, William Flanagan Subject: Re: [iproute PATCH] man: ip-link: Describe promisc mode Message-ID: <20190212154245.GM26388@orbyte.nwl.cc> Mail-Followup-To: Phil Sutter , Stephen Hemminger , netdev@vger.kernel.org, William Flanagan References: <20190211091418.GL26388@orbyte.nwl.cc> <20190211091706.20624-1-phil@nwl.cc> <20190211113610.6c6604e4@hermes.lan> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20190211113610.6c6604e4@hermes.lan> User-Agent: Mutt/1.10.1 (2018-07-13) Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Hi, On Mon, Feb 11, 2019 at 11:36:10AM -0800, Stephen Hemminger wrote: > On Mon, 11 Feb 2019 10:17:06 +0100 > Phil Sutter wrote: [...] > > diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in > > index 73d37c190fffa..5c327f01b6b45 100644 > > --- a/man/man8/ip-link.8.in > > +++ b/man/man8/ip-link.8.in > > @@ -1780,6 +1780,14 @@ flag on the device. Indicates that address can change when interface goes down ( > > .B NOT > > used by the Linux). > > > > +.TP > > +.BR "promisc on " or " promisc off" > > +change the > > +.B PROMISC > > +flag on the device. This requests receipt of all packets arriving at the NIC > > +irrespective of their destination MAC address. It is typically used by traffic > > +sniffers and also set by Linux bridges for their ports. > > This added sentence is confusing. The Linux bridge enables it by default, > and if a sniffer wants to enable it then it is best done from the application. > In either case the user should not need to directly set this through ip commands. Well, "used by traffic sniffers" does not imply they don't set it by themselves (at least not in the German accent I'm reading it :). And there probably are ones that don't. > Yes, there are a lots of incorrect web pages out there that say you need to > set an interface into promiscious mode (with ifconfig) before adding it to a bridge. > That might have been true 20 years ago, but hasn't been needed since Linux 2.4 In this case ip-link.8 would become a resource pointing out that bridges do that by themselves nowadays. > Bottom line, adding this to the documentation is not going to be helpful. OK, so I'll send a v2 with that last sentence removed? Thanks, Phil