functie 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.
De elementfunctie apext::com::secoc::FVM::GetRxFreshness dient voor de SecOC-laag om de volledige versheidswaarde voor ontvangen berichten te bepalen [SWS_CM_11288]. Als invoerparameters verwacht de functie de identificatie SecOCFreshnessValueID, de uit het beveiligde bericht geëxtraheerde verkorte versheidswaarde in FVContainer conform [SWS_CM_11286] alsook de teller SecOCAuthVerifyAttempts [SWS_CM_11288]. Deze teller begint bij de eerste verificatiepoging met de waarde 0 en wordt bij elke opeenvolgende mislukte poging voor hetzelfde bericht geïncrementeerd [SWS_CM_11288].
De methode is gespecificeerd als noexcept en uitzonderingsveilig (AUTOSAR_AP_SWS_CommunicationManagement §C.1.2.2.1.1 “GetRxFreshness”). Door de directe teruggave van een ara::core::Result<FVContainer> zonder Future-type wordt de aanroep vermoedelijk synchroon blokkerend afgehandeld. Vraag Q-2609cb9ffeb0d41d (open) In geval van succes bevat het resultaat de volledige versheidswaarde voor de aansluitende MAC-verificatie van de authenticator [SWS_CM_11288]. Kan de waarde niet worden verstrekt, dan retourneert de functie de herstelbare foutcode ComSecOcFvmErrc::kFVNotAvailable [SWS_CM_11288].
De bepaling van de versheidswaarde is een integraal onderdeel van het SecOC-ontvangstpad: de berichtauthenticatie vindt in beginsel plaats vóór nageschakelde E2E-controles [SWS_CM_11276] en is gekoppeld aan de teller voor authenticatiepogingen [SWS_CM_11277]. Specifieke eisen aan reentrantie of thread-veiligheid worden in de standaard niet gedefinieerd; het gedrag bij parallelle aanroepen hangt daarom vermoedelijk af van de concrete implementatie van de Freshness Value Manager. Vraag Q-071e92f80c6e44db (open)
Automatisch gegenereerde gebruiksinstructie op basis van de specificatie AUTOSAR R25-11.
Implementer's Guide volgt (complexiteit I2)
| Header-Datei | #include "apext/com/secoc/fvm.h" |
|---|---|
| Scope | class apext::com::secoc::FVM |
| Exception-Sicherheit | exception safe |
Template-Parameter
| Parameter | Beschreibung |
|---|---|
| FVContainer | As per [SWS_CM_11286] |
Parameter (in)
| Parameter | Beschreibung |
|---|---|
| SecOCFreshnessValueIDSecOCTruncatedFreshnessValueSecOCAuthVerifyAttempts | the 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
| Typ | Beschreibung |
|---|---|
| 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
| Fehlercode | Beschreibung |
|---|---|
| ComSecOcFvmErrc::kFVNotAvailable | rollback_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#8f1c474a- Content hash
8f1c474a- 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
Recorded Revisions (7):
- R25-11
rel:R25-11#ce9299c32026-09-30 - R20-11
rel:R20-11#2d3cd3ce2026-10-14 - R21-11
rel:R21-11#2d3cd3ce2026-10-14 - R22-11
rel:R22-11#93c431962026-10-14 - R23-11
rel:R23-11#c565fe5b2026-10-14 - R24-11
rel:R24-11#13a0e3ec2026-10-14 - R25-11
rel:R25-11#6d6528062026-10-14 active
Requirement Text as-of this release:
Curation Decisions:
Reachable Artifacts & Dependents:
| Date | Actor | Transition | Reason / Rationale | Campaign |
|---|---|---|---|---|
| 2026-08-13 | tool | none → valid/unmigrated | mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record | 2026-08-13-status-backfill |
gemini-3.8-flash-low· 2026-10-13 · Duits origineel