Diese Seite wurde vollständig KI-generiert auf Basis von SWS IntrusionDetectionSystemManager (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.
Empfängt qualifizierte Security-Events des IdsM über einen modellierten P-Port und leitet sie an Callbacks weiter.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 46b1b6dbd698HerkunftOffene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Empfängt qualifizierte Security-Events des IdsM über einen modellierten P-Port und leitet sie an Callbacks weiter.
Die abstrakte Klasse ermöglicht den Empfang qualifizierter Security Events aus dem IdsM über einen modellierten PPort [SWS_AIDSM_10800]. Anwendungen leiten eine eigene Empfängerklasse ab, instanziieren diese mit einem Instance-Specifier und aktivieren die Ereigniszustellung über Offer()[SWS_AIDSM_10801]. Eintreffende Ereignisse werden über abstrakte Callback-Methoden mit optionalen Kontext- und Zeitdaten entgegengenommen. Da wesentliche Zustands- und Callback-Methoden nicht threadsicher sind, bedarf die Instanz einer koordinierten Lebenszyklusverwaltung.
Kontext
Die Klasse ara::idsm::QualifiedEventsReceiver stellt im Modul idsm der AUTOSAR Adaptive Platform die funktionale Schnittstelle zum Empfang qualifizierter Sicherheitsereignisse (Qualified Security Events, QSEv) dar [SWS_AIDSM_10800]. Sie dient als anwendungsseitiger Endpunkt für einen im Software-Design modellierten Provided-Port (PPort) [SWS_AIDSM_10801].
Das Konzept basiert auf dem Prinzip einer abstrakten Basisklasse: ara::idsm::QualifiedEventsReceiver deklariert rein virtuelle Callback-Methoden [SWS_AIDSM_10807], [SWS_AIDSM_10810]. Die wesentlichen Interaktionspartner sind die adaptive Anwendung, welche eine spezialisierte Unterklasse implementiert, sowie der Intrusion Detection System Manager (IdsM), der qualifizierte Security-Events detektiert und über den PPort an die Instanz weiterleitet.
Lebenszyklus
Die Erzeugung eines Empfängers erfolgt durch Instanziierung einer von QualifiedEventsReceiver abgeleiteten Klasse unter Angabe eines ara::core::InstanceSpecifier, welcher den modellierten PPort referenziert [SWS_AIDSM_10801]. Dieser parametrisierte Konstruktor ist als threadsicher (thread-safe) spezifiziert [SWS_AIDSM_10801].
Hinsichtlich der Besitz- und Wertesemantik ist die Klasse strikt als Move-Only konzipiert. Sowohl der Kopierkonstruktor [SWS_AIDSM_10804] als auch der Kopierzuweisungsoperator [SWS_AIDSM_10806] sind gelöscht (= delete). Ein Eigentumsübergang ist jedoch möglich: Der Verschiebekonstruktor ist thread-safe implementiert [SWS_AIDSM_10803], wohingegen der Verschiebezuweisungsoperator nicht threadsicher (not thread-safe) ist [SWS_AIDSM_10805].
Der funktionale Lebenszyklus gliedert sich in zwei Hauptphasen:
Bereitstellung: Unmittelbar nach der Instanziierung werden noch keine Ereignisse zugestellt. Erst der Aufruf von Offer() schaltet die Annahme von Ereignissen frei und autorisiert Aufrufe der Callback-Methoden durch den IdsM [SWS_AIDSM_10808].
Deaktivierung: Über die Methode StopOffer() wird die Entgegennahme weiterer Ereignisse unterbunden [SWS_AIDSM_10809].
Die Zerstörung erfolgt über den virtuellen Destruktor ~QualifiedEventsReceiver()[SWS_AIDSM_10802]. Da der Destruktor nicht threadsicher ist, sollte vor der Freigabe des Empfängerobjekts stets StopOffer() ausgeführt werden, um parallele Ausführungen von Callbacks während des Zerstörungsvorgangs sicher auszuschließen.
Nutzungspfad
Der typische Ablauf zur Nutzung des Empfängers umfasst die Ableitung, Bereitstellung und den geordneten Abbau:
Klassendefinition: Die Anwendung definiert eine Subklasse und überschreibt die beiden rein virtuellen Methoden OnEventQualification() für Ereignisse mit unversionierten Kontextdaten [SWS_AIDSM_10807] sowie für versionierte oder leere Kontextdaten [SWS_AIDSM_10810].
Instanziierung: Die Subklasse wird instanziiert, wobei der Instanzbezeichner des Ports an den Basiskonstruktor übergeben wird [SWS_AIDSM_10801].
Aktivierung via Offer: Die Anwendung ruft Offer() auf, um die Ereignisannahme zu starten [SWS_AIDSM_10808]. Das zurückgegebene ara::core::Result<void> bestätigt die erfolgreiche Freigabe.
Ereignisempfang: Erkennt der IdsM ein qualifiziertes Security-Event, ruft er je nach Datenformat die passende Callback-Methode auf:
OnEventQualification(EventIdType, ara::core::Optional<ContextDataType>, ara::core::Optional<TimestampType>) für unversionierte Daten [SWS_AIDSM_10807].
OnEventQualification(EventIdType, ara::core::Optional<VersionedContextDataType>, ara::core::Optional<TimestampType>) für versionierte Kontextdaten oder ereignisspezifisch fehlende Daten [SWS_AIDSM_10810].
Deaktivierung und Zerstörung: Vor Beendigung der Applikation wird StopOffer() aufgerufen [SWS_AIDSM_10809] und das Objekt regulär über den Destruktor freigegeben [SWS_AIDSM_10802].
Bei der Nutzung können verschiedene Fehlerbedingungen und Nebenläufigkeitskonflikte auftreten:
Fehlschlag bei Offer(): Die Methode Offer() liefert ein ara::core::Result<void> zurück [SWS_AIDSM_10808]. Interpretation: Kann der modellierte Port im System nicht gebunden werden oder schlägt die Registrierung beim IdsM fehl, liefert das Result-Objekt einen Fehler. Frage (offen) Die Anwendung darf erst nach erfolgreicher Prüfung davon ausgehen, dass Callbacks ausgelöst werden.
Fehlende Kontext- oder Zeitstempelwerte: In beiden Callback-Signaturen sind Kontextdaten und Zeitstempel in ara::core::Optional gekapselt ([SWS_AIDSM_10807], [SWS_AIDSM_10810]). Ein ungeprüfter Zugriff ohne Validierung (etwa auf leere Kontextdaten) führt zu Fehlern in der Verarbeitungslogik der Anwendung.
Klasse zum Empfangen qualifizierter Security Events von IdsM.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: b8f71cd4e8edHerkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Die Klasse QualifiedEventsReceiver dient dem Empfang qualifizierter Security Events vom Intrusion Detection System Manager (IdsM) [SWS_AIDSM_10800] im Kontext des Headers ara/idsm/qualified_events_receiver.h.
Verwendung und Instanziierung: Eine Instanz wird über den Konstruktor QualifiedEventsReceiver(const ara::core::InstanceSpecifier& instance) für einen modellierten PPort erzeugt [SWS_AIDSM_10801]. Das Klassenmodell erzwingt Move-Semantik: Der Kopierkonstruktor [SWS_AIDSM_10804] sowie der Kopierzuweisungsoperator [SWS_AIDSM_10806] sind gelöscht (= delete). Instanzen lassen sich stattdessen über den Verschiebekonstruktor [SWS_AIDSM_10803] oder die Verschiebezuweisung [SWS_AIDSM_10805] übertragen.
Nebenläufigkeit und Thread Safety: Die Erzeugung der Instanz über den parametrisierten Konstruktor [SWS_AIDSM_10801] sowie das Verschieben mittels Verschiebekonstruktor [SWS_AIDSM_10803] sind als thread-safe spezifiziert. Dagegen sind die Zerstörung über den virtuellen Destruktor [SWS_AIDSM_10802] und die Verschiebezuweisung via operator=[SWS_AIDSM_10805] als nicht thread-safe (not thread-safe) definiert. Aufrufer müssen daher sicherstellen, dass Zuweisungs- und Zerstörungsoperationen nicht konkurrierend auf demselben Objekt ausgeführt werden.
Fehlerbehandlung: Sämtliche spezifizierten Lebenszyklus- und Zuweisungsfunktionen – Konstruktoren, Destruktor und Verschiebezuweisung – sind mit noexcept gekennzeichnet und lösen somit keine Ausnahmen aus.
Dieser Text wurde von einer KI generiert und dient als Orientierungshilfe. Maßgeblich ist die AUTOSAR-Spezifikation.
Implementer's Guide folgt (Komplexität I1)
Request a governed re-review of this record. The record is not changed immediately.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 07e3f8fb1ccdHerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Die synchrone Methode Offer() aus dem Header ara/idsm/qualified_events_receiver.h wird ohne Übergabeparameter aufgerufen und dient dazu, die Empfangsbereitschaft für qualifizierte Sicherheitsereignisse anzuzeigen [SWS_AIDSM_10808]. Durch den erfolgreichen Aufruf wird dem Intrusion Detection System Manager (IdsM) gestattet, nachfolgend qualifizierte Ereignisse über die Callback-Methode OnEventQualification an die Instanz zu übermitteln [SWS_AIDSM_10808].
Die Signatur deklariert die Funktion mit noexcept, sodass keine C++-Ausnahmen auftreten, und liefert als Rückgabetyp ara::core::Result<void>[SWS_AIDSM_10808]. Da die Spezifikation keine spezifischen Fehlercodes aufführt, dürfte ein im Ergebnis transportierter Fehler anzeigen, dass die Bereitstellung im IdsM fehlgeschlagen ist. Frage Q-2eca6bb6ce27ec78 (offen) In Bezug auf Nebenläufigkeit ist die Operation ausdrücklich als nicht threadsicher (not thread-safe) spezifiziert [SWS_AIDSM_10808]. Aufrufer müssen daher sicherstellen, dass Aufrufe von Offer() nicht ungeschützt parallel zu anderen Methoden der Instanz ausgeführt werden.
Das Bereitstellungsmuster entspricht der standardisierten Interaktion im Modul aidsm, in dem Service-Provider ihre Dienste für den IdsM aktiv freischalten:
Im Header ara/idsm/timestamp_provider.h aktiviert die Funktion Offer() die Bereitstellung von Zeitstempeln und ermöglicht dem IdsM den Aufruf von GetTimestamp[SWS_AIDSM_10408].
Im Header ara/idsm/context_data_provider.h schaltet Offer() die Modifikation von Kontextdaten frei, indem dem IdsM Aufrufe von ModifyContextData gestattet werden [SWS_AIDSM_10507].
Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikationsanforderungen von AUTOSAR R25-11 erstellt.
Request a governed re-review of this record. The record is not changed immediately.
Abstrakter Callback für ein QSEv mit unversionierten Kontextdaten.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c315ee5144f2Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Die rein virtuelle Funktion OnEventQualification ist im Header ara/idsm/qualified_events_receiver.h definiert und dient als abstrakter Callback für den Empfang qualifizierter Sicherheitsereignisse (QSEv) mit unversionierten Kontextdaten [SWS_AIDSM_10807].
Verwendung und Parameter: Die Methode wird bei Eintreffen eines qualifizierten Ereignisses durch das Intrusion Detection System Manager (IdsM) aufgerufen. Sie deklariert folgende Schnittstellenparameter [SWS_AIDSM_10807]:
event (EventIdType): Eindeutige Kennung des qualifizierten Ereignisses.
contextData (ara::core::Optional<ContextDataType>): Optionale unversionierte Kontextdaten des Ereignisses.
timestamp (ara::core::Optional<TimestampType>): Optionaler Zeitstempel des Ereigniseintritts.
Die Methode besitzt keinen Rückgabewert (void) und wirft keine Ausnahmen (noexcept) [SWS_AIDSM_10807].
Nebenläufigkeit: Die Callback-Methode ist als nicht threadsicher (not thread-safe) spezifiziert [SWS_AIDSM_10807]. Anwendungsseitige Implementierungen müssen daher sicherstellen, dass konkurrierende Aufrufe oder Zugriffe synchronisiert werden.
Lebenszyklus und Zusammenspiel: Aufrufe von OnEventQualification durch das IdsM sind zustandsabhängig: Sie sind erst nach der Aktivierung über Offer zulässig [SWS_AIDSM_10808] und werden durch StopOffer unterbunden [SWS_AIDSM_10809]. Für Ereignisse mit versionierten Kontextdaten oder ohne Kontextdaten existiert eine eigenständige Überladung von OnEventQualification mit VersionedContextDataType[SWS_AIDSM_10810].
Dieser Nutzungshinweis wurde von einer KI generiert und basiert ausschließlich auf den Spezifikationsdaten aus AUTOSAR R25-11.
Implementer's Guide folgt (Komplexität I1)
Request a governed re-review of this record. The record is not changed immediately.
Abstrakter Callback für ein QSEv mit versionierten oder ohne Kontextdaten.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 34e6800f4e26HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Verwendung
Die rein virtuelle Elementfunktion OnEventQualification dient als anwendungsspezifischer Callback zur Benachrichtigung über ein qualifiziertes Sicherheitsereignis (QSEv) mit versionierten oder ohne Kontextdaten [SWS_AIDSM_10810]. Die Funktion deklariert folgende Übergabeparameter:
event (EventIdType): Identifikator des qualifizierten Ereignisses [SWS_AIDSM_10810].
contextData (ara::core::Optional<VersionedContextDataType>): Optionale versionierte Kontextdaten des Ereignisses [SWS_AIDSM_10810].
timestamp (ara::core::Optional<TimestampType>): Optionaler Zeitstempel des Ereignisses [SWS_AIDSM_10810].
Die Funktion gibt keinen Wert zurück (void) und ist mit dem Spezifizierer noexcept deklariert [SWS_AIDSM_10810].
Zusammenspiel und Lebenszyklus
Damit das IdsM Aufrufe von OnEventQualification durchführen kann, muss der Empfänger die Schnittstelle zuvor über Offer aktivieren [SWS_AIDSM_10808]. Mit StopOffer werden nachfolgende Aufrufe der Callback-Funktion wieder unterbunden [SWS_AIDSM_10809]. Während SWS_AIDSM_10810 versionierte Kontextdaten verarbeitet, existiert für unversionierte Daten die alternative Signatur gemäß [SWS_AIDSM_10807].
Nebenläufigkeit und Fehlerbehandlung
Die Funktion ist als nicht threadsicher (not thread-safe) spezifiziert [SWS_AIDSM_10810]. Vermutlich muss die aufrufende Instanz des IdsM oder die konkrete Implementierung eine entsprechende Synchronisation sicherstellen, falls Aufrufe nebenläufig erfolgen. Frage Q-6b9e9525b682ad70 (offen) Da die Signatur als noexcept definiert ist und keinen Fehlercode zurückgibt, dürfen innerhalb der Callback-Implementierung keine Ausnahmen entweichen [SWS_AIDSM_10810].
Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation erstellt.
Implementer's Guide folgt (Komplexität I1)
Request a governed re-review of this record. The record is not changed immediately.
Unterbindet IdsM-Aufrufe von OnEventQualification.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 8389f042ab00HerkunftOffene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Die Funktion StopOffer im Header ara/idsm/qualified_events_receiver.h wird gemäß [SWS_AIDSM_10809] aufgerufen, um das Anbieten des Empfängerdienstes für qualifizierte Sicherheitsereignisse zu beenden. Durch den synchronen Aufruf wird sichergestellt, dass der Intrusion Detection System Manager (IdsM) nachfolgend keine Aufrufe mehr an die Callback-Methode OnEventQualification weiterleitet.
Hinsichtlich Verwendung und Schnittstellenverhalten gelten folgende Eigenschaften:
Signatur und Fehlerbehandlung: Die Funktion nimmt keine Parameter entgegen und besitzt keinen Rückgabewert (void StopOffer() noexcept;). Da sie als noexcept deklariert ist, wirft sie keine Exceptions und liefert keine Fehlercodes [SWS_AIDSM_10809].
Nebenläufigkeit: Die Operation ist in der Spezifikation explizit als not thread-safe deklariert [SWS_AIDSM_10809]. Aufrufende Komponenten müssen daher sicherstellen, dass Aufrufe von StopOffer gegenüber anderen Zugriffen auf dieselbe Instanz extern synchronisiert werden.
Aufrufkontext: Der Aufruf dürfte zweckmäßigerweise im Rahmen des geordneten Herunterfahrens oder bei der Deregistrierung des Ereignisempfängers erfolgen, bevor die Instanz zerstört wird. Frage Q-77dc1d3a09426bdf (offen)
Das Entwurfsmuster existiert analog bei weiteren Service-Providern des Moduls aidsm. So beendet StopOffer im Header ara/idsm/timestamp_provider.h nachfolgende Aufrufe von GetTimestamp durch das IdsM [SWS_AIDSM_10409], während die gleichnamige Funktion in ara/idsm/context_data_provider.h künftige Aufrufe von ModifyContextData unterbindet [SWS_AIDSM_10508]. Beide verwandten Schnittstellen sind gleichermaßen nicht threadsicher ausgeführt.
Dieser Verwendungshinweis wurde automatisiert erstellt und stützt sich ausschließlich auf die AUTOSAR-Spezifikation.
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-medium· 2026-10-13