DEENESPTFRRUARHIKOZHNL

class ara::diag::SovdConfiguration

[SWS_DM_01860] Upstream: RS_Diag_04261

class SovdConfiguration {...};

Generic SOVD Configuration interface.

Header-Datei#include "ara/diag/sovd_configuration.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

User GuideKI-GENERIERT

Dient zur anwendungsseitigen Bereitstellung und Bearbeitung explizit modellierter SOVD-Konfigurationsressourcen.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 628609b2fb26 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Dient zur anwendungsseitigen Bereitstellung und Bearbeitung explizit modellierter SOVD-Konfigurationsressourcen.

Die Schnittstelle ara::diag::SovdConfiguration dient als generischer Handler für explizit modellierte SOVD-Konfigurationen, an den der Diagnostic Server eingehende Lese- und Schreibzugriffe weiterleitet [SWS_DM_01860], [SWS_DM_01787]. Nach der portbasierten Instanziierung aktiviert die Anwendung den Nachrichtenempfang über Offer und beendet ihn bei Bedarf mit StopOffer [SWS_DM_01872], [SWS_DM_01930]. Die Datenbereitstellung erfolgt asynchron über Lese- bzw. Schreibsitzungen, wobei fachliche Fehler nach ISO 17978-3 bzw. ASAM SOVD 1.1 signalisiert werden [SWS_DM_01870].

Kontext

Die Schnittstelle ara::diag::SovdConfiguration definiert das generische Interface für explizit modellierte SOVD-Konfigurations-Handler innerhalb der Adaptive AUTOSAR-Diagnosearchitektur [SWS_DM_01860]. Sofern mindestens eine SOVD-Konfiguration im System projektiert ist, stellt die Diagnostic-Server-Instanz des Diagnostic Management (DM) nach außen die standardisierte SOVD-Methode Retrieve List of All Configurations Provided by the Entity gemäß ASAM SOVD bereit [SWS_DM_01429]. Eingehende Lese- und Schreibzugriffe auf eine solche explizite Konfiguration leitet der Diagnostic Server an die konkrete Implementierung von ara::diag::SovdConfiguration weiter: Beim Aufruf der SOVD-Methode Read Configuration ruft der Diagnostic Server die Methode RequestGetConfiguration auf [SWS_DM_01787], während beim Aufruf von Write Configuration die Methode RequestPutConfiguration ausgeführt wird [SWS_DM_01788].

SovdConfigurationContext client SOVD Client dm Diagnostic Server (Diagnostic Management) client->dm Read/Write Configuration (ASAM SOVD) handler ara::diag::SovdConfiguration (Anwendungs-Handler) dm->handler RequestGetConfiguration() RequestPutConfiguration() handler->dm DataTransfer-Sessions (Future)

Kontextdiagramm: Einbettung von ara::diag::SovdConfiguration zwischen externem SOVD-Client, Diagnostic Server (DM) und anwendungsspezifischem Handler. Quellen: [SWS_DM_01429], [SWS_DM_01787], [SWS_DM_01788], [SWS_DM_01860].

Lebenszyklus

Die Instanziierung von ara::diag::SovdConfiguration erfolgt anwendungsseitig durch Übergabe eines ara::core::InstanceSpecifier sowie der Angabe eines ConcurrencyType (kConcurrent oder kNotConcurrent) [SWS_DM_01864]. Der InstanceSpecifier referenziert einen Port-Prototyp eines DiagnosticSovdConfigurationInterface im Prozesskontext [SWS_DM_01864]. Die Klasse darf nicht kopiert werden (Kopierkonstruktor und Kopierzuweisungsoperator sind als delete deklariert) [SWS_DM_01866], [SWS_DM_01868], unterstützt jedoch geschützte Move-Operationen [SWS_DM_01867], [SWS_DM_01869]. Um Anfragen vom Diagnostic Server entgegenzunehmen, muss die Anwendung explizit Offer aufrufen [SWS_DM_01872]. Mit dem Aufruf von StopOffer wird die Weiterleitung von Anfragen wieder deaktiviert [SWS_DM_01930]. Bei Zerstörung der Instanz über den virtuellen Destruktor [SWS_DM_01865] wird das Objekt freigegeben; die Freigabe setzt voraus, dass der Handler zuvor ordnungsgemäß deregistriert wurde.

SovdConfigurationState Uninitialized Nicht initialisiert Instantiated Instanziiert (kNotOffered) Uninitialized->Instantiated SovdConfiguration() Instantiated->Uninitialized ~SovdConfiguration() Offered Aktiviert (kOffered) Instantiated->Offered Offer() Stopped Deaktiviert (kStopped) Offered->Stopped StopOffer() Stopped->Uninitialized ~SovdConfiguration() Stopped->Offered Offer()

Zustandsdiagramm: Lebenszyklusphasen einer SovdConfiguration-Instanz von Initialisierung über Offer-Zustand bis zum StopOffer. Quellen: [SWS_DM_01864], [SWS_DM_01872], [SWS_DM_01930], [SWS_DM_01865].

Nutzungspfad

Ein typischer Nutzungspfad beginnt nach der Konstruktion der abgeleiteten Handler-Klasse mit dem Registrieren beim Diagnostic Management mittels Offer() [SWS_DM_01872]. Sobald ein externer Client eine SOVD-Konfigurationsanfrage an die Entität richtet, leitet der Diagnostic Server diese weiter: Bei einer Leseanforderung wird RequestGetConfiguration aufgerufen, wobei die configurationId, die metaInfo und ein CancellationHandler übergeben werden [SWS_DM_01870]. Die Methode liefert ein ara::core::Future zurück, das asynchron ein Tupel aus einer DataTransferReadSession und SovdConfigurationMetaInfo bereitstellt [SWS_DM_01870]. Analog leitet der Server Schreibanfragen über RequestPutConfiguration weiter, welches ein Future mit einer DataTransferWriteSession und SovdConfigurationMetaInfo liefert [SWS_DM_01871]. Vor dem Herunterfahren des Handlers ruft die Anwendung StopOffer() auf, um keine weiteren Anforderungen mehr anzunehmen [SWS_DM_01930].

SOVD Configuration LeseanforderungSOVD ClientDiagnostic ServerSovdConfigurationOffer()Result<void> (kSuccess)Use Case: Verarbeitung einer LeseanforderungRead Configuration (SOVD)RequestGetConfiguration(configurationId, metaInfo, cancellationHandler)Future<tuple<DataTransferReadSession, SovdConfigurationMetaInfo>>Konfigurationsdaten (HTTP/SOVD Response)Use Case: DeregistrierungStopOffer()

Sequenzdiagramm: Typische Interaktionsabfolge bei Initialisierung, Abfertigung eines Read-Configuration-Requests und anschließender Deregistrierung. Quellen: [SWS_DM_01872], [SWS_DM_01787], [SWS_DM_01870], [SWS_DM_01930].

Fehlerszenarien

Bereits bei der Instanziierung im Konstruktor können Modell- und Mapping-Verletzungen auftreten, falls der InstanceSpecifier im Modell nicht aufgelöst werden kann (InstanceSpecifierMappingIntegrityViolation), der referenzierte Port-Prototyp nicht durch ein DiagnosticSovdConfigurationInterface typisiert ist (PortInterfaceMappingViolation), kein passender Prozess existiert (ProcessMappingViolation) oder der Bezeichner im aktuellen Prozess bereits belegt ist (InstanceSpecifierAlreadyInUseViolation) [SWS_DM_01864]. Beim Aufruf von Offer() gibt die Methode ein ara::core::Result<void> zurück, welches im Fehlerfall DiagOfferErrc::kConfigurationMismatch meldet, wenn die Konfiguration nicht zum DEXT-Modell passt, oder DiagOfferErrc::kAlreadyOffered, falls der Service bereits angeboten wird [SWS_DM_01872]. In den asynchronen Handler-Methoden RequestGetConfiguration und RequestPutConfiguration meldet die Anwendung Fehlerzustände über das ara::core::Future unter Verwendung standardisierter SOVD-Fehlercodes gemäß ISO 17978-3 bzw. ASAM SOVD 1.1 [SWS_DM_01870], [SWS_DM_01871]. Zudem signalisiert der CancellationHandler, ob eine laufende Kommunikation abgebrochen wurde [SWS_DM_01870], [SWS_DM_01871].

Dieser Leitfaden basiert ausschließlich auf den Spezifikationen der AUTOSAR Adaptive Platform Release R25-11.

Mitgliederkarte

Konstruktoren und Destruktor

2
SovdConfiguration~SovdConfiguration

Methoden

4
OfferRequestGetConfigurationRequestPutConfigurationStopOffer

Operatoren

1
operator=

Eingebettete Typen

1
SovdConfigurationMetaInfo

Klassendiagramm

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

G nara__diag__SovdConfiguration627 SovdConfiguration + ~SovdConfiguration() + SovdConfiguration() + Offer() + RequestGetConfiguration() + RequestPutConfiguration() + StopOffer() + operator=()

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

SovdConfiguration function 3

Constructor for the SovdConfiguration Interface.

Überladungen SovdConfiguration 3
SovdConfiguration (ara::core::InstanceSpecifier const &instance Specifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_01864
SovdConfiguration (SovdConfiguration const &)=delete; SWS_DM_01866
SovdConfiguration (SovdConfiguration &&other) noexcept; SWS_DM_01867
~SovdConfiguration function

Destructor of SovdConfiguration.

virtual ~SovdConfiguration () noexcept;

Methoden

Offer function

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;
RequestGetConfiguration function

Called for SOVD method "Read Configuration".

virtual ara::core::Future< std::tuple< DataTransferReadSession, Sovd ConfigurationMetaInfo > > RequestGetConfiguration (ara::core::String configurationId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
RequestPutConfiguration function

Called for SOVD method "Write Configuration".

virtual ara::core::Future< std::tuple< DataTransferWriteSession, Sovd ConfigurationMetaInfo > > RequestPutConfiguration (ara::core::String configurationId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
StopOffer function

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () const noexcept;

Operatoren

operator= function 2

SovdConfiguration shall be a single not assignable instance.

Überladungen = 2
SovdConfiguration & operator= (SovdConfiguration const &)=delete; SWS_DM_01868
SovdConfiguration & operator= (SovdConfiguration &&other) & noexcept; SWS_DM_01869

Eingebettete Typen

Dokumentation der Methoden

function Offer [SWS_DM_01872] Upstream: RS_Diag_04261

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

This Offer will enable the DM to forward request messages to this handler.

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

Verwendung

Die Methode Offer der Klasse ara::diag::SovdConfiguration dient dazu, die Weiterleitung von Diagnoseanfragen durch den Diagnostic Management (DM) an den konfigurierten Handler zu aktivieren [SWS_DM_01872]. Der Aufruf erfolgt synchron, nimmt keine Parameter entgegen und meldet das Ergebnis über ara::core::Result<void> zurück [SWS_DM_01872]. Solange ein Handler nicht über Offer bereitgestellt wurde, leitet der DM keine eingehenden Anfragen weiter, was dem grundlegenden Bereitstellungsmuster diagnostischer Schnittstellen entspricht (vgl. [SWS_DM_01525], [SWS_DM_00809]).

Fehlerbehandlung

Im Fehlerfall wird ein ara::core::Result mit einem Fehlercode der Enumeration DiagOfferErrc zurückgegeben, wobei eine Rollback-Semantik gilt [SWS_DM_01872]:

  • DiagOfferErrc::kAlreadyOffered: Wird gemeldet, wenn der Dienst bereits zuvor angeboten wurde [SWS_DM_01872].
  • DiagOfferErrc::kConfigurationMismatch: Tritt auf, wenn die Konfiguration nicht mit den DEXT-Beschreibungsdaten übereinstimmt [SWS_DM_01872].

Nebenläufigkeit und Einschränkungen

Die Operation ist als noexcept deklariert sowie ausnahmesicher (exception safe), ist jedoch als nicht threadsicher (not thread-safe) spezifiziert [SWS_DM_01872]. Gleichzeitige Aufrufe derselben Instanz aus mehreren Threads müssen durch die aufrufende Anwendung verhindert werden. Ein erneuter Aufruf nach bereits erfolgtem Angebot dürfte vermutlich ohne Zustandsänderung mit einem Fehler quittiert werden. Frage Q-f9b1a995dbb002ef (offen)

Dieser Nutzungshinweis wurde von einer KI auf Basis der AUTOSAR-Spezifikation R25-11 erstellt.

Implementer's Guide folgt (Komplexität I1)

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kConfigurationMismatchrollback_semantics monitor configuration does not match DEXT
DiagOfferErrc::kAlreadyOfferedrollback_semantics The service is already offered.

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

Record
AUTOSAR/AP/record/SWS_DM_01872
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01872@rel:R25-11#01789639
Content hash
01789639
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01872
Status: valid/unmigrated Version: rel:R25-11#3482e5bc Versionshistorie & Revisions (1 transition, 4 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_DM_01872@rel:R25-11#3482e5bc
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#017896392026-09-30
  • R23-11rel:R23-11#9fcae3412026-10-14
  • R24-11rel:R24-11#635634302026-10-14
  • R25-11rel:R25-11#3482e5bc2026-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 RequestGetConfiguration [SWS_DM_01870] Upstream: RS_Diag_04261

virtual ara::core::Future< std::tuple< DataTransferReadSession, Sovd ConfigurationMetaInfo > > RequestGetConfiguration (ara::core::String configurationId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Read Configuration".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c77e8c500466 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die pure virtuelle Methode RequestGetConfiguration der Klasse ara::diag::SovdConfiguration wird von der Diagnostic Server Instance aufgerufen, wenn die SOVD-Methode „Read Configuration“ für eine explizit modellierte SOVD-Konfiguration ausgeführt wird ([SWS_DM_01787], AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 „Configuration – Explicit Configurations“). Als Parameter werden die Konfigurations-ID der zu lesenden Instanz (configurationId), die Metainformationen der Anfrage (metaInfo) sowie ein cancellationHandler übergeben, der über einen eventuellen Abbruch der laufenden Konversation informiert ([SWS_DM_01870]).

Die Funktion arbeitet asynchron und liefert ein ara::core::Future zurück, das ein Tupel aus einer Dateilesesitzung (DataTransferReadSession) und zugehörigen Konfigurations-Metainformationen (SovdConfigurationMetaInfo) bereitstellt ([SWS_DM_01870]). Die Schnittstelle ist als noexcept deklariert und als ausnahmesicher spezifiziert ([SWS_DM_01870]).

Fehlerbehandlung und Nebenläufigkeit

Tritt bei der Verarbeitung ein Fehler auf, wird kein C++-Fehler geworfen, sondern über das Future ein zutreffender SOVD-Fehlercode gemäß ISO 17978-3 bzw. ASAM SOVD 1.1 zurückgegeben ([SWS_DM_01870]).

Hinsichtlich der Thread-Sicherheit gilt die Vorgabe „conditional“: Ob die konkrete Implementierung der Funktion threadsicher oder nicht-threadsicher ausgelegt sein muss, entscheidet der dem Konstruktor übergebene ConcurrencyType ([SWS_DM_01870]).

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

Implementer's Guide folgt (Komplexität I1)

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
configurationIdconfiguration-id of the configuration instance to be read
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future<std::tuple< DataTransferReadSession, Sovd ConfigurationMetaInfo > >A Future with either an instance of a "SOVD file reading session" with corresponding SovdConfigurationMetaInfo or a SOVD Error

Fehler

FehlercodeBeschreibung
Please use an applicable SOVD error code, as defined in ISO 17978-3 / ASAM SOVD 1.1.

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

Record
AUTOSAR/AP/record/SWS_DM_01870
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01870@rel:R25-11#41fdb10a
Content hash
41fdb10a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01870
Status: valid/unmigrated Version: rel:R25-11#ad0c98ef Versionshistorie & Revisions (1 transition, 4 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_DM_01870@rel:R25-11#ad0c98ef
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#41fdb10a2026-09-30
  • R23-11rel:R23-11#1c3d71c12026-10-14
  • R24-11rel:R24-11#905faa5f2026-10-14
  • R25-11rel:R25-11#ad0c98ef2026-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 RequestPutConfiguration [SWS_DM_01871] Upstream: RS_Diag_04261

virtual ara::core::Future< std::tuple< DataTransferWriteSession, Sovd ConfigurationMetaInfo > > RequestPutConfiguration (ara::core::String configurationId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Write Configuration".

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: cb354fd9457e Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die API-Methode ara::diag::SovdConfiguration::RequestPutConfiguration wird vom Diagnostic Server aufgerufen, wenn über die SOVD-Schnittstelle die Methode „Write Configuration“ für eine explizit modellierte Konfiguration ausgeführt werden soll [SWS_DM_01788], [SWS_DM_01871].

Aufruf und Parameter

Die Deklaration befindet sich im Header ara/diag/sovd_configuration.h. Der Aufruf übergibt die folgenden Eingabeparameter [SWS_DM_01871]:

  • configurationId: ID der zu schreibenden Konfigurationsinstanz als ara::core::String.
  • metaInfo: Metainformationen zur eingehenden Anfrage (MetaInfo const &).
  • cancellationHandler: Überwacht den aktuellen Vorgang und signalisiert, falls die Kommunikation abgebrochen wurde.

Die Methode besitzt eine asynchrone Semantik und gibt ein ara::core::Future zurück, das im Erfolgsfall ein Tupel aus einer Schreibsitzung (DataTransferWriteSession) sowie zugehörigen Metadaten (SovdConfigurationMetaInfo) zur Verfügung stellt [SWS_DM_01871].

Fehlerbehandlung und Nebenläufigkeit

Im Fehlerfall wird das Future mit einem passenden SOVD-Fehlercode nach ISO 17978-3 bzw. ASAM SOVD 1.1 aufgelöst [SWS_DM_01871]. Die Funktion ist als noexcept deklariert und ausnahmesicher (exception safe). Die Thread-Sicherheit ist konditional (conditional): Ob die konkrete Implementierung threadsicher ausgelegt sein muss, bestimmt der im Konstruktor spezifizierte ConcurrencyType [SWS_DM_01871].

Zusammenspiel

Die Funktion bildet das schreibende Gegenstück zu RequestGetConfiguration, welche für die SOVD-Methode „Read Configuration“ verwendet wird [SWS_DM_01787] (AUTOSAR_AP_SWS_Diagnostics §7.3.3.5.2.1 „Configuration – Explicit Configurations“).

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

Implementer's Guide folgt (Komplexität I1)

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
configurationIdconfiguration-id of the configuration instance to be written
metaInfoMetaInfo of the request.
cancellationHandlerInforms if the current conversation is cancelled

Rückgabewert

TypBeschreibung
ara::core::Future<std::tuple< DataTransferWriteSession, Sovd ConfigurationMetaInfo > >A Future with either an instance of a "SOVD file writing session" with corresponding SovdConfigurationMetaInfo or an SOVD Error

Fehler

FehlercodeBeschreibung
Please use an applicable SOVD error code, as defined in ISO 17978-3 / ASAM SOVD 1.1.

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

Record
AUTOSAR/AP/record/SWS_DM_01871
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01871@rel:R25-11#ee88ccaa
Content hash
ee88ccaa
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01871
Status: valid/unmigrated Version: rel:R25-11#f511e418 Versionshistorie & Revisions (1 transition, 4 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_DM_01871@rel:R25-11#f511e418
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#ee88ccaa2026-09-30
  • R23-11rel:R23-11#72d50ac12026-10-14
  • R24-11rel:R24-11#af0350392026-10-14
  • R25-11rel:R25-11#f511e4182026-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 SovdConfiguration [SWS_DM_01864] Upstream: RS_Diag_04261, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

SovdConfiguration (ara::core::InstanceSpecifier const &instance Specifier, ConcurrencyType concurrencyType) noexcept;

Constructor for the SovdConfiguration Interface.

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticSovdConfigurationPortMapping needs to be typed by a DiagnosticSovdConfigurationInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

ParameterBeschreibung
instanceSpecifierInstanceSpecifier to a PortPrototype of a DiagnosticSovdConfigurationInterface
concurrencyTypeSpecifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).

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

Record
AUTOSAR/AP/record/SWS_DM_01864
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01864@rel:R25-11#cfdf1659
Content hash
cfdf1659
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01864
Status: valid/unmigrated Version: rel:R25-11#a4704e22 Versionshistorie & Revisions (1 transition, 4 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_DM_01864@rel:R25-11#a4704e22
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#cfdf16592026-09-30
  • R23-11rel:R23-11#f2502cf62026-10-14
  • R24-11rel:R24-11#3363eb612026-10-14
  • R25-11rel:R25-11#a4704e222026-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 SovdConfiguration [SWS_DM_01866] Upstream: RS_Diag_04261

SovdConfiguration (SovdConfiguration const &)=delete;

SovdConfiguration shall be a single not copy-able instance.

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Sichtbarkeitprotected

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

Record
AUTOSAR/AP/record/SWS_DM_01866
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01866@rel:R25-11#a37cf3bf
Content hash
a37cf3bf
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01866
Status: valid/unmigrated Version: rel:R25-11#27c2b178 Versionshistorie & Revisions (1 transition, 4 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_DM_01866@rel:R25-11#27c2b178
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#a37cf3bf2026-09-30
  • R23-11rel:R23-11#5569f98c2026-10-14
  • R24-11rel:R24-11#27c2b1782026-10-14
  • R25-11rel:R25-11#27c2b1782026-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 SovdConfiguration [SWS_DM_01867] Upstream: RS_Diag_04261

SovdConfiguration (SovdConfiguration &&other) noexcept;

Move constructs an instance of SovdConfiguration.

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe
Sichtbarkeitprotected

Parameter (out)

ParameterBeschreibung
otherThe other object

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

Record
AUTOSAR/AP/record/SWS_DM_01867
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01867@rel:R25-11#e8654599
Content hash
e8654599
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01867
Status: valid/unmigrated Version: rel:R25-11#c853a16e Versionshistorie & Revisions (1 transition, 4 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_DM_01867@rel:R25-11#c853a16e
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#e86545992026-09-30
  • R23-11rel:R23-11#78e8f1ce2026-10-14
  • R24-11rel:R24-11#c853a16e2026-10-14
  • R25-11rel:R25-11#c853a16e2026-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 StopOffer [SWS_DM_01930] Upstream: RS_Diag_04261

void StopOffer () const noexcept;

This StopOffer will disable the forwarding of request messages from DM.

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

Die Methode StopOffer() der Klasse ara::diag::SovdConfiguration dient dazu, die Weiterleitung von Anfragen (Request Messages) durch den Diagnostic Management Daemon (DM) an die Service-Instanz zu deaktivieren [SWS_DM_01930]. Sie bildet das Gegenstück zur Bereitstellung des Dienstes und folgt dem einheitlichen Lifecycle-Muster diagnostischer Schnittstellen in AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 „Monitors“.

Verwendung und Signatur: Der Aufruf erfolgt parameterlos und synchron über den Header ara/diag/sovd_configuration.h [SWS_DM_01930]. Da die Methode keinen Rückgabewert liefert (void) und als noexcept deklariert ist, gilt sie als ausnahmesicher (exception safe) [SWS_DM_01930]. Es werden weder Fehlercodes noch Exceptions an den Aufrufer übermittelt.

Nebenläufigkeit und Einschränkungen: Die Funktion ist explizit als nicht threadsicher (not thread-safe) spezifiziert [SWS_DM_01930]. Werden Instanzen von ara::diag::SovdConfiguration in Multithreading-Umgebungen genutzt, müssen gleichzeitige Zugriffe oder Wechsel des Bereitstellungszustands durch die Adaptive Application synchronisiert werden.

Zusammenspiel: Das Verhalten entspricht der Deaktivierungssemantik anderer DM-Dienste wie ara::diag::CommunicationControl [SWS_DM_00810] oder ara::diag::GenericRoutine [SWS_DM_00558]. Interpretation: Nach dem Aufruf von StopOffer() dürften vom DM empfangene Diagnoseanfragen verworfen oder negativ beantwortet werden, bis die Konfiguration erneut über eine entsprechende Angebotsmethode aktiviert wird. Frage Q-4c6212980015c119 (offen)

Dieser Text wurde von einer KI erstellt; er ersetzt nicht die Lektüre der Spezifikation.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_01930
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01930@rel:R25-11#693a8a9b
Content hash
693a8a9b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01930
Status: valid/unmigrated Version: rel:R25-11#254b10fb Versionshistorie & Revisions (1 transition, 4 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_DM_01930@rel:R25-11#254b10fb
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#693a8a9b2026-09-30
  • R23-11rel:R23-11#c476eb662026-10-14
  • R24-11rel:R24-11#254b10fb2026-10-14
  • R25-11rel:R25-11#254b10fb2026-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 operator= [SWS_DM_01868] Upstream: RS_Diag_04261

SovdConfiguration & operator= (SovdConfiguration const &)=delete;

SovdConfiguration shall be a single not assignable instance.

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Sichtbarkeitprotected

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

Record
AUTOSAR/AP/record/SWS_DM_01868
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01868@rel:R25-11#36273ac7
Content hash
36273ac7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01868
Status: valid/unmigrated Version: rel:R25-11#4026cfb2 Versionshistorie & Revisions (1 transition, 4 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_DM_01868@rel:R25-11#4026cfb2
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#36273ac72026-09-30
  • R23-11rel:R23-11#46c8b5562026-10-14
  • R24-11rel:R24-11#4026cfb22026-10-14
  • R25-11rel:R25-11#4026cfb22026-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 operator= [SWS_DM_01869] Upstream: RS_Diag_04261

SovdConfiguration & operator= (SovdConfiguration &&other) & noexcept;

Move assigns an instance of SovdConfiguration.

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe
Sichtbarkeitprotected

Parameter (out)

ParameterBeschreibung
otherThe other object

Rückgabewert

TypBeschreibung
SovdConfiguration &Reference to self

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

Record
AUTOSAR/AP/record/SWS_DM_01869
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01869@rel:R25-11#24bd3eef
Content hash
24bd3eef
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01869
Status: valid/unmigrated Version: rel:R25-11#d81af4c2 Versionshistorie & Revisions (1 transition, 4 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_DM_01869@rel:R25-11#d81af4c2
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#24bd3eef2026-09-30
  • R23-11rel:R23-11#8af3df1a2026-10-14
  • R24-11rel:R24-11#d81af4c22026-10-14
  • R25-11rel:R25-11#d81af4c22026-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 ~SovdConfiguration [SWS_DM_01865] Upstream: RS_Diag_04261

virtual ~SovdConfiguration () noexcept;

Destructor of SovdConfiguration.

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopeclass ara::diag::SovdConfiguration
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_01865
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01865@rel:R25-11#b8a477af
Content hash
b8a477af
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01865
Status: valid/unmigrated Version: rel:R25-11#830f0a18 Versionshistorie & Revisions (1 transition, 4 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_DM_01865@rel:R25-11#830f0a18
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b8a477af2026-09-30
  • R23-11rel:R23-11#d177c1732026-10-14
  • R24-11rel:R24-11#7b6b10d42026-10-14
  • R25-11rel:R25-11#830f0a182026-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