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 ...

	_run_system_network_function ()
	Führe eine der in /lib/functions/network.sh definierten Funktionen aus. func: der Name der Funktion ...: alle anderen Parameter werden der Funktion nach der Zielvariable (also ab Parameter #2) übergeben. 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 ...

	get_ipv4_of_mac (mac)
	Ermittle die IPv4-Adresse zu einer MAC-Adresse. Mehr ...

Ausführliche Beschreibung

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

Dokumentation der Funktionen

◆ _run_system_network_function()

_run_system_network_function ( )

Führe eine der in /lib/functions/network.sh definierten Funktionen aus. func: der Name der Funktion ...: alle anderen Parameter werden der Funktion nach der Zielvariable (also ab Parameter #2) übergeben.

Rückgabe: : die Ausgabe der Funktion

Definiert in Zeile 35 der Datei network.sh.

◆ add_interface_to_zone()

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 46 der Datei network.sh.

◆ del_interface_from_zone()

del_interface_from_zone ( )

Entferne ein logisches Interface aus einer Firewall-Zone.

Definiert in Zeile 49 der Datei network.sh.

◆ delete_firewall_zone()

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 66 der Datei network.sh.

◆ get_current_addresses_of_network()

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()

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_ipv4_of_mac()

get_ipv4_of_mac ( mac )

Ermittle die IPv4-Adresse zu einer MAC-Adresse.

Parameter

mac	MAC-Adresse eines Nachbarn

Definiert in Zeile 76 der Datei network.sh.

◆ get_ping_time()

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()

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 42 der Datei network.sh.

◆ get_zone_of_device()

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 55 der Datei network.sh.

◆ get_zone_of_interface()

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 61 der Datei network.sh.

◆ get_zone_raw_devices()

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()

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()

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 72 der Datei network.sh.