Umgang mit uci-Netzwerk-Interfaces und Firewall-Zonen. Mehr ...

Funktionen
	has_opennet_dns ()
	Prüfe, ob *.on-Domains aufgelöst werden. Mehr ...

	get_ping_time (target, duration)
	Ermittle die Latenz eines Ping-Pakets auf dem Weg zu einem Ziel. Mehr ...

	get_current_addresses_of_network ()
	Liefere die IP-Adressen eines logischen Interface inkl. Praefix-Laenge (z.B. 172.16.0.1/24, network). Mehr ...

	get_zone_raw_devices ()
	Ermittle die physischen Netzwerkinterfaces, die direkt einer Firewall-Zone zugeordnet sind. Mehr ...

	get_device_of_interface ()
	Ermittle das physische Netzwerk-Gerät, das einem logischen Netzwerk entspricht. Mehr ...

	get_subdevices_of_interface ()
	Ermittle die physischen Netzwerk-Geräte (bis auf wifi), die zu einem logischen Netzwerk-Interface gehören. Mehr ...

	add_interface_to_zone ()
	Fuege ein logisches Netzwerk-Interface zu einer Firewall-Zone hinzu. Mehr ...

	del_interface_from_zone ()
	Entferne ein logisches Interface aus einer Firewall-Zone. Mehr ...

	get_zone_of_device (interface)
	Ermittle die Zone eines physischen Netzwerk-Interfaces. Mehr ...

	get_zone_of_interface (interface)
	Ermittle die Zone eines logischen Netzwerk-Interfaces. Mehr ...

	delete_firewall_zone (zone)
	Lösche eine Firewall-Zone, sowie alle Regeln, die sich auf diese Zone beziehen. Mehr ...

	is_interface_up (interface)
	Prüfe ob ein logisches Netzwerk-Interface aktiv ist. Mehr ...

Ausführliche Beschreibung

Umgang mit uci-Netzwerk-Interfaces und Firewall-Zonen.

Dokumentation der Funktionen

add_interface_to_zone ( )

Fuege ein logisches Netzwerk-Interface zu einer Firewall-Zone hinzu.

Typischerweise ist diese Funktion nur fuer temporaere Netzwerkschnittstellen geeignet.

Definiert in Zeile 39 der Datei network.sh.

del_interface_from_zone ( )

Entferne ein logisches Interface aus einer Firewall-Zone.

Definiert in Zeile 42 der Datei network.sh.

delete_firewall_zone ( zone )

Lösche eine Firewall-Zone, sowie alle Regeln, die sich auf diese Zone beziehen.

Parameter

zone	Name der Zone

Achtung: Anschließend ist ein "apply_changes firewall" erforderlich.

Definiert in Zeile 59 der Datei network.sh.

get_current_addresses_of_network ( )

Liefere die IP-Adressen eines logischen Interface inkl. Praefix-Laenge (z.B. 172.16.0.1/24, network).

Parameter

network logisches Netzwerk-Interface

Es werden sowohl IPv4- als auch IPv6-Adressen zurückgeliefert.

Definiert in Zeile 19 der Datei network.sh.

get_device_of_interface ( )

Ermittle das physische Netzwerk-Gerät, das einem logischen Netzwerk entspricht.

Ein Bridge-Interface wird als Gerät betrachtet und zurückgeliefert (nicht seine Einzelteile).

Definiert in Zeile 28 der Datei network.sh.

get_ping_time	(	target	,
		duration
	)

Ermittle die Latenz eines Ping-Pakets auf dem Weg zu einem Ziel.

Parameter

target	IP oder DNS-Name des Zielhosts
duration	die Dauer der Ping-Kommunikation in Sekunden (falls ungesetzt: 5)

Rückgabe: Ausgabe der mittleren Ping-Zeit in ganzen Sekunden; bei Nichterreichbarkit ist die Ausgabe leer

Definiert in Zeile 14 der Datei network.sh.

get_subdevices_of_interface ( )

Ermittle die physischen Netzwerk-Geräte (bis auf wifi), die zu einem logischen Netzwerk-Interface gehören.

Im Fall eines Bridge-Interface werden nur die beteiligten Komponenten zurückgeliefert. Wifi-Geräte werden nur dann zurückgeliefert, wenn sie Teil einer Bridge sind. Andernfalls sind ihre Namen nicht ermittelbar.

Rückgabe: Der oder die Namen der physischen Netzwerk-Geräte oder nichts.

Definiert in Zeile 35 der Datei network.sh.

get_zone_of_device ( interface )

Ermittle die Zone eines physischen Netzwerk-Interfaces.

Parameter

interface Name eines physischen Netzwerk-Interface (z.B. eth0)

Das Ergebnis ist ein leerer String, falls zu diesem Interface keine Zone existiert oder falls es das Interface nicht gibt.

Definiert in Zeile 48 der Datei network.sh.

get_zone_of_interface ( interface )

Ermittle die Zone eines logischen Netzwerk-Interfaces.

Parameter

interface Name eines logischen Netzwerk-Interface (z.B. eth0)

Das Ergebnis ist ein leerer String, falls zu diesem Interface keine Zone existiert oder falls es das Interface nicht gibt.

Definiert in Zeile 54 der Datei network.sh.

get_zone_raw_devices ( )

Ermittle die physischen Netzwerkinterfaces, die direkt einer Firewall-Zone zugeordnet sind.

Hier werden nicht die logischen Interfaces in die physischen aufgeloest, sondern es wird lediglich der Inhalt des 'devices'-Eintrags einer Firewall-Zone ausgelesen.

Definiert in Zeile 24 der Datei network.sh.

has_opennet_dns ( )

Prüfe, ob *.on-Domains aufgelöst werden.

Rückgabe: Der Exitcode ist Null, falls on-DNS verfügbar ist.

Die maximale Laufzeit dieser Funktion ist auf eine Sekunde begrenzt.

Definiert in Zeile 8 der Datei network.sh.

is_interface_up ( interface )

Prüfe ob ein logisches Netzwerk-Interface aktiv ist.

Parameter

interface Zu prüfendes logisches Netzwerk-Interface

Im Fall eines Bridge-Interface wird sowohl der Status der Bridge (muss aktiv sein), als auch der Status der Bridge-Teilnehmer (mindestens einer muss aktiv sein) geprüft.

Definiert in Zeile 65 der Datei network.sh.