From patchwork Tue Nov 28 08:49:39 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hangbin Liu X-Patchwork-Id: 13470694 X-Patchwork-Delegate: kuba@kernel.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="ItPpayfV" Received: from mail-yw1-x1133.google.com (mail-yw1-x1133.google.com [IPv6:2607:f8b0:4864:20::1133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 0A5C9E7 for ; Tue, 28 Nov 2023 00:50:36 -0800 (PST) Received: by mail-yw1-x1133.google.com with SMTP id 00721157ae682-5cfa3a1fb58so23440207b3.2 for ; Tue, 28 Nov 2023 00:50:36 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1701161434; x=1701766234; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=3zRW1MdnZiX3AOov0+Nwg25Dvqe5Quqvhljjzc3Zk5Y=; b=ItPpayfVAVUCAP4IjCvv+g1Z5E7ymVvZ6wsqPE808AQJ2ei0sGcmzVI1GIK/RUTz3+ bWy4231LBQPx8pBs1jne/7CQXhpjhLbltV7Y191pZWsm3KfAH7KozAM/m/w49ReHnywW bNAoVR55B94vmhKMVhrTRB7s/0nc/wj2OCUe2mzaer3n9MZkwRh9y8gwSrhS0lB1UV8e L9jgf/rHxU9di50IWMP3kvTaA8OgLz2VHL+rmM/IJimJDb2N6JQ5hhMpMJ8Weqzz2fJT tWfHS5s8N4pUpjfNiThyLuOKQnbatRTKwNOoebzTQiKaiO9MDm+36nJY1YD3MEGL0WWi cVCg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1701161434; x=1701766234; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=3zRW1MdnZiX3AOov0+Nwg25Dvqe5Quqvhljjzc3Zk5Y=; b=V6Au5pS8p5WpzBEvXnxeY8/jK77xmbIr8vwhfIGt4aV4GZWmS/OXwxjeq2XUqCLVFl 6/kKBKoDXZgNNc1Fe0uWUUFVFjllCXuT4Oz/4hc+Uuq5I+vvaQVJ2J6i3YeyeC7h9bXW +NsxFe33Cy2yIp/n2sNFZj2CLiUnvpEUVF7/BHC9tXyLz9lTF4OyAqvQWgWQjaNWKNuL vmgQxHaCXIvZ0EV4TQ30zvHeRj7+1GzlSfxH1YjV1qoX8X1hFjXM8Ji7LdDZkQeRytT6 jDDVkcF+z9XGvusVDw6AQJwbMo3jwKhFYrd3Z2RqLraB3C/bUBA5Ajau8vYPZIU9e2yS NZcg== X-Gm-Message-State: AOJu0YxzTbZMjQeLWBA8ZIkRvuXOE8OfIprQqK+fi6ZwnDOnbK8KNJ+w JCurHoJfz8rgkhZ1Lz+UBsPG3O3c+02wQCQf X-Google-Smtp-Source: AGHT+IEkTv5jlg2KGTbTRU6g9oaFTnavPXoLJaru4xJOV1Qo1j9SoK/ABHx+4TXIy+IUT/vk7UtsSQ== X-Received: by 2002:a0d:e8c8:0:b0:5ca:10d0:c3a2 with SMTP id r191-20020a0de8c8000000b005ca10d0c3a2mr17996111ywe.19.1701161434339; Tue, 28 Nov 2023 00:50:34 -0800 (PST) Received: from Laptop-X1.redhat.com ([43.228.180.230]) by smtp.gmail.com with ESMTPSA id d25-20020aa78159000000b006cbae51f335sm8766513pfn.144.2023.11.28.00.50.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 28 Nov 2023 00:50:33 -0800 (PST) From: Hangbin Liu To: netdev@vger.kernel.org Cc: "David S . Miller" , David Ahern , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Ido Schimmel , Nikolay Aleksandrov , Roopa Prabhu , Stephen Hemminger , Florian Westphal , Andrew Lunn , Florian Fainelli , Vladimir Oltean , Jiri Pirko , Marc Muehlfeld , Hangbin Liu Subject: [PATCHv3 net-next 06/10] docs: bridge: add VLAN doc Date: Tue, 28 Nov 2023 16:49:39 +0800 Message-ID: <20231128084943.637091-7-liuhangbin@gmail.com> X-Mailer: git-send-email 2.41.0 In-Reply-To: <20231128084943.637091-1-liuhangbin@gmail.com> References: <20231128084943.637091-1-liuhangbin@gmail.com> Precedence: bulk X-Mailing-List: netdev@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Patchwork-Delegate: kuba@kernel.org Add VLAN part for bridge document. Acked-by: Nikolay Aleksandrov Signed-off-by: Hangbin Liu Reviewed-by: Florian Fainelli Reviewed-by: Vladimir Oltean --- Documentation/networking/bridge.rst | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/Documentation/networking/bridge.rst b/Documentation/networking/bridge.rst index 9d07da681bc5..764d44c93c65 100644 --- a/Documentation/networking/bridge.rst +++ b/Documentation/networking/bridge.rst @@ -132,6 +132,35 @@ called by the kernel when STP is enabled/disabled on a bridge stp_state <0|1>``). The kernel enables user_stp mode if that command returns 0, or enables kernel_stp mode if that command returns any other value. +VLAN +==== + +A LAN (Local Area Network) is a network that covers a small geographic area, +typically within a single building or a campus. LANs are used to connect +computers, servers, printers, and other networked devices within a localized +area. LANs can be wired (using Ethernet cables) or wireless (using Wi-Fi). + +A VLAN (Virtual Local Area Network) is a logical segmentation of a physical +network into multiple isolated broadcast domains. VLANs are used to divide +a single physical LAN into multiple virtual LANs, allowing different groups of +devices to communicate as if they were on separate physical networks. + +Typically there are two VLAN implementations, IEEE 802.1Q and IEEE 802.1ad +(also known as QinQ). IEEE 802.1Q is a standard for VLAN tagging in Ethernet +networks. It allows network administrators to create logical VLANs on a +physical network and tag Ethernet frames with VLAN information, which is +called *VLAN-tagged frames*. IEEE 802.1ad, commonly known as QinQ or Double +VLAN, is an extension of the IEEE 802.1Q standard. QinQ allows for the +stacking of multiple VLAN tags within a single Ethernet frame. The Linux +bridge supports both the IEEE 802.1Q and `802.1AD +`_ +protocol for VLAN tagging. + +`VLAN filtering `_ +on a bridge is disabled by default. After enabling VLAN filtering on a bridge, +it will start forwarding frames to appropriate destinations based on their +destination MAC address and VLAN tag (both must match). + FAQ ===