namespace ara::fw

De namespace ara::fw stelt typen en interfaces voor de Firewall-besturing alsmede de gestandaardiseerde foutafhandeling daarvan in het AUTOSAR Adaptive Platform beschikbaar. De module definieert met FirewallStateSwitchInterface een interface voor Firewall-toestanden en genereert via de thread-veilige functie MakeErrorCode getypeerde foutobjecten op basis van het foutdomein FwErrorDomain [AP_SWS_Fw_83003]. Optredende problemen worden gerepresenteerd door de enumeratie FwErrc, die onder meer niet-beschikbare diensten of ongeldige toestandafhankelijke configuraties aangeeft [AP_SWS_Fw_83001]. Alle kernfuncties voor het genereren van fouten zijn thread-veilig en gedeclareerd als noexcept.

meer ›

Context

De namespace ara::fw bundelt de programmeerinterfaces en typen voor de Firewall-functionaliteit van het AUTOSAR Adaptive Platform in release R25-11. De primaire rol van de module bestaat uit het beschikbaar stellen van mechanismen voor het filteren en beveiligen van de voertuiginterne netwerkcommunicatie. Tot de kernonderdelen van de namespace behoren de interface FirewallStateSwitchInterface alsmede de componenten voor gestandaardiseerde foutafhandeling, bestaande uit FwErrorDomain, FwException en de bijbehorende foutcodes. De architectuur sluit naadloos aan op het platform-foutconcept van ara::core. Externe interactiepartners zoals toestandbeherende platformdiensten of applicaties gebruiken de namespace om veiligheidsrelevante Firewall-toestanden te besturen of opgetreden uitvoeringsfouten op te lossen. Interpretatie: De klasse FirewallStateSwitchInterface dient vermoedelijk als primaire interface voor het activeren en omschakelen van regelsets afhankelijk van de overkoepelende systeemtoestand. Vraag Q-d4ba0994e0147cf1 (open)

Contextdiagram: Samenspel van toepassing, FirewallStateSwitchInterface en FwErrorDomain bij de foutoplossing. Bronnen: [AP_SWS_Fw_83001], [AP_SWS_Fw_83002], [AP_SWS_Fw_83003].

Gebruikspad

Het typische gebruikstraject in de namespace ara::fw omvat het initiëren van toestandsveranderingen alsmede het genereren, doorgeven en evalueren van fouttoestanden bij de uitvoering van Firewall-functies. Faalt een operatie in de context van FirewallStateSwitchInterface of kan er niet worden voldaan aan een toestandsverzoek, dan grijpt de module terug op het specifieke foutdomein om de aanroeper een nauwkeurig diagnoseresultaat te leveren. Voor de instantiatie van een dergelijke fout wordt de functie MakeErrorCode aangeroepen [AP_SWS_Fw_83003]. Deze functie genereert een ara::core::ErrorCode door een foutwaarde uit FwErrc [AP_SWS_Fw_83001] en optionele fabrikantspecifieke aanvullende gegevens van het type ara::core::ErrorDomain::SupportDataType aan te nemen [AP_SWS_Fw_83003]. Aangezien MakeErrorCode is gedeclareerd als constexpr en noexcept, kan de creatie van de foutcode resourcebesparend en deterministisch plaatsvinden.

Aanroeperszijde wordt de geretourneerde fout meestal ontvangen in een resultaatobject (zoals ara::core::Result). Voor de programmagestuurde verificatie van de foutherkomst dient de vrije functie GetFwErrorDomain [AP_SWS_Fw_83002], die een constante referentie naar de singleton van het foutdomein FwErrorDomain levert. Aanroepers kunnen daarmee verifiëren of een opgetreden fout daadwerkelijk afkomstig is uit de Firewall-module en de tekstuele beschrijving ervan bepalen. Interpretatie: In systeemarchitecturen die C++-uitzonderingen hanteren, dient de klasse FwException vermoedelijk het doel om de ara::core::ErrorCode opvangbaar in te kapselen en synchroon door te geven aan bovenliggende foutafhandelingsroutines. Vraag (open)

Foutscenario's

Voor foutsituaties definieert de enumeratie FwErrc in de namespace ara::fw specifieke foutoorzaken voor het foutdomein FwErrorDomain [AP_SWS_Fw_83001]. Het headerbestand ara/fw/fw_error_domain.h declareert daarbij de volgende gestandaardiseerde fouttoestanden:

• kServiceNotAvailable (waarde 1): Geeft aan dat de geadresseerde Firewall-dienst tijdens runtime niet bereikbaar of momenteel niet bedrijfsklaar is [AP_SWS_Fw_83001]. Mogelijke oorzaken liggen in nog niet geïnitialiseerde achtergrondcomponenten of tijdelijke verbindingsverbrekingen. Aan randvoorwaarden voor opvolgende aanroepen is niet voldaan, zodat aanroepers de servicestatus moeten opvragen of het verzoek op een later tijdstip moeten herhalen.
• kInvalidStateDependentFirewall (waarde 2): Treedt op wanneer een aangevraagde toestandafhankelijke Firewall-configuratie ongeldig is of er een ongeldige toestandsovergang is aangevraagd [AP_SWS_Fw_83001]. Een randvoorwaarde voor succesvolle omschakeloperaties is dat de doel-Firewall de gewenste toestanden ondersteunt en dat het systeem zich in een toelaatbare basistoestand bevindt. Na het optreden van deze fout blijft de Firewall ongewijzigd in de tot dusver geldende beveiligingsmodus.

Beide foutwaarden zijn gebaseerd op het basistype ara::core::ErrorDomain::CodeType [AP_SWS_Fw_83001]. De functies GetFwErrorDomain [AP_SWS_Fw_83002] en MakeErrorCode [AP_SWS_Fw_83003] zijn uitdrukkelijk gedeclareerd als thread-veilig (thread-safe) en noexcept, waardoor een veilige foutafhandeling ook in sterk gelijktijdige of tijdkritische contexten gewaarborgd is.