structure apext::tsync::FVContainer

La structure apext::tsync::FVContainer sert, dans le module tsync, de conteneur de données pour la transmission et le renvoi de valeurs de fraîcheur entre les applications et le Freshness Value Management. Elle encapsule la valeur de fraîcheur proprement dite sous forme de vecteur d'octets dans value, qui contient des valeurs complètes ou tronquées selon le sens [SWS_TS_14196], ainsi que sa longueur exacte en bits dans l'attribut length [SWS_TS_14195]. L'accès concurrent requiert une coordination externe par l'appelant.

plus ›

Contexte

Au sein du cluster fonctionnel tsync de l'AUTOSAR Adaptive Platform, la structure apext::tsync::FVContainer fait office de conteneur de données dédié pour les valeurs de fraîcheur (Freshness Values). Incluse via le fichier d'en-tête apext/tsync/fvm.h, elle sert d'interface standardisée en interaction avec le Freshness Value Management (FVM). Sa responsabilité principale consiste à mettre à disposition la valeur de fraîcheur cryptographique proprement dite avec sa longueur exacte. Pour cela, le conteneur encapsule la longueur en bits dans l'élément de données length [SWS_TS_14195] ainsi que les données utiles réelles dans le vecteur d'octets value [SWS_TS_14196]. La structure fait ainsi office de pont entre les applications ou couches de protocole appelantes et les routines de calcul du FVM.

Cycle de vie

En tant que structure de données légère (struct), apext::tsync::FVContainer est soumise aux sémantiques de valeur régulières du C++. La création s'effectue généralement localement sur la pile de l'appelant ou dynamiquement dans le cadre d'une création de message de niveau supérieur. Dès son instanciation, la structure prend en charge la responsabilité du cycle de vie du vecteur contenu value de type ara::core::Vector<std::uint8_t> [SWS_TS_14196]. Si la structure venait à être transmise par valeur ou par référence lors du passage aux interfaces, le principe RAII du vecteur assure une libération déterministe de la mémoire allouée lors de la destruction du conteneur. Question Q-416ceca84f9cfdaf (ouverte) Comme apext::tsync::FVContainer ne fournit aucun mécanisme interne de synchronisation, la coordination sûre pour les threads en cas d'accès concurrent en lecture et en écriture incombe entièrement au composant logiciel appelant.

Parcours d'utilisation

En pratique, apext::tsync::FVContainer traverse deux directions centrales au sein de la communication d'interface :

• Paramètre d'entrée : lors de la vérification ou du traitement de messages entrants, le conteneur est rempli par l'application et transmis aux méthodes du FVM. Selon le contexte, le champ value reçoit alors soit des valeurs de fraîcheur complètes, soit des valeurs tronquées (Truncated Values) [SWS_TS_14196]. En parallèle, le champ length spécifie le nombre exact de bits de la valeur contenue [SWS_TS_14195]. Cela revêt une importance particulière lorsque la validité de la valeur de fraîcheur ne se termine pas sur une frontière d'octet entière.
• Valeur de retour : lors de la génération de valeurs fraîches par le FVM, la méthode concernée renvoie une instance de apext::tsync::FVContainer. Le contexte appelant lit ensuite via length [SWS_TS_14195] la longueur effective en bits déterminée par le FVM et extrait les octets correspondants de value [SWS_TS_14196] afin de les intégrer dans les protocoles de sécurité en aval.

Interpretation : le nombre de bits stocké dans length correspond probablement toujours à la taille en octets arrondie à l’unité supérieure du vecteur value, de sorte que les bits résiduels incomplètement utilisés dans le dernier octet du vecteur peuvent être délimités avec précision par l’indication de longueur. Question Q-e8feae8a93c14191 (ouverte)