SYSTEMD.NETDEV(5)

systemd.network

SYSTEMD.NETDEV(5)

BEZEICHNUNG¶

systemd.netdev - Konfiguration des virtuellen Netzwerkgerätes

ÜBERSICHT¶

netdev.netdev

BESCHREIBUNG¶

Eine einfache ini-artige Textdatei, die von systemd-networkd(8) verwandt wird und die Konfiguration von virtuellen Netzwerkgeräten kodiert. Siehe systemd.syntax(7) für eine allgemeine Beschreibung der Syntax.

Das Hauptdatei für das virtuelle Netzwerkgerät muss die Endung »&.netdev« haben, andere Endungen werden ignoriert. Virtuelle Netzwerkgeräte werden erstellt, sobald Networkd gestartet wird. Falls ein Netdev mit dem angegebenen Namen bereits existiert, wird Networkd es wie vorhanden benutzen, anstelle sein eigenes zu erstellen. Beachten Sie, dass Einstellungen von bereits existierenden Netdev durch Networkd nicht geändert werden.

Die .netdev-Dateien werden aus Dateien, die sich im Systemnetzwerkverzeichnis /lib/systemd/network und /usr/local/lib/systemd/network, dem flüchtigen Laufzeitnetzwerkverzeichnis /run/systemd/network und dem lokal administrierten Netzwerkverzeichnis /etc/systemd/network befinden, gelesen. Alle Konfigurationsdateien werden gemeinsam sortiert und in alphanumerischer Reihenfolge verarbeitet, unabhängig von den Verzeichnissen, in denen sie sich befinden. Allerdings ersetzen Dateinamen mit identischen Dateinamen einander. Es wird empfohlen, dass jedem Dateinamen eine Zahl vorangestellt wird (z.B. 10-vlan.netdev). Andernfalls haben durch systemd-network-generator.service(8) erstellte Dateien .netdev Vorrang vor Benutzer-konfigurierten Dateien. Dateien in /etc/ haben die höchste Priorität, Dateien in /run/ haben Vorrang vor Dateien mit dem gleichen Namen in /lib/. Dies kann, falls notwendig, zum Außerkraftsetzen von systemseitig bereitgestellten Konfigurationsdateinamen durch lokale Dateien verwandt werden. Als Spezialfall deaktiviert eine leere Datei (Dateigröße 0) oder ein Symlink auf /dev/null mit dem gleichen Namen die Konfigurationsdatei komplett (sie ist »maskiert«).

Zusammen mit der Netdev-Datei foo.netdev kann ein »Ergänzungs«-Verzeichnis foo.netdev.d/ existieren. Alle Dateien mit der Endung ».conf« aus diesem Verzeichnis werden in alphanumerischer Reihenfolge zusammengeführt und nach der Auswertung der Hauptdatei selbst ausgewertet. Dies ist nützlich, um die Konfigurationseinstellungen zu ändern oder zu ergänzen, ohne die Hauptkonfigurationsdatei selbst zu verändern. Jede Ergänzungsdatei muss über geeignete Abschnittkopfzeilen verfügen.

Zusätzlich zu /etc/systemd/network können Ergänzungs-».d«-Verzeichnisse in die Verzeichnisse /lib/systemd/network oder /run/systemd/network abgelegt werden. Ergänzungsdateien in /etc/ haben Vorrang vor denen in /run/, die wiederum Vorrang vor denen in /lib/ haben. Ergänzungsdateien unter all diesen Verzeichnissen haben Vorrang vor der Haupt-Netdev-Datei, wo auch immer sich diese befindet. (Da /run/ temporär und /usr/lib/ für Lieferanten vorgesehen ist, ist es natürlich unwahrscheinlich, dass Ergänzungsverzeichnisse an einem der beiden Orte verwandt werden sollten.)

UNTERSTÜTZTE NETDEV-ARTEN¶

Die folgenden Arten von virtuellen Netzwerkgeräten können in .netdev-Dateien konfiguriert werden:

Tabelle 1. Unterstützte Arten von virtuellen Netzwerkgeräten

Art	Beschreibung
bond	Ein gebündeltes Gerät ist eine Zusammenstellung aller seiner Slave-Geräte. Siehe das Linux-Ethernet-Bonding-Treiber-HOWTO[1] für Details.
bridge	Ein Bridge-Gerät ist ein Software-Switch und jedes seiner Slave-Geräte und die Bridge selbst sind Ports des Switches.
dummy	Ein Pseudogerät, das alle an es gesandten Pakete verwirft.
gre	Ein Stufe-3-GRE-Tunnel über IPv4. Siehe RFC 2784[2] für Details. Der Name »gre0« sollte nicht verwandt werden, da der Kernel ein Gerät mit diesem Namen erstellt, wenn das entsprechende Kernelmodul geladen wird.
gretap	Ein Stufe-2-GRE-Tunnel über IPv4. Der Name »gretap0« sollte nicht verwandt werden, da der Kernel ein Gerät mit diesem Namen erstellt, wenn das entsprechende Kernelmodul geladen wird.
erspan	ERSPAN spiegelt den Netzwerkverkehr auf einem oder mehreren Quell-Ports und liefert den gespiegelten Verkehr an einen oder mehrere Ziel-Ports auf einem anderen Switch. Der Netzwerkverkehr wird mittels »Generic routing encapsulation« (GRE) gekapselt und lässt sich daher zwischen dem Quell-Switch und dem Ziel-Switch über ein Layer-3-Netzwerk routen. Der Name »erspan0« sollte nicht verwandt werden, da der Kernel ein Gerät mit diesem Namen erstellt, wenn das entsprechende Kernelmodul geladen wird.
ip6gre	Ein GRE-Tunnel der Stufe 3 über IPv6.
ip6tnl	Ein IPv4- oder IPv6-Tunnel über IPv6
ip6gretap	Ein GRE-Tunnel der Stufe 2 über IPv6.
ipip	Ein IPv4-über-IPv4-Tunnel.
ipvlan	Ein IPVLAN-Gerät ist ein gestapeltes Gerät, das basierend auf IP-Adressfilterung Pakete von seinem unterliegenden Gerät bekommt.
ipvtap	Ein IPVTAP-Gerät ist ein gestapeltes Gerät, das basierend auf IP-Adressfilterung Pakete von seinem unterliegenden Gerät bekommt und auf das mittels der Tap-Benutzerschnittstelle zugegriffen werden kann.
macvlan	Ein macvlan-Gerät ist ein gestapeltes Gerät, das basierend auf MAC-Adressfilterung Pakete von seinem unterliegenden Gerät bekommt.
macvtap	Ein macvtap-Gerät ist ein gestapeltes Gerät, das basierend auf MAC-Adressfilterung Pakete von seinem unterliegenden Gerät bekommt.
sit	Ein IPv6-über-IPv4-Tunnel.
tap	Ein dauerhafter Stufe-2-Tunnel zwischen einem Netzwerkgerät und einem Geräteknoten.
tun	Ein dauerhafter Stufe-3-Tunnel zwischen einem Netzwerkgerät und einem Geräteknoten.
veth	Ein Ethernet-Tunnel zwischen einem Paar von Netzwerkgeräten.
vlan	Ein VLAN ist ein gestapeltes Gerät, das basierend auf VLAN-Markierungen Pakete von seinem zugrundeliegenden Gerät erhält. Siehe IEEE 802.1Q[3] für Details.
vti	Ein IPv4-über-IPSec-Tunnel.
vti6	Ein IPv6-über-IPSec-Tunnel.
vxlan	Ein virtuell erweiterbares LAN (vxlan) zur Verbindung von Cloud-Computing-Einsätzen.
geneve	Ein »GEneric NEtwork Virtualization Encapsulation«- (GENEVE) Netdev-Treiber.
l2tp	Ein »Layer 2 Tunneling Protocol« (L2TP) ist ein Tunnelprotokoll, das zur Unterstützung virtueller privater Netze (VPNs) oder als Teil der Auslieferung von Diensten durch Internetzugangsanbieter verwandt wird. Dieses Protokoll bietet keine Verschlüsselung oder Vertraulichkeit.
macsec	»Media Access Control Security« (MACsec) ist eine 802.1AE-IEEE-Industriestandardtechnik, die sichere Kommunikation für sämtlichen Verkehr auf Ethernet-Links bereitstellt. MACsec bietet End-zu-End-Sicherheit auf Ethernet-Links zwischen direkt verbundenen Knoten und ist in der Lage, die meisten Sicherheitsbedrohungen zu erkennen und zu verhindern.
vrf	Eine virtuelle Routing- und Weiterleitungs- (VRF[4]) Schnittstelle, um separate Routing- und Weiterleitungs-Domains zu erstellen.
vcan	Der virtuelle CAN-Treiber (vcan). Ähnlich dem Netzwerk-Loopback-Gerät bietet vcan eine virtuelle, lokale CAN-Schnittstelle.
vxcan	Der virtuelle CAN-Tunnel-Treiber (vxcan). Ähnlich dem virtuellen Ethernet-Treiber veth implementiert vxcan einen lokalen CAN-Verkehrstunnel zwischen zwei virtuellen CAN-Netzwerkgeräten. Bei der Erstellung eines vxcan werden zwei vxcan-Geräte als Paar erstellt. Wenn ein Ende ein Paket empfängt, erscheint es auf seinem Partner und umgedreht. Der vxcan kann für Namensraum-übergreifende Kommunikation verwandt werden.
wireguard	Sicherer WireGuard-Netzwerktunnel.
nlmon	Ein Netlink-Überwachungsgerät. Verwenden Sie ein Nlmon-Gerät, wenn Sie die System-Netlink-Nachrichten überwachen möchten.
fou	Foo-über-UDP-Tunnelung.
xfrm	Eine virtuelle Tunnelschnittstelle ähnlich vti/vti6, aber mit mehreren Vorteilen.
ifb	Die »Intermediate Functional Block« (ifb) Pseudo-Netzwerkschnittstelle agiert als QoS-Konzentrator für mehrere verschiedene Quellen von Verkehr.
bareudp	Nackte UDP-Tunnel stellen eine generische L3-Kapselungsunterstützung zum Tunneln verschiedener L3-Protokolle wie MPLS, IP usw. innerhalb eines UDP-Tunnels bereit.
batadv	B.A.T.M.A.N. Advanced[5] ist ein Routing-Protokoll für mobile ad-hoc Multi-Hop-Netzwerke, die auf Ebene 2 arbeiten.
ipoib	Eine IP-überInfiniband Unterschnittstelle.
wlan	Eine Schnittstelle für ein virtuelles schnurloses Netzwerk (WLAN).

[MATCH]-ABSCHNITT-OPTIONEN¶

Ein virtuelles Netzwerkgerät wird nur erstellt, falls der Abschnitt »[Match]« auf die aktuelle Umgebung passt oder falls der Abschnitt leer ist. Die folgenden Schlüssel werden akzeptiert:

Host=

Passt auf den Rechnernamen oder die Maschinenkennung des Rechners. Siehe ConditionHost= in systemd.unit(5) für Details. Wird »!« vorangestellt, so wird das Ergebnis negiert. Wird eine leere Zeichenkette zugewiesen, dann wird der vorher zugewiesene Wert zurückgesetzt.

Virtualization=

Prüft, ob das System in einer virtualisierten Umgebung ausgeführt wird und testet optional, ob es eine bestimmte Implementierung ist. Siehe ConditionVirtualization= in systemd.unit(5) für Details. Das Ergebnis wird negiert, wenn ein Ausrufezeichen (»!«) vorangestellt wird. Falls eine leere Zeichenkette zugewiesen wird, dann wird der vorher zugewiesene Wert bereinigt.

KernelCommandLine=

Prüft, ob eine bestimmte Kernelbefehlszeilenoption gesetzt ist. Siehe ConditionKernelCommandLine= in systemd.unit(5) für Details. Das Ergebnis wird negiert, wenn ein Ausrufezeichen (»!«) vorangestellt wird. Falls eine leere Zeichenkette zugewiesen wird, dann wird der vorher zugewiesene Wert bereinigt.

KernelVersion=

Prüft, ob die Kernelversion (wie von uname -r gemeldet) auf einen bestimmten Ausdruck passt. Siehe ConditionKernelVersion= in systemd.unit(5) für Details. Das Ergebnis wird negiert, wenn ein Ausrufezeichen (»!«) vorangestellt wird. Falls eine leere Zeichenkette zugewiesen wird, dann wird der vorher zugewiesene Wert bereinigt.

Credential=

Prüft, ob die festgelegte Zugangsberechtigung an den Dienst systemd-networkd.service übergeben wurde. Siehe System- und Dienste-Zugangsberechtigungen[6] für Details. Das Ergebnis wird negiert, wenn ein Ausrufezeichen (»!«) vorangestellt wird. Falls eine leere Zeichenkette zugewiesen wird, dann wird der vorher zugewiesene Wert bereinigt.

Architecture=

Prüft, ob das System auf einer bestimmten Architektur läuft. Siehe ConditionArchitecture= in systemd.unit(5) für Details. Das Ergebnis wird negiert, wenn ein Ausrufezeichen (»!«) vorangestellt wird. Falls eine leere Zeichenkette zugewiesen wird, dann wird der vorher zugewiesene Wert bereinigt.

Firmware=

Prüft, ob das System auf einer Maschine mit der angegeben Firmware läuft. Siehe ConditionFirmware= in systemd.unit(5) für Details. Das Ergebnis wird negiert, wenn ein Ausrufezeichen (»!«) vorangestellt wird. Falls eine leere Zeichenkette zugewiesen wird, dann wird der vorher zugewiesene Wert bereinigt.

[NETDEV]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[NetDev]« akzeptiert die folgenden Schlüssel:

Description=

Eine formlose Beschreibung des Netdev.

Name=

Der bei der Erstellung des Netdev verwandte Schnittstellenname. Diese Einstellung ist verpflichtend.

Kind=

Die Art des Netdevs. Diese Einstellung ist verpflichtend. Siehe den Abschnitt »Unterstützte Netdev-Arten« für gültige Schlüssel.

MTUBytes=

Die für das Gerät zu setzende maximale Übertragungseinheit in Byte. Die gewöhnlichen Endungen K, M, G werden unterstützt und zur Basis 1024 verstanden. Für »tun«- oder »tap«-Geräte wird die Einstellung MTUBytes= derzeit im Abschnitt »[NetDev]« nicht unterstützt. Bitte geben Sie sie im Abschnitt »[Link]« der entsprechenden systemd.network(5)-Datei an.

MACAddress=

Legt die MAC-Adresse, die für das Gerät verwandt werden soll, fest oder akzeptiert den besonderen Wert »none«. Wenn »none«, wird systemd-networkd die MAC-Adresse für das Gerät nicht erbitten und der Kernel wird eine zufällige MAC-Adresse zuweisen. Für »tun«-, »tap« und »l2tp« wird die Einstellung MACAddress= im Abschnitt »[NetDev]« nicht unterstützt und wird ignoriert. Bitte geben Sie diese im Abschnitt »[Link]« der entsprechenden systemd.network(5)-Datei an. Falls diese Option nicht gesetzt ist, erbt ein »vlan«-Geräte die MAC-Adresse der Master-Schnittstelle. Für andere Arten von Netdevs wird die MAC-Adresse basierend auf dem Schnittstellennamen und der machine-id(5) erstellt, falls diese Option nicht gesetzt ist.

Beachten Sie, dass systemd-udevd die dauerhafte MAC-Adresse für das Geräte zuweisen wird, selbst falls »none« festgelegt wurde, da 99-default.link MACAddressPolicy=persistent enthält. Daher ist es auch notwendig, eine angepasste Datei .link für das Gerät zu erstellen, falls die MAC-Adressen-Zuweisung nicht gewünscht wird.

[BRIDGE]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[Bridge]« gilt nur für Netdevs der Art »bridge« und akzeptiert die folgenden Schlüssel:

HelloTimeSec=

HelloTimeSec legt die Anzahl der Sekunden zwischen zwei Hallo-Paketen fest, die von der Wurzel-Bridge und den ausgewiesenen Bridges ausgesandt werden. Hallo-Pakete werden zur Mitteilung von Informationen über die Topologie über das gesamte mit Bridges verbundene lokale Netzwerk verwandt.

MaxAgeSec=

MaxAgeSec legt die Anzahl der Sekunden für das maximale Nachrichtenalter fest. Falls das zuletzt gesehene (empfangene) Hallopaket mehr als diese Anzahl an Sekunden alt ist, wird die in Frage stehende Bridge die Übernahmeprozedur starten, um zu versuchen, selbst die Wurzel-Bridge zu werden.

ForwardDelaySec=

ForwardDelaySec legt die Anzahl an Sekunden fest, die in jedem auf Anfrage wartenden und lernenden Zustand verweilt wird, bevor der Weiterleitungszustand betreten wird.

AgeingTimeSec=

Dies legt die Anzahl an Sekunden fest, die eine MAC-Adresse in der Weiterleitungsdatenbank behalten wird, nachdem ein Paket von dieser MAC-Adresse empfangen wurde.

Priority=

Die Priorität der Bridge. Eine Ganzzahl zwischen 0 und 65535. Ein niedrigerer Wert bedeutet eine höhere Priorität. Die Bridge mit der niedrigsten Priorität wird als Wurzel-Bridge ausgewählt.

GroupForwardMask=

Eine 16-Bit-Bitmaske, die als Ganzzahl dargestellt ist, die das Weiterleiten von linklokalen Frames mit 802.1D-reservierten Adressen (01:80:C2:00:00:0X) erlaubt. Zwischen der angegebenen Bitmaske und der Exponierung von 2^X, dem unteren Nibble (halben Byte) des letzten Oktets der MAC-Adresse, wird ein logisches UND ausgeführt. Beispielsweise würde ein Wert von 8 die Weiterleitung von Frames, die 01:80:C2:00:00:03 (802.1X PAE) adressieren, erlauben.

DefaultPVID=

Dies legt die Vorgabe-Port-VLAN-Kennung eines neu hinzugefügten Bridge-Ports fest. Setzen Sie dies auf eine Ganzzahl im Bereich 1…4094 oder »none«, um die PVID zu deaktivieren.

MulticastQuerier=

Akzeptiert einen logischen Wert. Diese Einstellung steuert die Option IFLA_BR_MCAST_QUERIER im Kernel. Falls aktiviert, wird der Kernel allgemeine ICMP-Anfragen von einer Adresse, die komplett Null ist, senden. Diese Funktionalität sollte eine schnellere Konvergenz beim Hochfahren ermöglichen, führt aber bei einigen Multicast-fähigen Switches zu Fehlverhalten und stört die Weiterleitung von Multicast-Paketen. Falls nicht gesetzt, wird die Vorgabe des Kernels verwandt.

MulticastSnooping=

Akzeptiert einen logischen Wert. Diese Einstellung steuert die Option IFLA_BR_MCAST_SNOOPING im Kernel. Falls aktiviert, überwacht IGMP-Snooping den IGMP- (Internet Group Management Protocol-)Datenverkehr zwischen den Rechnern und Multicast-Routern. Falls nicht gesetzt, wird die Vorgabe des Kernels verwandt.

VLANFiltering=

Akzeptiert einen logischen Wert. Diese Einstellung steuert die Option IFLA_BR_VLAN_FILTERING im Kernel. Falls aktiviert, wird die Bridge im VLAN-Filtermodus gestartet. Falls nicht gesetzt, wird die Vorgabe des Kernels benutzt.

VLANProtocol=

Erlaubt die Einstellung des für VLAN-Filterung verwandten Protokolls. Akzeptiert 802.1q oder 802.1ad. Standardmäßig nicht gesetzt und die Vorgabe des Kernels wird benutzt.

STP=

Akzeptiert einen logischen Wert. Dies aktiviert das »Spanning Tree Protocol« (STP) der Bridge. Falls nicht gesetzt, wird die Vorgabe des Kernels benutzt.

MulticastIGMPVersion=

Erlaubt die Änderung der Version des Internet-Gruppenverwaltungsprotokolls (IGMP) für Multicast der Bridge. Akzeptiert die Ganzzahl 2 oder 3. Falls nicht gesetzt, wird die Vorgabe des Kernels benutzt.

[VLAN]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[VLAN]« gilt nur für Netdevs der Art »vlan« und akzeptiert den folgenden Schlüssel:

Id=

Die zu verwendende VLAN-Kennung. Eine Ganzzahl im Bereich 0…4094. Diese Einstellung ist verpflichtend.

Protocol=

Erlaubt die Einstellung des für die VLAN-Schnittstelle verwandten Protokolls. Akzeptiert »802.1q« oder »802.1ad«. Standardmäßig nicht gesetzt und die Vorgabe des Kernels wird benutzt.

GVRP=

Akzeptiert einen logischen Wert. Das »Generic VLAN Registration Protocol« (GVRP) ist ein Protokoll, das das automatische Erlernen von VLANs in einem Netz erlaubt. Falls nicht gesetzt, wird die Vorgabeeinstellung des Kernels verwandt.

MVRP=

Akzeptiert einen logischen Wert. Das »Multiple VLAN Registration Protocol« (MVRP), früher als »GARP VLAN Registration Protocol« (GVRP) bekannt, ist ein standardbasierendes Ebene-2-Netzwerkprotokoll für die automatische Konfiguration der VLAN-Information in Switches. Es wurde in der Änderung 802.1ak zu 802.1Q-2005 definiert. Falls nicht gesetzt, wird die Vorgabe des Kernels benutzt.

LooseBinding=

Akzeptiert einen logischen Wert. Der lose VLAN-Bindungsmodus, bei dem nur der Betriebszustand vom Eltern-VLAN zu den zugordneten VLANs weitergegeben wird, aber der VLAN-Gerätezustand nicht geändert wird. Falls nicht gesetzt, wird die Vorgabe des Kernels benutzt.

ReorderHeader=

Akzeptiert einen logischen Wert. Wenn aktiviert, wird der Neuordnungs-Header des VLANs benutzt und VLAN-Schnittstellen verhalten sich wie physische Schnittstellen. Falls nicht gesetzt, wird die Vorgabe des Kernels benutzt.

EgressQOSMaps=, IngressQOSMaps=

Definiert eine Abbildung der Linux-internen Paket-Priorität (SO_PRIORITY) zu dem VLAN-Header-PCP-Feld für ausgehende bzw. eingehende Frames. Akzeptiert eine Leeraum-getrennte Liste an Ganzahlpaaren, wobei jede Ganzzahl im Bereich 1…4294967294 in dem Format »von«-»bis« vorliegen muss z.B. »21-7 45-5«. Beachten Sie, dass »von« größer oder gleich »bis« sein muss. Wenn nicht gesetzt, wird die Vorgabe des Kernels verwandt.

[MACVLAN]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[MACVLAN]« gilt nur für Netdevs der Art »macvlan« und akzeptiert den folgenden Schlüssel:

Mode=

Der zu verwendende MACVLAN-Modus. Die unterstützten Optionen sind »private«, »vepa«, »bridge«, »passthru« und »source«.

SourceMACAddress=

Eine Leerraum-getrennte Liste von fernen, auf dem MACVLAN erlaubten Hardware-Adressen. Diese Option hat nur im Quellmodus eine Wirkung. Verwendet vollständige Doppelpunkt-, Bindestrich- oder Punkt-begrenzte hexadezimale Notation. Diese Option kann mehr als einmal auftauchen, dann werden die Listen zusammengeführt. Falls der Option die leere Zeichenkette zugewiesen wird, wird die vorher definierte Liste der Hardware-Adressen zurückgesetzt. Standardmäßig nicht gesetzt.

BroadcastMulticastQueueLength=

Legt die Länge der Empfangswarteschlange für Broadcast-/Multicast-Pakete fest. Eine vorzeichenlose Ganzzahl im Bereich 0…4294967294. Standardmäßig nicht gesetzt.

[MACVTAP]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[MACVTAP]« gilt nur für Netdevs der Art »macvtap« und akzeptiert die gleichen Schlüssel wie »[MACVLAN]«:

[IPVLAN]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[IPVLAN]« gilt nur für Netdevs der Art »ipvlan« und akzeptiert den folgenden Schlüssel:

Mode=

Der zu verwendende IPVLAN-Modus. Die unterstützten Optionen sind »L2«, »L3« und »L3S«.

Flags=

Die zu verwendenden IPVLAN-Schalter. Die unterstützten Optionen sind »bridge«, »private« und »vepa«.

[IPVTAP]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[IPVTAP]« gilt nur für Netdevs der Art »ipvtap« und akzeptiert die gleichen Schlüssel wie »[IPVLAN]«:

[VXLAN]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[VXLAN]« gilt nur für Netdevs der Art »vxlan« und akzeptiert den folgenden Schlüssel:

VNI=

Der VXLAN-Netzwerkkennzeichner (oder die VXLAN-Segmentkennung). Akzeptiert eine Zahl im Bereich 1…16777215.

Remote=

Konfiguriert die Ziel-IP-Adresse.

Local=

Konfiguriert eine lokale IP-Adresse. Es muss eine Adresse der zugrundeliegenden VXLAN-Schnittstelle oder einer der besonderen Werte »ipv4_link_local«, »ipv6_link_local«, »dhcp4«, »dhcp6« oder »slaac« sein. Falls einer der besonderen Werte festgelegt wird, wird eine Adresse, die auf den entsprechenden Typ der zugrundeliegenden Schnittstelle passt, verwandt. Standardmäßig nicht gesetzt.

Group=

Konfiguriert VXLAN-Multicast-Gruppen-IP-Adressen. Alle Mitglieder eines VXLAN müssen die selben Multicast-Gruppenadressen verwenden.

TOS=

Der Dienstetyp-Byte-Wert für eine Vxlan-Schnittstelle.

TTL=

Eine fester Lebensdauer- (»Time To Live«-)Wert für »Virtual eXtensible Local Area Network«-Pakete. Akzeptiert »inherit« oder eine Zahl im Bereich 0…255. 0 ist ein besonderer Wert, der das Erben des TTLs des inneren Protokolls bedeutet. »inherit« bedeutet, dass es den TTL-Wert des äußeren Protokolls erbt.

MacLearning=

Akzeptiert einen logischen Wert. Falls wahr, wird dynamisches MAC-Lernen zur Erkennung von fernen MAC-Adressen aktiviert.

FDBAgeingSec=

Die Lebensdauer von Weiterleitungsdatenbankeinträgen, die vom Kernel gelernt wurden, in Sekunden.

MaximumFDBEntries=

Konfiguriert die maximale Anzahl an FDB-Einträgen.

ReduceARPProxy=

Akzeptiert einen logischen Wert. Falls wahr, antworten mittels Bridges verbundene VXLAN-Tunnelendpunkte auf ARP-Anfragen von der lokalen Bridge im Auftrag von fernen Clients des »Distributed Overlay Virtual Ethernet« (verteilten virtuellen Überlagerungs-Ethernet) (DOVE)[7]. Standardmäßig falsch.

L2MissNotification=

Akzeptiert einen logischen Wert. Falls wahr, wird Netlink-LLADDR-Verlustbenachrichtigung aktiviert.

L3MissNotification=

Akzeptiert einen logischen Wert. Falls wahr, wird Netlink-IP-Adressen-Verlustbenachrichtigung aktiviert.

RouteShortCircuit=

Akzeptiert einen logischen Wert. Falls wahr, wird das Kurzschließen von Routen eingeschaltet.

UDPChecksum=

Akzeptiert einen logischen Wert. Falls wahr, wird das Übertragen von UDP-Prüfsummen während VXLAN/IPv4 eingeschaltet.

UDP6ZeroChecksumTx=

Akzeptiert einen logischen Wert. Falls wahr, wird das Übertragen von Null-UDP-Prüfsummen während VXLAN/IPv6 eingeschaltet.

UDP6ZeroChecksumRx=

Akzeptiert einen logischen Wert. Falls wahr, wird das Empfangen von Null-UDP-Prüfsummen während VXLAN/IPv6 eingeschaltet.

RemoteChecksumTx=

Akzeptiert einen logischen Wert. Falls wahr, wird das ferne Abladen von Übertragungsprüfsummen von VXLANs eingeschaltet.

RemoteChecksumRx=

Akzeptiert einen logischen Wert. Falls wahr, wird das ferne Abladen von Empfangsprüfsummen von VXLANs eingeschaltet.

GroupPolicyExtension=

Akzeptiert einen logischen Wert. Falls wahr, wird der »Group Policy VXLAN«-Erweiterungs-Sicherheits-Label-Mechanismus über Netzwerk-Peers auf VXLAN hinweg aktiviert. Für Details über das »Group Policy VXLAN« siehe das Dokument VXLAN Group Policy[8]. Standardmäßig falsch.

GenericProtocolExtension=

Akzeptiert einen logischen Wert. Falls wahr, erweitert die Generische Protokollerweiterung das bestehende VXLAN-Protokoll, um Protokolltypisierung, OAM und Versionierungsfähigkeiten bereitzustellen. Für Details zum VXLAN-GPE-Header, siehe das Dokument Generische Protokollerweiterung für VXLAN[9]. Falls der Ziel-Port nicht festgelegt und die Generische Protokollerweiterung gesetzt ist, wird der Vorgabe-Port 4790 verwandt. Standardmäßig falsch.

DestinationPort=

Konfiguriert den Standard-Ziel-UDP-Port. Falls der Ziel-Port nicht festgelegt ist, wird die Linux-Kernel-Vorgabe verwandt. Setzen Sie ihn auf 4789, um den IANA-zugewiesenen Wert zu erhalten.

PortRange=

Konfiguriert den Quell-Port-Bereich für das VXLAN. Basierend auf dem Datenfluss weist der Kernel den Quell-UDP-Port zu, um dem Empfänger zu helfen, Lastenverteilung vorzunehmen. Wenn diese Option nicht gesetzt ist, dann wird der normale Bereich von lokalen UDP-Ports verwandt.

FlowLabel=

Legt die in ausgehenden Paketen zu verwendende Flußkennzeichnung fest. Der gültige Bereich ist 0-1048575.

IPDoNotFragment=

Erlaubt das Einstellen des Bits IPv4-Nicht-Fragementieren (DF) bei ausgehenden Paketen oder den Wert von dem inneren IPv4-Header zu erben. Akzeptiert einen logischen Wert oder »inherit«. Setzen Sie es auf »inherit«, falls das eingekapselte Protokoll IPv6 ist. Falls nicht gesetzt, wird die Vorgabe des Kernels verwandt.

Independent=

Akzeptiert einen logischen Wert. Falls wahr, wird die Vxlan-Schnittstelle ohne zugrundeliegende Schnittstelle erstellt. Standardmäßig »false«, was bedeutet, dass eine .network-Datei, die diese VXLAN-Schnittstelle mittels VXLAN= anfordert, notwendig ist, damit dieses VXLAN erstellt werden kann.

[GENEVE]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[GENEVE]« gilt nur für Netdevs der Art »geneve« und akzeptiert den folgenden Schlüssel:

Id=

Legt den zu verwendenden virtuellen Netzwerkkennzeichner (VNI) fest, eine Zahl zwischen 0 und 16777215. Dieses Feld ist verpflichtend.

Remote=

Legt die Unicast-Ziel-IP-Adresse für ausgehende Pakete fest.

TOS=

Legt den TOS-Wert für ausgehende Pakete fest. Akzeptiert eine Zahl zwischen 1 und 255.

TTL=

Akzeptiert die gleichen Werte im Abschnitt »[VXLAN]«, außer wenn nicht oder auf 0 gesetzt, dann wird die Vorgabe des Kernels benutzt, was bedeutet, dass der TTL der Pakete auf /proc/sys/net/ipv4/ip_default_ttl gesetzt wird.

UDPChecksum=

Akzeptiert einen logischen Wert. Falls wahr, legt er fest, dass UDP-Prüfsummen für über IPv4 übertragende Pakete berechnet werden.

UDP6ZeroChecksumTx=

Akzeptiert einen logischen Wert. Falls wahr, wird die UDP-Prüfsummenberechnung für übertragene Pakete über IPv6 übersprungen.

UDP6ZeroChecksumRx=

Akzeptiert einen logischen Wert. Falls wahr, werden eingehende UDP-Pakete über IPv6 mit Null-Prüfsummenfeldern erlaubt.

DestinationPort=

Legt den Ziel-Port fest. Standardmäßig 6081. Falls nicht gesetzt oder ihm die leere Zeichenkette zugewiesen wurde, wird der Vorgabe-Port 6081 verwandt.

FlowLabel=

Legt die in ausgehenden Paketen zu verwendende Flußkennzeichnung fest.

IPDoNotFragment=

Akzeptiert den gleichen Schlüssel wie im Abschnitt »[VXLAN]«.

[BAREUDP]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[BareUDP]« gilt nur für Netdevs der Art »bareudp« und akzeptiert die folgenden Schlüssel:

DestinationPort=

Gibt den Ziel-UDP-Port an (im Bereich 1…65535). Dies ist verpflichtend.

EtherType=

Gibt das L3-Protokoll an. Akzeptiert entweder »ipv4«, »ipv6«, »mpls-uc« oder »mpls-mc«. Dies ist verpflichtend.

[L2TP]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[L2TP]« gilt nur für Netdevs der Art »l2tp« und akzeptiert die folgenden Schlüssel:

TunnelId=

Legt die Tunnelkennung fest. Akzeptiert eine Zahl im Bereich 1…4294967295. Der verwandte Wert muss mit dem im Peer verwandten Wert »PeerTunnelId=« übereinstimmen. Diese Einstellung ist verpflichtend.

PeerTunnelId=

Legt die Peer-Tunnelkennung fest. Akzeptiert eine Zahl im Bereich 1…4294967295. Der verwandte Wert muss mit dem im Peer verwandten Wert »TunnelId=« übereinstimmen. Diese Einstellung ist verpflichtend.

Remote=

Legt die IP-Adresse des fernen Peers fest. Diese Einstellung ist verpflichtend.

Local=

Legt die IP-Adresse einer lokalen Schnittstelle fest. Akzeptiert eine IP-Adresse oder die besonderen Werte »auto«, »static« oder »dynamic«. Optional kann der Name einer lokalen Schnittstelle nach »@« festgelegt werden, z.B. »192.168.0.1@eth0« oder »auto@eth0«. Wenn eine Adresse festgelegt ist, dann muss eine lokale oder festgelegte Schnittstelle diese Adresse haben und auf die ferne Adresse muss über die lokale Adresse zugegriffen werden können. Falls »auto«, wird eine der Adressen auf einer lokalen oder festgelegten Schnittstelle, die von der fernen Adresse aus zugreifbar ist, verwandt. Ähnlich wird eine der statischen oder dynamischen Adressen verwandt, falls »static« oder »dynamic« gesetzt ist. Standardmäßig »auto«.

EncapsulationType=

Legt den Einkapselungstyp des Tunnels fest. Akzeptiert entweder »udp« oder »ip«.

UDPSourcePort=

Legt den für den Tunnel zu verwendenden UDP-Quell-Port fest. Verpflichtend, wenn Einkapselung ausgewählt ist. Ignoriert, wenn IP-Einkapselung ausgewählt ist.

UDPDestinationPort=

Legt den Ziel-Port fest. Verpflichtend, wenn UDP-Einkapselung ausgewählt ist. Ignoriert, wenn IP-Einkapselung ausgewählt ist.

UDPChecksum=

Akzeptiert einen logischen Wert. Falls wahr, legt er fest, dass UDP-Prüfsummen für über IPv4 übertragende Pakete berechnet werden.

UDP6ZeroChecksumTx=

Akzeptiert einen logischen Wert. Falls wahr, wird die UDP-Prüfsummenberechnung für übertragene Pakete über IPv6 übersprungen.

UDP6ZeroChecksumRx=

Akzeptiert einen logischen Wert. Falls wahr, werden eingehende UDP-Pakete über IPv6 mit Null-Prüfsummenfeldern erlaubt.

[L2TPSESSION]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[L2TPSession]« gilt nur für Netdevs der Art »l2tp« und akzeptiert die folgenden Schlüssel:

Name=

Legt den Namen der Sitzung fest. Diese Einstellung ist verpflichtend.

SessionId=

Legt die Sitzungskennung fest. Akzeptiert eine Zahl im Bereich 1…4294967295. Der verwandte Wert muss auf den beim Peer verwandten Wert »SessionId=« passen. Diese Einstellung ist verpflichtend.

PeerSessionId=

Legt die Sitzungskennung des Peers fest. Akzeptiert eine Zahl im Bereich 1…4294967295. Der verwandte Wert muss auf den beim Peer verwandten Wert »PeerSessionId=« passen. Diese Einstellung ist verpflichtend.

Layer2SpecificHeader=

Legt den Header-Typ »layer2specific« der Sitzung fest. Entweder »none« oder »default«. Standardmäßig »default«.

[MACSEC]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[MACsec]« gilt nur für Netdevs der Art »macsec« und akzeptiert die folgenden Schlüssel:

Port=

Legt den für den MACsec-Übertragungskanal verwandten Port fest. Der Port wird zur Erstellung sicherer Kanalkennzeichner (SCI) verwandt. Akzeptiert einen Wert zwischen 1 und 65535. Standardmäßig nicht gesetzt.

Encrypt=

Akzeptiert einen logischen Wert. Falls wahr, wird Verschlüsselung aktiviert. Standardmäßig nicht gesetzt.

[MACSECRECEIVECHANNEL]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[MACsecReceiveChannel]« gilt nur für Netdevs der Art »macsec« und akzeptiert die folgenden Schlüssel:

Port=

Legt den für den MACsec-Empfangskanal verwandten Port fest. Der Port wird zur Erstellung sicherer Kanalkennzeichner (SCI) verwandt. Akzeptiert einen Wert zwischen 1 und 65535. Diese Option ist verpflichtend und standardmäßig nicht gesetzt.

MACAddress=

Legt die für den MACsec-Empfangskanal verwandte MAC-Adresse fest. Die MAC-Adresse wird zur Erstellung sicherer Kanalkennzeichner (SCI) verwandt. Diese Einstellung ist verpflichtend und standardmäßig nicht gesetzt.

[MACSECTRANSMITASSOCIATION]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[MACsecTransmitAssociation]« gilt nur für Netdevs der Art »macsec« und akzeptiert die folgenden Schlüssel:

PacketNumber=

Legt die Paketnummer fest, die für den Wiederabspielschutz und die Erstellung des Initialisierungsvektors (zusammen mit dem Kennzeichner des sicheren Kanals [SCI]) verwandt wird. Akzeptiert einen Wert zwischen 1-4,294,967,295. Standardmäßig nicht gesetzt.

KeyId=

Legt die Kennzeichnung für den Schlüssel fest. Akzeptiert eine Zahl zwischen 0-255. Dieses Feld ist verpflichtend und standardmäßig nicht gesetzt.

Key=

Legt den im Übertragungskanal zu verwendenden Verschlüsselungsschlüssel fest. Der gleiche Schlüssel muss auf dem Empfangskanal des Peers konfiguriert werden. Diese Einstellung ist verpflichtend und standardmäßig nicht gesetzt. Akzeptiert einen hexadezimal kodierten 128-Bit-Schlüssel, beispielsweise »dffafc8d7b9a43d5b9a3dfbbf6a30c16«.

KeyFile=

Akzeptiert einen absoluten Pfad zu einer Datei, die einen hexadezimal kodierten 128-Bit-Schlüssel enthält, der in dem Übertragungskanal verwandt wird. Wenn diese Option angegeben ist, dann wird Key= ignoriert. Beachten Sie, dass diese Datei durch den Benutzer »systemd-network« lesbar sein muss, daher sollte sie beispielsweise »root:systemd-network« mit einem Dateimodus »0640« gehören. Falls sich der Pfad auf ein AF_UNIX-Datenstromsocket im Dateisystem bezieht, wird dorthin eine Verbindung aufgemacht und der Schlüssel daraus gelesen.

Activate=

Akzeptiert einen logischen Wert. Falls aktiviert, wird die Sicherheitszuordnung aktiviert. Standardmäßig nicht gesetzt.

UseForEncoding=

Akzeptiert einen logischen Wert. Falls aktiviert, wird die Sicherheitszuordnung für die Kodierung verwandt. Nur ein Abschnitt »[MACsecTransmitAssociation]« kann diese Option aktivieren. Wenn aktiviert ist Activate=yes impliziert. Standardmäßig nicht gesetzt.

[MACSECRECEIVEASSOCIATION]-ABSCHNITT-OPTIONEN¶

Der Abschnitt »[MACsecReceiveAssociation]« gilt nur für Netdevs der Art »macsec« und akzeptiert die folgenden Schlüssel:

Port=

Akzeptiert den gleichen Schlüssel wie im Abschnitt »[MACsecReceiveChannel]«.

MACAddress=

Akzeptiert den gleichen Schlüssel wie im Abschnitt »[MACsecReceiveChannel]«.

PacketNumber=