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 (func:,...:)
	Führe eine der in /lib/functions/network.sh definierten Funktionen aus. 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	(	func:	,
		...:
	)

Führe eine der in /lib/functions/network.sh definierten Funktionen aus.

Parameter

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

◆ del_interface_from_zone()

del_interface_from_zone ( )

Entferne ein logisches Interface aus einer Firewall-Zone.

Definiert in Zeile 50 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 67 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). Entspricht der Parameter einem physischen Interface, dann wird es mit gleichem Namen unveraendert wieder zurueckgegeben.

Definiert in Zeile 29 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 77 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 43 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 56 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 62 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 werden nur die physischen Interfaces zurückgegeben.

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