struct apext::tsync::FVContainer

Die Struktur apext::tsync::FVContainer dient im Modul tsync als Datenbehälter zur Übergabe und Rückgabe von Frischewerten zwischen Applikationen und dem Freshness Value Management. Sie kapselt den eigentlichen Frischewert als Byte-Vektor in value, der je nach Richtung vollständige oder verkürzte Werte enthält [SWS_TS_14196], sowie dessen exakte Bitlänge im Attribut length [SWS_TS_14195]. Der nebenläufige Zugriff erfordert eine externe Koordinierung durch den Aufrufer.

mehr ›

Kontext

Die Struktur apext::tsync::FVContainer fungiert innerhalb des Funktionsclusters tsync der AUTOSAR Adaptive Platform als dedizierter Datenbehälter für Frischewerte (Freshness Values). Eingebunden über die Header-Datei apext/tsync/fvm.h dient sie als standardisierte Schnittstelle im Zusammenspiel mit dem Freshness Value Management (FVM). Ihre primäre Verantwortung besteht darin, den eigentlichen kryptografischen Frischewert zusammen mit dessen exakter Länge bereitzustellen. Hierzu kapselt der Container die Bitlänge im Datenelement length [SWS_TS_14195] sowie die eigentlichen Nutzdaten im Byte-Vektor value [SWS_TS_14196]. Die Struktur agiert somit als Brücke zwischen aufrufenden Applikationen oder Protokollschichten und den FVM-Berechnungsroutinen.

Lebenszyklus

Als leichtgewichtige Datenstruktur (struct) unterliegt apext::tsync::FVContainer den regulären Wertesemantiken von C++. Die Erzeugung erfolgt typischerweise lokal auf dem Stack des Aufrufers oder dynamisch im Rahmen einer übergeordneten Nachrichtenerstellung. Mit der Instanziierung übernimmt die Struktur die Verantwortung für den Lebenszyklus des enthaltenen Vektors value vom Typ ara::core::Vector<std::uint8_t> [SWS_TS_14196]. Dürfte die Struktur bei der Übergabe an Schnittstellen per Wert oder Referenz weitergereicht werden, sorgt das RAII-Prinzip des Vektors für eine deterministische Freigabe des allokierten Speichers bei Zerstörung des Containers. Frage Q-416ceca84f9cfdaf (offen) Da apext::tsync::FVContainer keine internen Mechanismen zur Synchronisation bereitstellt, obliegt die thread-sichere Koordination bei nebenläufigem Lese- und Schreibzugriff vollständig der aufrufenden Softwarekomponente.

Nutzungspfad

Im praktischen Einsatz durchläuft apext::tsync::FVContainer zwei zentrale Richtungen innerhalb der Schnittstellenkommunikation:

• Eingabeparameter: Bei der Verifikation oder Verarbeitung eingehender Nachrichten wird der Container von der Applikation befüllt und an Methoden des FVM übergeben. Je nach Kontext nimmt das Feld value dabei entweder vollständige Frischewerte oder gekürzte Werte (Truncated Values) auf [SWS_TS_14196]. Parallel dazu spezifiziert das Feld length die genaue Bitanzahl des enthaltenen Werts [SWS_TS_14195]. Dies ist insbesondere dann von Bedeutung, wenn die Gültigkeit des Frischewerts nicht an einer ganzzahligen Bytegrenze endet.
• Rückgabewert: Bei der Generierung frischer Werte durch das FVM liefert die jeweilige Methode eine Instanz von apext::tsync::FVContainer zurück. Der aufrufende Kontext liest anschließend über length [SWS_TS_14195] die vom FVM ermittelte effektive Länge in Bits aus und extrahiert die korrespondierenden Bytes aus value [SWS_TS_14196], um sie in nachgelagerte Sicherheitsprotokolle einzubetten.

Interpretation: Vermutlich korrespondiert die in length hinterlegte Bitanzahl stets mit der aufgerundeten Byte-Größe des Vektors value, sodass unvollständig genutzte Restbits im letzten Byte des Vektors durch die Längenangabe präzise abgegrenzt werden können. Frage Q-e8feae8a93c14191 (offen)