From 23fad47ed6094e4f1b973afa26b245bb7a2dee16 Mon Sep 17 00:00:00 2001 From: LiudmylaNad Date: Mon, 16 Mar 2026 15:04:19 +0100 Subject: DOC: Proofread pseudo-ethernet.rst (#1791) * DOC: Proofread pseudo-ethernet.rst --------- Co-authored-by: Daniil Baturin --- docs/configuration/interfaces/pseudo-ethernet.rst | 65 +++++++++-------------- 1 file changed, 26 insertions(+), 39 deletions(-) (limited to 'docs/configuration/interfaces') diff --git a/docs/configuration/interfaces/pseudo-ethernet.rst b/docs/configuration/interfaces/pseudo-ethernet.rst index 59b3581c..cb42fafc 100644 --- a/docs/configuration/interfaces/pseudo-ethernet.rst +++ b/docs/configuration/interfaces/pseudo-ethernet.rst @@ -1,44 +1,32 @@ -:lastproofread: 2023-01-26 +:lastproofread: 2026-03-05 .. _pseudo-ethernet-interface: ######################### -MACVLAN - Pseudo Ethernet +MACVLAN (pseudo-Ethernet) ######################### -Pseudo-Ethernet or MACVLAN interfaces can be seen as subinterfaces to regular -ethernet interfaces. Each and every subinterface is created a different media -access control (MAC) address, for a single physical Ethernet port. Pseudo- -Ethernet interfaces have most of their application in virtualized environments, - -By using Pseudo-Ethernet interfaces there will be less system overhead compared -to running a traditional bridging approach. Pseudo-Ethernet interfaces can also -be used to workaround the general limit of 4096 virtual LANs (VLANs) per -physical Ethernet port, since that limit is with respect to a single MAC -address. - -Every Virtual Ethernet interfaces behaves like a real Ethernet interface. They -can have IPv4/IPv6 addresses configured, or can request addresses by DHCP/ -DHCPv6 and are associated/mapped with a real ethernet port. This also makes -Pseudo-Ethernet interfaces interesting for testing purposes. A Pseudo-Ethernet -device will inherit characteristics (speed, duplex, ...) from its physical -parent (the so called link) interface. - -Once created in the system, Pseudo-Ethernet interfaces can be referenced in -the exact same way as other Ethernet interfaces. Notes about using Pseudo- -Ethernet interfaces: - -* Pseudo-Ethernet interfaces can not be reached from your internal host. This - means that you can not try to ping a Pseudo-Ethernet interface from the host - system on which it is defined. The ping will be lost. -* Loopbacks occurs at the IP level the same way as for other interfaces, - ethernet frames are not forwarded between Pseudo-Ethernet interfaces. -* Pseudo-Ethernet interfaces may not work in environments which expect a - :abbr:`NIC (Network Interface Card)` to only have a single address. This - applies to: - - VMware machines using default settings - - Network switches with security settings allowing only a single MAC address - - xDSL modems that try to learn the MAC address of the NIC +MACVLAN, or pseudo-Ethernet interfaces, operate as logical subinterfaces of +standard Ethernet interfaces. Each subinterface has a unique MAC address but +shares a single physical Ethernet port. +That allows the user to send packets from different source IPv4 or IPv6 addresses +using a different MAC address. + + +Pseudo-Ethernet interfaces behave like physical Ethernet interfaces. They +support IPv4 and IPv6 addressing, can obtain IP addresses through DHCP or +DHCPv6, and are mapped to a physical Ethernet port. They inherit +characteristics such as speed and duplex from their parent interface and can +be referenced like standard Ethernet interfaces once created. + + +Pseudo-Ethernet interfaces may not work in environments that require a + :abbr:`NIC (Network Interface Card)` to have only one MAC address. + This includes: + + * VMware machines with default settings. + * Network switches that permit only a single MAC address. + * xDSL modems that learn the NIC's MAC address. ************* Configuration @@ -51,13 +39,12 @@ Common interface configuration :var0: pseudo-ethernet :var1: peth0 -Pseudo Ethernet/MACVLAN options -=============================== +MACVLAN (pseudo-Ethernet) options +================================= .. cfgcmd:: set interfaces pseudo-ethernet source-interface - Specifies the physical `` Ethernet interface associated with a Pseudo - Ethernet ``. + Assign a physical Ethernet interface to the specified pseudo-Ethernet interface. VLAN ==== -- cgit v1.2.3