Funktionen für den Umgang mit der Captive-Portal-Software für offene WLAN-Knoten. Mehr ...

Funktionen
	configure_free_network ()
	Erzeuge das free-Netzwerk-Interface, falls es noch nicht existiert. Mehr ...

	get_on_captive_portal_default (key)
	Liefere einen der default-Werte der aktuellen Firmware zurück (Paket on-captive-portal). Mehr ...

	captive_portal_has_devices ()
	Prüfe, ob dem Captive Portal mindestens ein physisches Netzwerk-Gerät zugeordnet ist. Mehr ...

	captive_portal_repair_empty_network_bridge ()
	Reduziere Konstruktionen wie beispielsweise "bridge(None, wlan0)" zu "wlan0". Mehr ...

	sync_captive_portal_state_with_mig_connections ()
	Synchronisiere den Zustand (up/down) des free-Interface mit dem des VPN-Tunnel-Interface. Mehr ...

	is_captive_portal_running ()
	Prüfe ob das Netzwerk-Interface des Captive-Portal aktiv ist. Mehr ...

	get_captive_portal_client_count ()
	Ermittle die Anzahl der verbundenen Clients. Leere Ausgabe, falls keine aktiven Interfaces vorhanden sind. Mehr ...

	get_captive_portal_clients ()
	Zeilenweise aller aktuellen Clients inklusive ihrer relevanten Kenngrößen. Mehr ...

Ausführliche Beschreibung

Funktionen für den Umgang mit der Captive-Portal-Software für offene WLAN-Knoten.

Dokumentation der Funktionen

◆ captive_portal_has_devices()

captive_portal_has_devices ( )

Prüfe, ob dem Captive Portal mindestens ein physisches Netzwerk-Gerät zugeordnet ist.

Sobald ein Netzwerk-Gerät konfiguriert ist, gilt der Captive-Portal-Dienst als aktiv. Es werden sowohl nicht-wifi-, als auch wifi-Interfaces geprueft.

Definiert in Zeile 18 der Datei on-captive-portal.sh.

◆ captive_portal_repair_empty_network_bridge()

captive_portal_repair_empty_network_bridge ( )

Reduziere Konstruktionen wie beispielsweise "bridge(None, wlan0)" zu "wlan0".

Brücken mit "none"-Elementen verwirren das nodogsplash-Start-Skript.

Definiert in Zeile 22 der Datei on-captive-portal.sh.

◆ configure_free_network()

configure_free_network ( )

Erzeuge das free-Netzwerk-Interface, falls es noch nicht existiert.

Definiert in Zeile 7 der Datei on-captive-portal.sh.

◆ get_captive_portal_client_count()

get_captive_portal_client_count ( )

Ermittle die Anzahl der verbundenen Clients. Leere Ausgabe, falls keine aktiven Interfaces vorhanden sind.

Definiert in Zeile 34 der Datei on-captive-portal.sh.

◆ get_captive_portal_clients()

get_captive_portal_clients ( )

Zeilenweise aller aktuellen Clients inklusive ihrer relevanten Kenngrößen.

In jeder Zeile wird ein Client beschrieben, wobei die folgenden Detailinformationen durch Tabulatoren getrennt sind:

IP-Adresse
MAC-Adresse
Zeitpunkt des Verbindungsaufbaus (seit epoch)
Zeitpunkt der letzten Aktivität (seit epoch)
Download-Verkehrsvolumen (kByte)
Upload-Verkehrsvolumen (kByte) Der Einfachheit halber nehmen wir an, dass alle DHCP-Clients auch Captive-Portal-Clients sind.

Definiert in Zeile 45 der Datei on-captive-portal.sh.

◆ get_on_captive_portal_default()

get_on_captive_portal_default ( key )

Liefere einen der default-Werte der aktuellen Firmware zurück (Paket on-captive-portal).

Parameter

key	Name des Schlüssels

Die default-Werte werden nicht von der Konfigurationsverwaltung uci verwaltet. Somit sind nach jedem Upgrade imer die neuesten Standard-Werte verfügbar.

Definiert in Zeile 13 der Datei on-captive-portal.sh.

◆ is_captive_portal_running()

is_captive_portal_running ( )

Prüfe ob das Netzwerk-Interface des Captive-Portal aktiv ist.

Definiert in Zeile 30 der Datei on-captive-portal.sh.

◆ sync_captive_portal_state_with_mig_connections()

sync_captive_portal_state_with_mig_connections ( )

Synchronisiere den Zustand (up/down) des free-Interface mit dem des VPN-Tunnel-Interface.

Diese Funktion wird nach Statusänderungen des VPN-Interface, sowie innerhalb eines regelmäßigen cronjobs ausgeführt.

Definiert in Zeile 27 der Datei on-captive-portal.sh.