ifup - Schaltet ein Netzwerkinterface ein.
ifdown - Schaltet ein Netzwerkinterface aus.
ifquery - Analysiert die Interface-Konfiguration.
SYNOPSIS
ifup [-nv] [--no-act] [--verbose] [-i DATEI|--interfaces=DATEI] [--state-dir=VERZEICHNIS] [--allow KLASSE]
-a|INTERFACE...
ifup -h|--help
ifup -V|--version
ifdown [-nv] [--no-act] [--verbose] [-i DATEI|--interfaces=DATEI] [--state-dir=VERZEICHNIS] [--allow KLASSE]
-a|INTERFACE...
ifquery [-nv] [--verbose] [-i DATEI|--interfaces=DATEI] [--state-dir=VERZEICHNIS] [--allow KLASSE] INTERFACE...
ifquery -l|--list [-nv] [--verbose] [-i DATEI|--interfaces=DATEI] [--state-dir=VERZEICHNIS] [--allow KLASSE]
[-a|INTERFACE...]
ifquery --state [--state-dir=VERZEICHNIS] [--allow KLASSE] [-a|INTERFACE...]
BESCHREIBUNG
Die Befehle ifup und ifdown können verwendet werden, um Netzwerkinterfaces basierend auf den Interface-Definitionen in der Datei /etc/network/interfaces zu konfigurieren (bzw. zu dekonfigurieren). Der Befehl ifquery kann verwendet werden, um die Interface-Konfiguration zu analysieren.
OPTIONEN
Eine Zusammenfassung der Optionen ist unten aufgeführt.
-a, --all
Wenn ifup verwendet wird, betrifft dies alle Interfaces, die als "auto" markiert sind. Die Interfaces werden in der Reihenfolge, in der sie in /etc/network/interfaces definiert sind, hochgefahren. In Kombination mit --allow wirkt dies auf alle Interfaces einer bestimmten Klasse. Wenn ifdown verwendet wird, betrifft dies alle definierten Interfaces. Die Interfaces werden in der Reihenfolge, in der sie aktuell in der Statusdatei aufgeführt sind, heruntergefahren. Nur Interfaces, die in /etc/network/interfaces definiert sind, werden heruntergefahren.
-f, --force
Erzwingt die Konfiguration oder Dekonfiguration des Interfaces.
--ignore-errors
Wenn einer der Befehle oder Skripte fehlschlägt, wird fortgesetzt.
-h, --help
Zeigt eine Zusammenfassung der Optionen an.
--allow=KLASSE
Es werden nur die Interfaces, die in einer "allow-KLASSE"-Zeile in /etc/network/interfaces aufgeführt sind, berücksichtigt.
-i DATEI, --interfaces=DATEI
Liest die Interface-Definitionen aus DATEI anstelle von /etc/network/interfaces.
--state-dir=VERZEICHNIS
Speichert den Interface-Status in VERZEICHNIS anstelle von /run/network.
-X MUSTER, --exclude=MUSTER
Schließt Interfaces anhand des MUSTERS von der Liste der zu bearbeitenden Interfaces aus. MUSTER verwendet eine übliche Shell-Glob-Syntax. Wenn keine Shell-Platzhalter verwendet werden, muss es exakt mit dem Namen des Interfaces übereinstimmen. Diese Option kann mehrmals angegeben werden, wodurch mehr als ein Muster ausgeschlossen wird.
-o OPTION=WERT
Setzt OPTION auf WERT, als ob es sich in /etc/network/interfaces befände.
-n, --no-act
Konfiguriert keine Interfaces und führt keine "up"- oder "down"-Befehle aus.
--no-mappings
Führt keine Mappings aus. Weitere Informationen zum Mapping-Feature finden Sie in interfaces(5).
--no-scripts
Führt keine Skripte unter /etc/network/if-*.d/ aus.
--no-loopback
Deaktiviert die spezielle Behandlung des Loopback-Interfaces. Standardmäßig ist das Loopback-Interface (lo unter Linux) intern als "auto"-Interface vordefiniert, so dass es bei ifup -a automatisch hochgefahren wird. Wenn das Loopback-Gerät vom Benutzer neu definiert wird, wird das Interface jedoch nur einmal konfiguriert. Wenn jedoch ein anderes Interface ebenfalls als Loopback definiert ist, wird es wie gewohnt konfiguriert. Durch die Angabe dieser Option wird dieses Verhalten deaktiviert, so dass das Loopback-Interface nicht automatisch konfiguriert wird.
-V, --version
Zeigt Copyright- und Versionsinformationen an.
-v, --verbose
Zeigt die ausgeführten Befehle an.
-l, --list
Für ifquery wird eine Liste aller Interfaces angezeigt, die der angegebenen Klasse entsprechen. Wenn keine Klasse angegeben ist, werden alle als "auto" aufgelisteten Interfaces ausgegeben.
--state
Für ifquery werden die Status der Interfaces ausgegeben. Wenn keine Interfaces angegeben sind, werden alle hochgefahrenen Interfaces zusammen mit den logischen Interfaces, die ihnen zugewiesen sind, ausgegeben, und es wird ein Erfolgscode zurückgegeben. Wenn ein oder mehrere Interfaces angegeben sind, wird nur der Status dieser Interfaces angezeigt; es wird ein Erfolgscode zurückgegeben, wenn alle angegebenen Interfaces hochgefahren sind. Andernfalls wird 0 zurückgegeben.
BEISPIELE
ifup -a
Bringt alle in /etc/network/interfaces mit auto definierten Schnittstellen hoch.
ifup eth0
Bringt die Schnittstelle eth0 hoch.
ifup eth0=home
Bringt die Schnittstelle eth0 als logische Schnittstelle home hoch.
ifdown -a
Bringt alle derzeit aktiven Schnittstellen herunter.
ifquery -l
Gibt die Namen aller mit dem Schlüsselwort auto angegebenen Schnittstellen aus.
ifquery -l --allow=hotplug
Gibt die Namen aller mit dem Schlüsselwort allow-hotplug angegebenen Schnittstellen aus.
ifquery eth0
Zeigt die in der ifupdown-Konfiguration angegebenen Schnittstellenoptionen an. Jedes Schlüssel-Wert-
Paar wird in einer separaten Zeile mit : als Trennzeichen ausgegeben.
HINWEISE
`ifup`, `ifdown` und `ifquery` sind eigentlich dasselbe Programm, das unter verschiedenen Namen aufgerufen wird.
Das Programm konfiguriert Netzwerkschnittstellen nicht direkt, sondern führt stattdessen Low-Level-Dienstprogramme wie
ip aus, um die Arbeit zu erledigen.
Beim Aufruf prüft ifdown, ob ifup noch ausgeführt wird. In diesem Fall wird ein SIGTERM-Signal an ifup gesendet.
Während der Schnittstellende-Konfiguration ignoriert ifdown Fehler, so als ob --ignore-errors angegeben worden wäre.
DATEIEN
/etc/network/interfaces
Definitionen von Netzwerkschnittstellen. Siehe `interfaces(5)` für weitere Informationen.
/run/network/ifstate
Aktueller Status von Netzwerkschnittstellen
KONKURRENZ
^ fupdown verwendet eine Schnittstellen-spezifische Sperrung, um sicherzustellen, dass gleichzeitige ifup- und ifdown-Aufrufe für dieselbe
Schnittstelle nacheinander ausgeführt werden. Aufrufe für verschiedene Schnittstellen können jedoch parallel ausgeführt werden.
RÜCKGABEWERT
Für ifup und ifdown ist der Rückgabewert 0, wenn alle angegebenen Schnittstellen erfolgreich (de)konfiguriert wurden, und 1, wenn ein Fehler aufgetreten ist. Das Ergebnis dieser Befehle ist idempotent; das Ausführen von ifup für eine Schnittstelle, die bereits aktiv ist, führt zu einem Rückgabewert von 0, und in ähnlicher Weise
führt das Ausführen von ifdown für eine Schnittstelle, die nicht aktiv ist, ebenfalls zu einem Rückgabewert von 0.
`ifquery` gibt normalerweise den Rückgabewert 0 zurück, wenn eine Schnittstelle mit einer übereinstimmenden `iface`-Sektion gefunden wurde, und 1,
wenn keine übereinstimmende Sektion gefunden wurde. `ifquery --state` gibt auch den Rückgabewert 1 zurück, wenn die angegebene
Schnittstelle bekannt war, aber nicht aktiv war.
BEKANNTE FEHLER/EINSCHRÄNKUNGEN
Das Programm führt Aufzeichnungen darüber, ob Netzwerkschnittstellen aktiv oder inaktiv sind. Unter außergewöhnlichen Umständen können diese Aufzeichnungen inkonsistent mit den tatsächlichen Zuständen der Schnittstellen werden. Beispielsweise wird eine Schnittstelle, die mit ifup aktiviert und später mit ifconfig deaktiviert wurde, weiterhin als aktiv aufgezeichnet. Um dies zu beheben, können Sie die Option --force verwenden, um ifup oder ifdown zu zwingen, die Konfigurations- oder Deaktivierungskommandos auszuführen, unabhängig davon, welchen aktuellen Zustand der Schnittstelle sie annimmt.
Die Datei /run/network/ifstate muss beschreibbar sein, damit ifup oder ifdown ordnungsgemäß funktionieren. Wenn dieser Speicherort nicht beschreibbar ist (z. B. weil das Root-Dateisystem schreibgeschützt für die Systemwiederherstellung eingebunden ist), sollte /run/network/ifstate in einen beschreibbaren Speicherort als symbolischer Link geändert werden. Wenn dies nicht möglich ist, können Sie die Option --force verwenden, um Konfigurations- oder Deaktivierungskommandos auszuführen, ohne die Datei zu aktualisieren.
Beachten Sie, dass das Programm nicht automatisch ausgeführt wird: ifup allein aktiviert keine Schnittstellen, die als Ergebnis der Installation von Hardware angezeigt werden, und ifdown allein deaktiviert keine Schnittstellen, die als Ergebnis der Entfernung von Hardware verschwinden. Um die Konfiguration von Netzwerkschnittstellen zu automatisieren, müssen Sie andere Pakete wie udev(7) oder ifplugd(8) installieren.
AUTOREN
Die ifupdown-Suite wurde von Anthony Towns <_> erstellt und wird derzeit von Santiago Ruano Rincón <_> und Josue Ortega <_> gepflegt.
Viele andere haben im Laufe der Zeit zur Entwicklung von ifupdown beigetragen, siehe /usr/share/doc/ifupdown/changelog.Debian.gz für eine vollständige Historie.