From mboxrd@z Thu Jan 1 00:00:00 1970 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=-7.0 required=3.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_PASS,URIBL_BLOCKED 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 79D5AC282CE for ; Mon, 11 Feb 2019 19:36:20 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 3F4F42186A for ; Mon, 11 Feb 2019 19:36:20 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=networkplumber-org.20150623.gappssmtp.com header.i=@networkplumber-org.20150623.gappssmtp.com header.b="aNTOWyXb" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731926AbfBKTgT (ORCPT ); Mon, 11 Feb 2019 14:36:19 -0500 Received: from mail-pl1-f196.google.com ([209.85.214.196]:41147 "EHLO mail-pl1-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727482AbfBKTgS (ORCPT ); Mon, 11 Feb 2019 14:36:18 -0500 Received: by mail-pl1-f196.google.com with SMTP id k15so27776pls.8 for ; Mon, 11 Feb 2019 11:36:18 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20150623.gappssmtp.com; s=20150623; h=date:from:to:cc:subject:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=ukw1r7Y+OA+bvYn2atTXniDrnQza/472A8mfuumdiUU=; b=aNTOWyXbMQpQEAfhUtddQ7SbhBkWB0f45H0Sj+7vibYdUnuTabT1wMxMUNnU2ok6tD YnZ9LnOtP7Do/EWfmrdmumF5b/h4x95exLZPo8BmFq0FBqBxMhXs1FLrNPirxrMTpLs4 OVMrlh+IWo9dG2y97mNeuS91dmyBo+4KwMGC907ix3p9F/ws/03Ws9quugfIXu+PlT31 kOixvyH8lclgZB1WJV5SJKSL0oDPDm29EsJDzSvfoLjiTrJBLfVNAybd5bEhcFZC+2tx 6ppShcS2HUjTtCdlT+DBQsX+jEMNHSJ+fYSQUAfh6NMw8+cMP/NSOmsBH1J1OgPQiR2d xrAQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=ukw1r7Y+OA+bvYn2atTXniDrnQza/472A8mfuumdiUU=; b=Vy+Pk66MmHXY2MQWbQIAEq/ItL2uX0PzOs5ek/R8VV7CJ7sV7JDejB7PiiJj1uIAY/ vAE7FEoZXFzZKV1xfN+B4cdlaZLI7M/QnHgQHPTfD+YC+ayoVz0JeA3wKzWW7aJg8vKj sTSZQwaTlYRobroUe6v+9Df8o3h3qUSFCnh3m02OI0UTR/NUIpymWpliP925ybWBOww7 XNe3xiGRwv8jIXq985Ibsz2Z9xDOUMGa0Tr9HpVUOesrrvL/NrZCa2vq2mDfheC8kgZu DksWkAQOmxRK6bTT8+fRAAASoUiAbzVGLkOlegVHkrjzVp++eWDjey4bxDmrbed6R7DX KJtQ== X-Gm-Message-State: AHQUAubCqH++x4rec1s/qPW5wgUnYlWfvte4VDMCHPtgyfDAZPiRMckL AToDsAidiC1nT41PSYcQ1+BIDCALu5U= X-Google-Smtp-Source: AHgI3IbtWYIp5UxzERrMtiLsp7JiItM785i6R00p0tWAULN5Uvdi3PCl06cRhohVblggrCgiSTGM2Q== X-Received: by 2002:a17:902:ba85:: with SMTP id k5mr12308997pls.130.1549913777482; Mon, 11 Feb 2019 11:36:17 -0800 (PST) Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id y1sm14189088pfe.9.2019.02.11.11.36.17 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 11 Feb 2019 11:36:17 -0800 (PST) Date: Mon, 11 Feb 2019 11:36:10 -0800 From: Stephen Hemminger To: Phil Sutter Cc: netdev@vger.kernel.org, William Flanagan Subject: Re: [iproute PATCH] man: ip-link: Describe promisc mode Message-ID: <20190211113610.6c6604e4@hermes.lan> In-Reply-To: <20190211091706.20624-1-phil@nwl.cc> References: <20190211091418.GL26388@orbyte.nwl.cc> <20190211091706.20624-1-phil@nwl.cc> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org On Mon, 11 Feb 2019 10:17:06 +0100 Phil Sutter wrote: > Briefly explain what it is and where it's typically used. > > Signed-off-by: Phil Sutter > --- > man/man8/ip-link.8.in | 8 ++++++++ > 1 file changed, 8 insertions(+) > > 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. 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 Bottom line, adding this to the documentation is not going to be helpful.