namespace ara::fw

Der Namensraum ara::fw stellt Typen und Schnittstellen für die Firewall-Steuerung sowie deren standardisierte Fehlerbehandlung in der AUTOSAR Adaptive Platform bereit. Das Modul definiert mit FirewallStateSwitchInterface eine Schnittstelle für Firewall-Zustände und erzeugt über die thread-sichere Funktion MakeErrorCode typisierte Fehlerobjekte auf Basis der Fehlerdomäne FwErrorDomain [AP_SWS_Fw_83003]. Auftretende Probleme werden durch die Enumeration FwErrc abgebildet, die unter anderem nicht verfügbare Dienste oder ungültige zustandsabhängige Konfigurationen anzeigt [AP_SWS_Fw_83001]. Alle Kernfunktionen zur Fehlererzeugung sind thread-sicher und als noexcept deklariert.

mehr ›

Kontext

Der Namensraum ara::fw bündelt die Programmierschnittstellen und Typen für die Firewall-Funktionalität der AUTOSAR Adaptive Platform im Release R25-11. Die primäre Rolle des Moduls besteht in der Bereitstellung von Mechanismen zur Filterung und Absicherung der fahrzeuginternen Netzwerkkommunikation. Zu den Kernbestandteilen des Namensraums gehören die Schnittstelle FirewallStateSwitchInterface sowie die Komponenten zur standardisierten Fehlerbehandlung, bestehend aus FwErrorDomain, FwException und den zugehörigen Fehlercodes. Die Architektur fügt sich nahtlos in das Plattform-Fehlerkonzept von ara::core ein. Externe Interaktionspartner wie zustandsverwaltende Plattformdienste oder Applikationen nutzen den Namensraum, um sicherheitsrelevante Firewall-Zustände zu steuern oder aufgetretene Ausführungsfehler aufzulösen. Interpretation: Die Klasse FirewallStateSwitchInterface dient vermutlich als primäre Schnittstelle zur Aktivierung und Umschaltung von Regelsätzen in Abhängigkeit vom übergeordneten Systemzustand. Frage Q-d4ba0994e0147cf1 (offen)

Kontextdiagramm: Zusammenspiel von Anwendung, FirewallStateSwitchInterface und FwErrorDomain bei der Fehlerauflösung. Quellen: [AP_SWS_Fw_83001], [AP_SWS_Fw_83002], [AP_SWS_Fw_83003].

Nutzungspfad

Der typische Nutzungspfad im Namensraum ara::fw umfasst die Initiierung von Zustandsänderungen sowie die Erzeugung, Weitergabe und Auswertung von Fehlerzuständen bei der Ausführung von Firewall-Funktionen. Schlägt eine Operation im Kontext von FirewallStateSwitchInterface fehl oder kann eine Zustandsanforderung nicht erfüllt werden, greift das Modul auf die spezifische Fehlerdomäne zu, um dem Aufrufer ein präzises Diagnoseergebnis zu liefern. Zur Instanziierung eines solchen Fehlers wird die Funktion MakeErrorCode aufgerufen [AP_SWS_Fw_83003]. Diese Funktion erzeugt einen ara::core::ErrorCode, indem sie einen Fehlerwert aus FwErrc [AP_SWS_Fw_83001] und optionale herstellerspezifische Zusatzdaten vom Typ ara::core::ErrorDomain::SupportDataType entgegennimmt [AP_SWS_Fw_83003]. Da MakeErrorCode als constexpr und noexcept deklariert ist, kann die Fehlercode-Erstellung ressourcenschonend und deterministisch erfolgen.

Aufruferseitig wird der zurückgegebene Fehler meist in einem Ergebnisobjekt (wie ara::core::Result) empfangen. Zur programmgesteuerten Verifikation der Fehlerherkunft dient die freie Funktion GetFwErrorDomain [AP_SWS_Fw_83002], welche eine konstante Referenz auf das Singleton der Fehlerdomäne FwErrorDomain liefert. Aufrufer können damit abgleichen, ob ein aufgetretener Fehler tatsächlich aus dem Firewall-Modul stammt, und dessen textuelle Beschreibung ermitteln. Interpretation: In Systemarchitekturen, die C++-Ausnahmen einsetzen, dient die Klasse FwException vermutlich dem Zweck, den ara::core::ErrorCode abfangbar zu kapseln und synchron an übergeordnete Fehlerbehandlungsroutinen weiterzuleiten. Frage (offen)

Fehlerszenarien

Für Fehlersituationen definiert die Enumeration FwErrc im Namensraum ara::fw spezifische Fehlerursachen für die Fehlerdomäne FwErrorDomain [AP_SWS_Fw_83001]. Die Header-Datei ara/fw/fw_error_domain.h deklariert dabei folgende standardisierte Fehlerzustände:

• kServiceNotAvailable (Wert 1): Kennzeichnet, dass der adressierte Firewall-Dienst zur Laufzeit nicht erreichbar oder gegenwärtig nicht betriebsbereit ist [AP_SWS_Fw_83001]. Mögliche Ursachen liegen in noch nicht initialisierten Hintergrundkomponenten oder temporären Verbindungsabbrüchen. Vorbedingungen für nachfolgende Aufrufe sind nicht erfüllt, sodass Aufrufer den Dienststatus abfragen oder die Anfrage zu einem späteren Zeitpunkt wiederholen müssen.
• kInvalidStateDependentFirewall (Wert 2): Tritt auf, wenn eine angeforderte zustandsabhängige Firewall-Konfiguration ungültig ist oder ein ungültiger Zustandsübergang angefordert wurde [AP_SWS_Fw_83001]. Vorbedingung für erfolgreiche Umschaltoperationen ist, dass die Ziel-Firewall die gewünschten Zustände unterstützt und das System sich in einem zulässigen Grundzustand befindet. Nach Auftreten dieses Fehlers verbleibt die Firewall unverändert im bisherigen Schutzmodus.

Beide Fehlerwerte basieren auf dem Basistyp ara::core::ErrorDomain::CodeType [AP_SWS_Fw_83001]. Die Funktionen GetFwErrorDomain [AP_SWS_Fw_83002] und MakeErrorCode [AP_SWS_Fw_83003] sind ausdrücklich als thread-sicher (thread-safe) und noexcept deklariert, wodurch eine sichere Fehlerbehandlung auch in hochgradig nebenläufigen oder zeitkritischen Kontexten gewährleistet ist.