ip - Routing, Netzwerkgeräte, Schnittstellen und Tunnel anzeigen / manipulieren
SYNOPSIS
ip [ OPTIONEN ] OBJEKT { BEFEHL | help }
ip [ -force ] -batch dateiname
OBJEKT := { adresse | addrlabel | fou | help | ila | ioam | l2tp | link | macsec | maddress |
monitor | mptcp | mroute | mrule | neighbor | neighbour | netconf | netns | nexthop |
ntable | ntbl | route | rule | sr | tap | tcpmetrics | token | tunnel | tuntap | vrf |
xfrm }
OPTIONEN := { -V[ersion] | -h[uman-readable] | -s[tatistics] | -d[etails] | -r[esolve] | -iec |
-f[amily] { inet | inet6 | link } | -4 | -6 | -B | -0 | -l[oops] { maximale_anzahl_der_adresslöschversuche } | -o[neline] | -rc[vbuf] [größe] | -t[imestamp] | -ts[hort] | -n[etns] name |
-N[umerisch] | -a[ll] | -c[olor] | -br[ief] | -j[son] | -p[retty] }
OPTIONEN
-V, -Version
Gibt die Version des ip-Dienstprogramms aus und beendet das Programm.
-h, -human, -human-readable
Gibt Statistiken mit menschenlesbaren Werten gefolgt von einem Suffix aus.
-b, -batch <DATEINAME>
Liest Befehle aus der angegebenen Datei oder der Standardeingabe und führt sie aus. Der erste Fehler führt zum Abbruch von ip.
-force Beendet ip nicht bei Fehlern im Batch-Modus. Wenn während der Ausführung der Befehle Fehler aufgetreten sind, ist der Rückgabewert der Anwendung nicht Null.
-s, -stats, -statistics
Gibt mehr Informationen aus. Wenn die Option zweimal oder öfter vorkommt, erhöht sich die Informationsmenge. In der Regel handelt es sich um Statistiken oder Zeitwerte.
-d, -details
Gibt detailliertere Informationen aus.
-l, -loops <ANZAHL>
Gibt die maximale Anzahl von Schleifen an, die die Logik von 'ip address flush' ausführt, bevor sie aufgibt. Der Standardwert ist 10. Null (0) bedeutet, dass die Schleife so lange ausgeführt wird, bis alle Adressen entfernt sind.
-f, -family <FAMILIE>
Gibt die zu verwendende Protokollfamilie an. Die Protokollfamilienkennung kann eine von inet, inet6, bridge, mpls oder link sein. Wenn diese Option nicht vorhanden ist, wird die Protokollfamilie anhand anderer Argumente ermittelt. Wenn die restliche Befehlszeile nicht genügend Informationen zur Bestimmung der Familie enthält, greift ip auf die Standardfamilie zurück, in der Regel inet oder any. link ist eine spezielle Familienkennung, die bedeutet, dass kein Netzwerkprotokoll beteiligt ist.
-4 Kurzbefehl für -family inet.
-6 Kurzbefehl für -family inet6.
-B Kurzbefehl für -family bridge.
-M Kurzbefehl für -family mpls.
-0 Kurzbefehl für -family link.
-o, -oneline
Gibt jeden Datensatz in einer einzelnen Zeile aus und ersetzt Zeilenumbrüche durch das Zeichen '\'. Dies ist praktisch, wenn Sie die Ausgabe mit [wc]({filename}../../wc)(1) zählen oder mit [grep]({filename}../../grep)(1) durchsuchen möchten.
-r, -resolve
Verwendet den Namensauflöser des Systems, um DNS-Namen anstelle von Hostadressen auszugeben.
-n, -netns <NETNS>
schaltet auf den angegebenen Netzwerk-Namespace NETNS um. Vereinfacht eigentlich die Ausführung von:
ip netns exec NETNS ip [OPTIONEN] OBJEKT {BEFEHL | help}
zu
ip -n[etns] NETNS [OPTIONEN] OBJEKT {BEFEHL | help}
-N, -Numeric
gibt die Nummer des Protokolls, des Bereichs, des dsfelds usw. direkt aus, anstatt es in eine für den Menschen lesbare Form zu konvertieren.
-a, -all
führt den angegebenen Befehl für alle Objekte aus, je nachdem, ob der Befehl diese Option unterstützt.
-c[color][={always|auto|never}]
Konfiguriert die Farbausgabe. Wenn der Parameter weggelassen oder always lautet, wird die Farbausgabe unabhängig vom Status von stdout aktiviert. Wenn auto angegeben ist, wird geprüft, ob stdout ein Terminal ist, bevor die Farbausgabe aktiviert wird. Wenn never angegeben ist, wird die Farbausgabe deaktiviert. Wenn die Option mehrmals angegeben wird, hat die letzte Angabe Vorrang. Dieses Flag wird ignoriert, wenn auch -json angegeben ist.
Die verwendete Farbpalette kann über die Umgebungsvariable COLORFGBG beeinflusst werden (siehe UMGEBUNG).
-t, -timestamp
zeigt die aktuelle Zeit an, wenn die Option „monitor“ verwendet wird.
-ts, -tshort
ähnlich wie -timestamp, verwendet aber ein kürzeres Format.
-rc, -rcvbuf<SIZE>
Legt die Größe des Netlink-Socket-Empfangspuffers fest, standardmäßig 1 MB.
-iec gibt die menschlich lesbaren Raten in IEC-Einheiten aus (z. B. 1Ki = 1024).
-br, -brief
gibt nur grundlegende Informationen in einem tabellarischen Format aus, um die Lesbarkeit zu verbessern. Diese Option wird derzeit nur von den Befehlen ip addr show, ip link show und ip neigh show unterstützt.
-j, -json
gibt die Ergebnisse im JavaScript-Objektnotationsformat (JSON) aus.
-p, -pretty
das Standard-JSON-Format ist kompakt und effizienter zu parsen, aber für die meisten Benutzer schwer zu lesen. Dieses Flag fügt Einrückungen für eine bessere Lesbarkeit hinzu.
-echo fordert den Kernel an, die angewendete Konfiguration zurückzusenden.
IP - BEFEHLSSYNTAX
OBJEKT
address
- Protokoll (IP oder IPv6)-Adresse auf einem Gerät.
addrlabel
- Konfiguration der Label für die Adressauswahl.
fou - Foo-over-UDP-Empfensportkonfiguration.
ila - Verwaltung von Identifier Locator Addresses (ILA).
ioam - Verwaltung von IOAM-Namespaces und IOAM-Schemata.
l2tp - Tunneling von Ethernet über IP (L2TPv3).
link - Netzwerkgerät.
macsec - MACsec-Gerätekonfiguration.
maddress
- Multicast-Adresse.
monitor
- Überwachung von Netlink-Nachrichten.
mptcp - Verwaltung des MPTCP-Pfadmanagers.
mroute - Multicast-Routing-Cacheeintrag.
mrule - Regel in der Datenbank der Multicast-Routingrichtlinien.
neighbour
- Verwaltung von ARP- oder NDISC-Cacheeinträgen.
netconf
- Netzwerk-Konfigurationsüberwachung.
netns - Verwaltung von Netzwerk-Namespaces.
nexthop
- Verwaltung von Nexthop-Objekten.
ntable - Verwaltung des Betriebs des Neighbor-Cache.
route - Routing-Tabelleneintrag.
rule - Regel in der Datenbank der Routingrichtlinien.
sr - Verwaltung des IPv6-Segmentroutings.
stats - Verwaltung und Anzeige der Schnittstellenstatistiken.
tcp_metrics/tcpmetrics
- Verwaltung der TCP-Metriken.
token - Verwaltung von tokenisierten Schnittstellenidentifikatoren.
tunnel - Tunneling über IP.
tuntap - Verwaltung von TUN/TAP-Geräten.
vrf - Verwaltung von virtuellen Routing- und Weiterleitungsgeräten.
xfrm - Verwaltung von IPSec-Richtlinien.
Die Namen aller Objekte können in vollständiger oder abgekürzter Form geschrieben werden, z. B. kann address als addr oder einfach a abgekürzt werden.
BEFEHL
Gibt die auszuführende Aktion für das Objekt an. Die Menge der möglichen Aktionen hängt vom Objekttyp ab. In der Regel ist es möglich, Objekte hinzuzufügen, zu löschen und anzuzeigen (oder aufzulisten), aber einige Objekte erlauben nicht alle diese Operationen oder haben zusätzliche Befehle. Der Hilfebefehl ist für alle Objekte verfügbar. Er gibt eine Liste der verfügbaren Befehle und Syntaxkonventionen für Argumente aus.
Wenn kein Befehl angegeben wird, wird ein Standardbefehl angenommen. In der Regel ist dies „list“ oder, falls die Objekte dieser Klasse nicht aufgelistet werden können, „help“.
UMGEBUNG
COLORFGBG
Wenn dies gesetzt ist, wird sein Wert verwendet, um zu erkennen, ob der Hintergrund dunkel oder hell ist, und es werden kontrastreiche Farben dafür verwendet.
Die Umgebungsvariable COLORFGBG enthält normalerweise entweder zwei oder drei durch Semikolons getrennte Werte; wir wollen den letzten Wert in beiden Fällen. Wenn dieser Wert 0-6 oder 8 ist, wähle Farben, die für einen dunklen Hintergrund geeignet sind:
COLORFGBG=\";0\" ip -c a
ABGANGSSTATUS
Der Abgangsstatus ist 0, wenn der Befehl erfolgreich war, und 1, wenn ein Syntaxfehler vorliegt. Wenn ein Fehler vom Kernel gemeldet wurde, ist der Abgangsstatus 2.
BEISPIELE
ip addr
Zeigt die allen Netzwerkschnittstellen zugewiesenen Adressen an.
ip neigh
Zeigt die aktuelle Nachbartabelle im Kernel an.
ip link set x up
Aktiviert die Schnittstelle x.
ip link set x down
Deaktiviert die Schnittstelle x.
ip route
Zeigt die Routen in der Routing-Tabelle an.
HISTORIE
ip wurde von Alexey N. Kuznetsov geschrieben und in Linux 2.2 hinzugefügt.
SIEHE AUCH
ip-address(8), ip-addrlabel(8), ip-fou(8), ip-ioam(8), ip-l2tp(8), ip-link(8), ip-macsec(8), ipmaddress(8), ip-monitor(8), ip-mptcp(8), ip-mroute(8), ip-neighbour(8), ip-netconf(8), ipnetns(8), ip-nexthop(8), ip-ntable(8), ip-route(8), ip-rule(8), ip-sr(8), ip-stats(8), iptcp_metrics(8), ip-token(8), ip-tunnel(8), ip-vrf(8), ip-xfrm(8) IP-Befehlsreferenz ip-cref.ps
FEHLERMELDUNGEN
Melden Sie alle Fehler an die Mailingliste „Network Developers“ <_>, wo die Entwicklung und Wartung hauptsächlich stattfindet. Sie müssen nicht Mitglied der Liste sein, um eine Nachricht dorthin zu senden.
AUTOR
Original-Manpage von Michail Litvak <_>