DEENESPTFRRUARHIKOZHNL

class apext::com::secoc::FVM

[SWS_CM_11287] Upstream: RS_CM_00801, RS_CM_00802, RS_CM_00803, RS_CM_00804

class FVM {...};

A freshness value management interface to be implemented by the OEM/stack vendor. To be used by the freshness value management library implementer either OEM or stack vendor. The class will have a single instance in the CM.

Header-Datei#include "apext/com/secoc/fvm.h"
Forwarding-Header#include "apext/com/com_fwd.h"
Scopenamespace apext::com::secoc

User GuideKI-GENERIERT

Stellt dem Kommunikationsmanagement eine Schnittstelle zur herstellerspezifischen Frischewertverwaltung für SecOC bereit.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: e018cf5c19e4 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Stellt dem Kommunikationsmanagement eine Schnittstelle zur herstellerspezifischen Frischewertverwaltung für SecOC bereit.

Die Klasse dient als durch OEM oder Stack-Hersteller implementierte Schnittstelle zur Bereitstellung und Verwaltung von Frischewerten für SecOC im Kommunikationsmanagement [SWS_CM_11287]. Sie versorgt ara::com beim Senden und Empfangen gesicherter Botschaften über GetTxFreshness() und GetRxFreshness() mit Frischewerten und nimmt über SetVerificationStatus() das Verifikationsergebnis entgegen [SWS_CM_11274] [SWS_CM_11276]. Ihr Lebenszyklus wird dabei vollständig als Singleton von ara::com verwaltet [SWS_CM_11272].

Kontext

Die Klasse apext::com::secoc::FVM definiert die standardisierte Schnittstelle für das Freshness Value Management (FVM) innerhalb des Kommunikationsmanagements von AUTOSAR Adaptive [SWS_CM_11287]. Sie fungiert als Erweiterungspunkt (Plugin-Schnittstelle), der durch den OEM oder den Stack-Hersteller implementiert wird, um anwendungsspezifische Frischewerte für die nachrichtengenaue Absicherung bereitzustellen AUTOSAR_AP_SWS_CommunicationManagement §C.1.2 „Class: FVM“. Zu den Interaktionspartnern gehören das Kommunikationsmanagement (ara::com), das kryptografische Absicherungsmodul SecOC sowie die spezifische FVM-Bibliothek des Herstellers.

FVMKontext CM Communication Management (ara::com) FVM FVM-Schnittstelle (apext::com::secoc::FVM) CM->FVM steuert Lifecycle, fordert Frischewerte an LIB FVM-Implementierung (OEM / Stack Vendor) LIB->FVM implementiert

Kontextdiagramm: Einbettung der FVM-Schnittstelle zwischen Kommunikationsmanagement und herstellerspezifischer Frischewert-Bibliothek. Quellen: [SWS_CM_11272], [SWS_CM_11287], AUTOSAR_AP_SWS_CommunicationManagement §C.1.2 „Class: FVM“

Lebenszyklus

Innerhalb des Kommunikationsmanagements existiert genau eine einzige Instanz dieser Klasse AUTOSAR_AP_SWS_CommunicationManagement §C.1.2 „Class: FVM“. Der gesamte Lebenszyklus der SecOC-FreshnessValueManager-Implementierung wird vollständig durch ara::com gesteuert [SWS_CM_11272]. Die Initialisierung der FVM-Implementierung erfolgt verpflichtend über den Aufruf der Methode Initialize() [SWS_CM_11273] [SWS_CM_11290]. Sämtliche Methoden der Schnittstelle sind als ausnahmesicher (noexcept) deklariert [SWS_CM_11288]. Interpretation: Da die Instanzierung und Lebenszyklusverwaltung intern durch ara::com erfolgt, obliegt der konkreten FVM-Plugin-Implementierung die interne Synchronisation gegen nebenläufige Aufrufe durch mehrere Kommunikationskanäle. Frage Q-02e8eaeef2145dbb (offen)

Nutzungspfad

Im laufenden Betrieb unterscheidet das Kommunikationsmanagement zwischen dem Senden und dem Empfangen gesicherter Nachrichten:

  • Sendeoperation: Wenn eine Nachricht für die SecOC-Übertragung konfiguriert ist und eine freshnessValueId besitzt, ruft das Kommunikationsmanagement GetTxFreshness() mit der Frischewert-ID auf [SWS_CM_11274] [SWS_CM_11289]. Bei erfolgreicher Rückgabe wird der Frischewert im FVContainer für die Berechnung des Authenticators (MAC) herangezogen, welche nach den Berechnungen zur E2E-Absicherung stattfindet [SWS_CM_11274].
  • Empfangsoperation: Sofern die Verifikation eingehender Nachrichten nicht durch die Konfiguration umgangen wird [SWS_CM_11372], ruft SecOC vor der E2E-Prüfung GetRxFreshness() auf [SWS_CM_11276] [SWS_CM_11288]. Dabei werden die SecOCFreshnessValueID, der empfangene gekürzte Frischewert (SecOCTruncatedFreshnessValue) sowie die Anzahl bisheriger Verifikationsversuche (SecOCAuthVerifyAttempts) übergeben [SWS_CM_11288]. Nach Abgleich des berechneten Authenticators meldet das Kommunikationsmanagement das Ergebnis via SetVerificationStatus() unter Angabe des VerificationStatus zurück an die FVM [SWS_CM_19999] [SWS_CM_11378].
Verifikationsablauf beim Empfang einer SecOC-gesicherten Nachrichtara::com (SecOC)apext::com::secoc::FVMGetRxFreshness(ID, TruncatedFV, Attempts)Result<FVContainer>MAC berechnen und verifizierenSetVerificationStatus(ID, Status)Result<void>

Sequenzdiagramm: Verifikationsablauf beim Empfang einer gesicherten Nachricht mit Frischewert-Abfrage und Statusrückmeldung. Quellen: [SWS_CM_11276], [SWS_CM_11288], [SWS_CM_19999], AUTOSAR_AP_SWS_CommunicationManagement §8.1 „SecOC secure channel reception“

Fehlerszenarien

Fehler werden über Rückgabetypen des Typs ara::core::Result signalisiert:

  • Initialisierungsfehler: Schlägt die Vorbereitung der FVM-Implementierung fehl, liefert Initialize() den Fehlercode ComSecOcFvmErrc::kFVInitializeFailed [SWS_CM_11290].
  • Nicht verfügbarer Frischewert: Können Sende- oder Empfangsfrischewerte temporär nicht ermittelt werden, geben GetTxFreshness() und GetRxFreshness() den Fehler ComSecOcFvmErrc::kFVNotAvailable zurück [SWS_CM_11288] [SWS_CM_11289].
  • Wiederholversuche beim Senden: Liefert GetTxFreshness() den wiederherstellbaren Fehler kFVNotAvailable oder misslingt die Authenticator-Berechnung, inkrementiert das System einen Authentication Build Counter [SWS_CM_11275]. Das Sichern der Nachricht wird herstellerspezifisch wiederholt; erreicht der Zähler das konfigurierte Limit SecOCAuthenticationBuildAttempts, wird die Nachricht verworfen [SWS_CM_11275] AUTOSAR_AP_SWS_CommunicationManagement §8.1 „SecOC secure message build attempts“.
  • Statusmeldungen bei Verifikationsfehlschlägen: Über SetVerificationStatus() werden spezifische Fehlermodi wie kSecOcVerificationFailure, kSecOcFreshnessFailure oder kSecOcAuthenticationBuildFailure an die FVM gemeldet [SWS_CM_19999] [SWS_CM_11378].

Dieser Klassen-Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive R25-11 und wurde automatisiert erstellt.

Mitgliederkarte

Methoden

4
GetRxFreshnessGetTxFreshnessInitializeSetVerificationStatus

Enumerationen

1
VerificationStatus

Klassendiagramm

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G napext__com__secoc__FVM451 FVM + GetRxFreshness() + GetTxFreshness() + Initialize() + SetVerificationStatus()

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Methoden

GetRxFreshness function

Used by the SecOC to obtain the current freshness value.

ara::core::Result< FVContainer > GetRxFreshness (std::uint16_t Sec OCFreshnessValueID, const FVContainer &SecOCTruncatedFreshnessValue, std::uint16_t SecOCAuthVerifyAttempts) noexcept;
GetTxFreshness function

Used by the SecOC to obtain the current freshness value

ara::core::Result< FVContainer > GetTxFreshness (std::uint16_t Sec OCFreshnessValueID) noexcept;
Initialize function

Initializes FVM plugin implementation

ara::core::Result< void > Initialize () noexcept;
SetVerificationStatus function

This method is used by the SecOC to report all verification statuses to the Freshness Value Manager.

ara::core::Result< void > SetVerificationStatus (std::uint16_t sec OCFreshnessValueID, VerificationStatus secOCVerificationStatus) noexcept;

Enumerationen

VerificationStatus enumeration

Defines the status of a verification

enum class VerificationStatus : std::uint8_t {...};

Dokumentation der Methoden

function GetRxFreshness [SWS_CM_11288] Upstream: RS_CM_00801, RS_CM_00802, RS_CM_00803, RS_CM_00804

ara::core::Result< FVContainer > GetRxFreshness (std::uint16_t Sec OCFreshnessValueID, const FVContainer &SecOCTruncatedFreshnessValue, std::uint16_t SecOCAuthVerifyAttempts) noexcept;

Used by the SecOC to obtain the current freshness value.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 2598e93ae192 Herkunft Offene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Elementfunktion apext::com::secoc::FVM::GetRxFreshness dient der SecOC-Schicht zur Ermittlung des vollständigen Frischewerts für empfangene Nachrichten [SWS_CM_11288]. Als Eingabeparameter erwartet die Funktion die Kennung SecOCFreshnessValueID, den aus der gesicherten Nachricht extrahierten verkürzten Frischewert im FVContainer gemäß [SWS_CM_11286] sowie den Zähler SecOCAuthVerifyAttempts [SWS_CM_11288]. Dieser Zähler beginnt beim ersten Verifikationsversuch mit dem Wert 0 und wird bei jedem nachfolgenden Fehlversuch derselben Nachricht inkrementiert [SWS_CM_11288].

Die Methode ist als noexcept und ausnahmesicher spezifiziert (AUTOSAR_AP_SWS_CommunicationManagement §C.1.2.2.1.1 „GetRxFreshness“). Durch die direkte Rückgabe eines ara::core::Result<FVContainer> ohne Future-Typ dürfte der Aufruf synchron blockierend abgewickelt werden. Frage Q-2609cb9ffeb0d41d (offen) Im Erfolgsfall enthält das Ergebnis den vollständigen Frischewert zur anschließenden MAC-Verifikation des Authenticators [SWS_CM_11288]. Kann der Wert nicht bereitgestellt werden, gibt die Funktion den behebbaren Fehlercode ComSecOcFvmErrc::kFVNotAvailable zurück [SWS_CM_11288].

Die Frischewertermittlung ist integraler Bestandteil des SecOC-Empfangspfads: Die Nachrichtenauthentifizierung erfolgt grundsätzlich vor nachgelagerten E2E-Prüfungen [SWS_CM_11276] und ist mit dem Zähler für Authentifizierungsversuche gekoppelt [SWS_CM_11277]. Spezifische Anforderungen an Reentranz oder Thread-Sicherheit werden im Standard nicht definiert; das Verhalten bei parallelen Aufrufen dürfte daher von der konkreten Implementierung des Freshness Value Managers abhängen. Frage Q-071e92f80c6e44db (offen)

Automatisch generierter Nutzungshinweis auf Basis der Spezifikation AUTOSAR R25-11.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "apext/com/secoc/fvm.h"
Scopeclass apext::com::secoc::FVM
Exception-Sicherheitexception safe

Template-Parameter

ParameterBeschreibung
FVContainerAs per [SWS_CM_11286]

Parameter (in)

ParameterBeschreibung
SecOCFreshnessValueIDSecOCTruncatedFreshnessValueSecOCAuthVerifyAttemptsthe identifier of the freshness value. the apext::com::secoc::FVContainer with the values from the received Secured I-PDU/ message the number of authentication verify attempts of this I-PDU/message since the last reception. The value is 0 for the first attempt and incremented on every unsuccessful verification attempt.

Rückgabewert

TypBeschreibung
ara::core::Result<FVContainer >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a apext::com:: secoc::FVContainer that holds the freshness value to be used for the calculation of the authenticator by the SecOC or recoverable error. • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComSecOcFvmErrc::kFVNotAvailablerollback_semantics Freshness Value not available

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11288
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11288@rel:R25-11#ce9299c3
Content hash
ce9299c3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11288
Status: valid/unmigrated Version: rel:R25-11#6d652806 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11288@rel:R25-11#6d652806
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#ce9299c32026-09-30
  • R20-11rel:R20-11#2d3cd3ce2026-10-14
  • R21-11rel:R21-11#2d3cd3ce2026-10-14
  • R22-11rel:R22-11#93c431962026-10-14
  • R23-11rel:R23-11#c565fe5b2026-10-14
  • R24-11rel:R24-11#13a0e3ec2026-10-14
  • R25-11rel:R25-11#6d6528062026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function GetTxFreshness [SWS_CM_11289] Upstream: RS_CM_00801, RS_CM_00802, RS_CM_00803, RS_CM_00804

ara::core::Result< FVContainer > GetTxFreshness (std::uint16_t Sec OCFreshnessValueID) noexcept;

Used by the SecOC to obtain the current freshness value

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 2603f24c27c0 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die synchrone Bibliotheksfunktion apext::com::secoc::FVM::GetTxFreshness ([SWS_CM_11289]) dient der SecOC-Verarbeitung zur Beschaffung des aktuellen Frischewerts beim Senden gesicherter Botschaften über das Communication Management ([SWS_CM_11274], AUTOSAR_AP_SWS_CommunicationManagement S. 224 „SecOC secure channel sending“).

Verwendung und Aufrufkontext

Der Aufruf erfolgt durch ara::com, sofern für das jeweilige Service-Interface-Element in der Konfiguration eine freshnessValueId hinterlegt ist ([SWS_CM_11274]):

  • Parameter: SecOCFreshnessValueID (Typ std::uint16_t) identifiziert den anzufordernden Frischewert ([SWS_CM_11289]).
  • Rückgabewert: Ein ara::core::Result<FVContainer> ([SWS_CM_11289]). Im Erfolgsfall enthält dieses einen apext::com::secoc::FVContainer ([SWS_CM_11286]), dessen Frischewert für die anschließende Authenticator- bzw. MAC-Berechnung genutzt wird ([SWS_CM_11274]).
  • Exception-Sicherheit: Die Funktion ist als noexcept deklariert ([SWS_CM_11289]).

Fehlerbehandlung und Randbedingungen

Kann kein gültiger Frischewert bereitgestellt werden, liefert die Funktion ein ara::core::Result mit dem Fehlercode ComSecOcFvmErrc::kFVNotAvailable („Freshness Value not available“) mit Rollback-Semantik zurück ([SWS_CM_11289]). Spezifische Meldungen an DET oder DEM sind für diese Schnittstelle im Adaptive-Standard nicht definiert.

Ablauf und Nebenläufigkeit

Innerhalb des Sendevorgangs unterliegt der Aufruf einer strikten Reihenfolge ([SWS_CM_11274]):

  1. Zuvor muss der Lebenszyklus des Freshness Value Managers durch ara::com verwaltet ([SWS_CM_11272]) und die Instanz via apext::com::secoc::FVM::Initialize initialisiert worden sein ([SWS_CM_11273]).
  2. Beim Senden erfolgt GetTxFreshness nachgelagert zu den E2E-Schutzberechnungen ([SWS_CM_11274]).
  3. Anschließend werden MAC-Berechnung, optionale Trunkierungen und die Zusammensetzung der gesicherten Nachricht vorgenommen ([SWS_CM_11274]).

Zur Reentranz schweigt die Spezifikation; vermutlich muss die FVM-Implementierung jedoch threadsicher bzw. reentrant ausgelegt sein, falls parallele Kommunikationsflüsse zeitgleich Frischewerte anfordern. Frage Q-a1d3e04b91b6c24d (offen)

Dieser Text wurde von einer KI auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "apext/com/secoc/fvm.h"
Scopeclass apext::com::secoc::FVM
Exception-Sicherheitexception safe

Template-Parameter

ParameterBeschreibung
FVContainerAs per [SWS_CM_11286]

Parameter (in)

ParameterBeschreibung
SecOCFreshnessValueIDthe identifier of the freshness value.

Rückgabewert

TypBeschreibung
ara::core::Result<FVContainer >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a apext::com:: secoc::FVContainer that holds the freshness value to be used for the calculation of the authenticator by the SecOC or recoverable error. • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComSecOcFvmErrc::kFVNotAvailablerollback_semantics Freshness Value not available

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11289
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11289@rel:R25-11#5a33d798
Content hash
5a33d798
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11289
Status: valid/unmigrated Version: rel:R25-11#65861fc2 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11289@rel:R25-11#65861fc2
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#5a33d7982026-09-30
  • R20-11rel:R20-11#edcd09152026-10-14
  • R21-11rel:R21-11#cd25fec42026-10-14
  • R22-11rel:R22-11#c50822302026-10-14
  • R23-11rel:R23-11#61be10642026-10-14
  • R24-11rel:R24-11#b538d6052026-10-14
  • R25-11rel:R25-11#65861fc22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function Initialize [SWS_CM_11290] Upstream: RS_CM_00801, RS_CM_00802, RS_CM_00803, RS_CM_00804

ara::core::Result< void > Initialize () noexcept;

Initializes FVM plugin implementation

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: ca0239e37c0b Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung und Aufrufkontext

Die synchrone Bibliotheksfunktion Initialize innerhalb des Gültigkeitsbereichs apext::com::secoc::FVM dient der Initialisierung der herstellerspezifischen Plugin-Implementierung des Freshness Value Managers (FVM) für die sicherheitsrelevante Kommunikation via SecOC [SWS_CM_11290]. Die Deklaration ist über den Header apext/com/secoc/fvm.h verfügbar SWS CommunicationManagement §C.1.2.2.1.3 „Initialize“.

Die Funktion nimmt keine Parameter entgegen und deklariert die Exception-Sicherheit noexcept (exception safe) [SWS_CM_11290]. Das Lifecycle-Management des FVM wird verbindlich durch die Kommunikations-Middleware ara::com übernommen [SWS_CM_11272], welche die Initialisierung des FVM-Plugins durch den expliziten Aufruf dieser Schnittstelle vornimmt [SWS_CM_11273]. Interpretation: Für Anwendungsentwickler existiert kein direkter Aufrufkontext, da die Bereitstellung als Plugin für die Plattform erfolgt und die Steuerung vollständig bei ara::com liegt. Frage Q-5b5c8b1a42c3bd3a (offen)

Fehlerbehandlung

Das Ergebnis der Operation wird über den Rückgabetyp ara::core::Result<void> kommuniziert [SWS_CM_11290]:

  • Erfolg: Bei erfolgreicher Initialisierung enthält das ara::core::Result einen leeren Wert (value_type ist void) [SWS_CM_11290].
  • Fehlgeschlagene Initialisierung: Konnte der Freshness Value Manager nicht initialisiert werden, wird ein Fehlerobjekt mit dem spezifischen Fehlercode ComSecOcFvmErrc::kFVInitializeFailed zurückgegeben; dabei greifen Rollback-Semantiken zur Beibehaltung eines definierten Zustands [SWS_CM_11290].

Zusammenspiel und Reihenfolge

Die Initialisierung mittels Initialize bildet die funktionale Voraussetzung für alle weiteren FVM-Dienste im System [SWS_CM_11273]. Erst nach erfolgreichem Durchlauf darf ara::com im Rahmen von SecOC-Sendeoperationen nach der E2E-Berechnung auf die Schnittstelle apext::com::secoc::FVM::GetTxFreshness zugreifen, um Aktualitätswerte für konfigurierte freshnessValueId-Attribute abzurufen [SWS_CM_11274].

Dieser Nutzungshinweis wurde von einer KI auf Basis der Spezifikation AUTOSAR Adaptive Platform R25-11 kuratiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "apext/com/secoc/fvm.h"
Scopeclass apext::com::secoc::FVM
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a void • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComSecOcFvmErrc::kFVInitializeFailedrollback_semantics Initialization of Freshness Value Manager failed

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11290
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11290@rel:R25-11#322a9af7
Content hash
322a9af7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11290
Status: valid/unmigrated Version: rel:R25-11#11a4e44b Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11290@rel:R25-11#11a4e44b
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#322a9af72026-09-30
  • R20-11rel:R20-11#3d48fa7f2026-10-14
  • R21-11rel:R21-11#3d48fa7f2026-10-14
  • R22-11rel:R22-11#b6c4832f2026-10-14
  • R23-11rel:R23-11#d9a72c7b2026-10-14
  • R24-11rel:R24-11#dd5117f72026-10-14
  • R25-11rel:R25-11#11a4e44b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function SetVerificationStatus [SWS_CM_19999] Upstream: RS_CM_00801, RS_CM_00802, RS_CM_00803, RS_CM_00804

ara::core::Result< void > SetVerificationStatus (std::uint16_t sec OCFreshnessValueID, VerificationStatus secOCVerificationStatus) noexcept;

This method is used by the SecOC to report all verification statuses to the Freshness Value Manager.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: a49def68f0a3 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die synchrone Methode apext::com::secoc::FVM::SetVerificationStatus wird von SecOC aufgerufen, um dem Freshness Value Manager (FVM) das Ergebnis einer Verifikation zu melden [SWS_CM_19999]. Sie ist über den Header apext/com/secoc/fvm.h deklariert und erfordert zwei Parameter AUTOSAR_AP_SWS_CommunicationManagement §C.1.2.2.1.4 „SetVerificationStatus“:

  • secOCFreshnessValueID (std::uint16_t): Eindeutige Kennung des Frischewerts.
  • secOCVerificationStatus (VerificationStatus): Verifikationsergebnis für die angegebene Kennung.

Fehlerbehandlung und Nebenläufigkeit

Die Funktion ist als noexcept deklariert und gilt als ausnahmesicher (exception safe) [SWS_CM_19999]. Der Rückgabetyp ara::core::Result<void> signalisiert eine erfolgreiche Ausführung über ein leeres Ergebnis. Im Fehlerfall enthält das Result-Objekt einen Fehlercode vom Typ ara::com::ComErrc, wenngleich die Spezifikation keine spezifischen standardisierten Fehlercodes definiert [SWS_CM_19999].

Zusammenspiel und Status

Die Funktion koppelt SecOC und den FVM bei der Verwaltung von Frischewerten. Sie besitzt den Status DRAFT AUTOSAR_AP_SWS_CommunicationManagement §C.1.2.2.1.4 „SetVerificationStatus“. Interpretation: Die übermittelten Statusinformationen dürften vom FVM intern verwendet werden, um Synchronisationszustände oder Zählerstände der Freshness-Werte nachzuführen. Frage Q-156ad8f991c99b7d (offen)

Dieser Nutzungshinweis wurde automatisiert erstellt und stützt sich ausschließlich auf die Spezifikation des Releases R25-11.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "apext/com/secoc/fvm.h"
Scopeclass apext::com::secoc::FVM
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
secOCFreshnessValueIDthe identifier of the freshness value.
secOCVerificationStatusverification status result for the given FreshnessValueID

Rückgabewert

TypBeschreibung
ara::core::Result< void >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a void • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_19999
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_19999@rel:R25-11#be832243
Content hash
be832243
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_19999
Status: valid/unmigrated Version: rel:R25-11#4590caf9 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_19999@rel:R25-11#4590caf9
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#be8322432026-09-30
  • R24-11rel:R24-11#feb309092026-10-14
  • R25-11rel:R25-11#4590caf92026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

Dokumentation der Enumerationen

enumeration VerificationStatus [SWS_CM_11378] Upstream: RS_CM_00801, RS_CM_00802, RS_CM_00803, RS_CM_00804

enum class VerificationStatus :               std::uint8_t {...};

Defines the status of a verification

Header-Datei#include "apext/com/secoc/fvm.h"
Forwarding-Header#include "apext/com/com_fwd.h"
Scopeclass apext::com::secoc::FVM
SymbolVerificationStatus
Basistypstd::uint8_t

Werte

EnumeratorBeschreibung
SuccessVerification successful
kSecOcVerificationFailure= 0x01 Verification not successful
kSecOcFreshnessFailure= 0x02 Verification not successful because of wrong freshness value
kSecOcAuthenticationBuildFailure= 0x03 Verification not successful because of wrong build authentication codes
kSecOcNoVerification= 0x04 Verification has been skipped and the data has been provided to the application as is
kSecOcVerificationFailureOverwritten= 0x05 Verification failed, but the PDU was passed on to the application due to the override status for this PDU

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11378
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11378@rel:R25-11#b0fa1d44
Content hash
b0fa1d44
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11378
Status: valid/unmigrated Version: rel:R25-11#7e9db4a6 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11378@rel:R25-11#7e9db4a6
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b0fa1d442026-09-30
  • R24-11rel:R24-11#23fd47892026-10-14
  • R25-11rel:R25-11#7e9db4a62026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill