From patchwork Sun Jul 19 01:24:52 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Scott Feldman X-Patchwork-Id: 497440 X-Patchwork-Delegate: davem@davemloft.net Return-Path: X-Original-To: patchwork-incoming@ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 8A7A6140DBF for ; Sun, 19 Jul 2015 11:22:58 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b=V4XLDrDp; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752864AbbGSBWv (ORCPT ); Sat, 18 Jul 2015 21:22:51 -0400 Received: from mail-pa0-f41.google.com ([209.85.220.41]:35200 "EHLO mail-pa0-f41.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752773AbbGSBWm (ORCPT ); Sat, 18 Jul 2015 21:22:42 -0400 Received: by pabkd10 with SMTP id kd10so9502406pab.2 for ; Sat, 18 Jul 2015 18:22:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=Y+MZT3rUA/vS3S29MVz9MJqan1vpwLUtRlsV0a2uJGo=; b=V4XLDrDpzZrvI0koOnnQk074/8VEYmlpmNbNJFl8+EGwtvhZqj85czTZ6Cyi8oaNLY XqdfoheLTI1D3mXJUFNyqcIYuW288cI6dsLRrPnQuYmSNfPthVpMmOgfyOVxvVnOr8bd xrQF+oIxoBQuOOTMy8w2H3pJapB11pmMXdkrMthyDSl92B4XYUmrN3VrPOydhI0PWsHx JxzxMfdwhZSHHTvuejzRUz+Olx2CE3lqLDaHfjj6gqtNmnzIOAYK9uMKFVVFYlaEkVob 12dNmYlE8F0YPTUtw/P9J1k+T4G/XANYpiwDNzMBjMEYiQKIkZRmFY+0Fb5DIZyRpkz5 2HDA== X-Received: by 10.70.42.166 with SMTP id p6mr33648035pdl.118.1437268961689; Sat, 18 Jul 2015 18:22:41 -0700 (PDT) Received: from rocker1.rocker.net ([199.58.98.143]) by smtp.gmail.com with ESMTPSA id he9sm15498501pbc.7.2015.07.18.18.22.40 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 18 Jul 2015 18:22:40 -0700 (PDT) From: sfeldma@gmail.com To: netdev@vger.kernel.org Cc: jiri@resnulli.us, roopa@cumulusnetworks.com, simon.horman@netronome.com, nicolas.dichtel@6wind.com Subject: [PATCH net-next v3 5/5] switchdev: update documentation for offload_fwd_mark Date: Sat, 18 Jul 2015 18:24:52 -0700 Message-Id: <1437269092-17669-6-git-send-email-sfeldma@gmail.com> X-Mailer: git-send-email 1.7.10.4 In-Reply-To: <1437269092-17669-1-git-send-email-sfeldma@gmail.com> References: <1437269092-17669-1-git-send-email-sfeldma@gmail.com> Sender: netdev-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org From: Scott Feldman Signed-off-by: Scott Feldman Acked-by: Jiri Pirko --- Documentation/networking/switchdev.txt | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/Documentation/networking/switchdev.txt b/Documentation/networking/switchdev.txt index c5d7ade..9825f32 100644 --- a/Documentation/networking/switchdev.txt +++ b/Documentation/networking/switchdev.txt @@ -279,8 +279,18 @@ and unknown unicast packets to all ports in domain, if allowed by port's current STP state. The switch driver, knowing which ports are within which vlan L2 domain, can program the switch device for flooding. The packet should also be sent to the port netdev for processing by the bridge driver. The -bridge should not reflood the packet to the same ports the device flooded. -XXX: the mechanism to avoid duplicate flood packets is being discuseed. +bridge should not reflood the packet to the same ports the device flooded, +otherwise there will be duplicate packets on the wire. + +To avoid duplicate packets, the device/driver should mark a packet as already +forwarded using skb->offload_fwd_mark. The same mark is set on the device +ports in the domain using dev->offload_fwd_mark. If the skb->offload_fwd_mark +is non-zero and matches the forwarding egress port's dev->skb_mark, the kernel +will drop the skb right before transmit on the egress port, with the +understanding that the device already forwarded the packet on same egress port. +The driver can use switchdev_port_fwd_mark_set() to set a globally unique mark +for port's dev->offload_fwd_mark, based on the port's parent ID (switch ID) and +a group ifindex. It is possible for the switch device to not handle flooding and push the packets up to the bridge driver for flooding. This is not ideal as the number