struct apext::tsync::FVContainer

De structuur apext::tsync::FVContainer dient in de module tsync als datacontainer voor de overdracht en teruggave van freshness-waarden tussen applicaties en het Freshness Value Management. Zij kapselt de eigenlijke freshness-waarde in als byte-vector in value, die afhankelijk van de richting volledige of verkorte waarden bevat [SWS_TS_14196], evenals de exacte bitlengte ervan in het attribuut length [SWS_TS_14195]. Gelijktijdige toegang vereist externe coördinatie door de aanroeper.

meer ›

Context

De structuur apext::tsync::FVContainer fungeert binnen het functionele cluster tsync van het AUTOSAR Adaptive Platform als een specifieke datacontainer voor freshness-waarden (Freshness Values). Geïntegreerd via het headerbestand apext/tsync/fvm.h dient zij als gestandaardiseerde interface in het samenspel met het Freshness Value Management (FVM). Haar primaire verantwoordelijkheid bestaat uit het beschikbaar stellen van de eigenlijke cryptografische freshness-waarde samen met de exacte lengte daarvan. Hiertoe kapselt de container de bitlengte in het gegevenselement length [SWS_TS_14195] in, evenals de eigenlijke payload in de byte-vector value [SWS_TS_14196]. De structuur fungeert daarmee als brug tussen aanroepende applicaties of protocollaagfuncties en de FVM-berekeningsroutines.

Levenscyclus

Als lichtgewicht datastructuur (struct) is apext::tsync::FVContainer onderhevig aan de reguliere waardesemantiek van C++. De creatie gebeurt typisch lokaal op de stack van de aanroeper of dynamisch in het kader van het opstellen van een overkoepelend bericht. Bij instantiëring neemt de structuur de verantwoordelijkheid op zich voor de levenscyclus van de ingesloten vector value van het type ara::core::Vector<std::uint8_t> [SWS_TS_14196]. Wordt de structuur bij de overdracht aan interfaces op waarde of referentie doorgegeven, dan zorgt het RAII-principe van de vector voor een deterministische vrijgave van het gealloceerde geheugen bij vernietiging van de container. Vraag Q-416ceca84f9cfdaf (open) Aangezien apext::tsync::FVContainer geen interne mechanismen voor synchronisatie biedt, berust de thread-veilige coördinatie bij gelijktijdige lees- en schrijftoegang volledig bij de aanroepende softwarecomponent.

Gebruikspad

In de praktijk doorloopt apext::tsync::FVContainer twee centrale richtingen binnen de interfacecommunicatie:

• Invoerparameter: Bij de verificatie of verwerking van inkomende berichten wordt de container door de applicatie gevuld en overgedragen aan methoden van het FVM. Afhankelijk van de context neemt het veld value daarbij hetzij volledige freshness-waarden, hetzij verkorte waarden (Truncated Values) op [SWS_TS_14196]. Parallel daaraan specificeert het veld length het exacte aantal bits van de opgenomen waarde [SWS_TS_14195]. Dit is met name van belang wanneer de geldigheid van de freshness-waarde niet op een gehele bytegrens eindigt.
• Retourwaarde: Bij het genereren van verse waarden door het FVM levert de desbetreffende methode een instantie van apext::tsync::FVContainer terug. De aanroepende context leest vervolgens via length [SWS_TS_14195] de door het FVM bepaalde effectieve lengte in bits uit en extraheert de corresponderende bytes uit value [SWS_TS_14196] om deze in te bedden in achterliggende beveiligingsprotocollen.

Interpretatie: Vermoedelijk correspondeert het in length opgeslagen aantal bits altijd met de naar boven afgeronde bytegrootte van de vector value, zodat onvolledig gebruikte restbits in de laatste byte van de vector nauwkeurig kunnen worden afgebakend door de lengteopgave. Vraag Q-e8feae8a93c14191 (open)