Intrusion Detection System Manager (IdsM)

De synchrone en niet-reentrante interface IdsM_Init dient voor de fundamentele initialisatie van de module IdsM conform [SWS_IdsM_91001]. Bij de aanroep initialiseert de service alle interne variabelen en brengt het IdsM in de toestand geïnitialiseerd ([SWS_IdsM_00202]). Via de invoerparameter configPtr accepteert de functie een pointer naar de modulespecifieke configuratiestructuur ([SWS_IdsM_91001]).

De uitvoering van IdsM_Init vormt een dwingende functionele randvoorwaarde voor de werking van de module. Wordt een API van het IdsM buiten IdsM_Init of IdsM_GetVersionInfo in nog niet-geïnitialiseerde toestand aangeroepen, dan meldt de module bij geactiveerde ontwikkelingsdetectie (IdsMDevErrorDetect) de fout IDSM_E_PARAM_UNINIT via Det_ReportError ([SWS_IdsM_00203], zie ook de foutcode 0x0D onder [SWS_IdsM_02003]).

Voor de foutafhandeling en de aanroepcontext gelden specifieke gedragsregels:

• Als IdsM_Init wordt aangeroepen terwijl de module zich al in de toestand geïnitialiseerd bevindt, blijft een herinitialisatie van de interne variabelen achterwege ([SWS_IdsM_00204]).
• In plaats daarvan meldt de module bij geactiveerde IdsMDevErrorDetect via Det_ReportError de ontwikkelingsfout IDSM_E_ALREADY_INITIALIZED met de numerieke waarde 0x0E ([SWS_IdsM_00204], [SWS_IdsM_02003]).
• De functie heeft geen retourwaarde en is gedefinieerd als niet-reentrant ([SWS_IdsM_91001]). Deze mag daarom in het systeem niet gelijktijdig of door onderbrekende contexten meervoudig tegelijk worden aangeroepen.

Gebruik en aanroepcontext

De functie IdsM_MainFunction wordt periodiek aangeroepen en is beschikbaar via het headerbestand IdsM.h [SWS_IdsM_91000]. Deze heeft de signatuur void IdsM_MainFunction(void), accepteert geen parameters en heeft geen retourwaarde [SWS_IdsM_91000]. De aanroep van de functie zelf is synchroon, maar dient voor de asynchrone verwerking van beveiligingsgebeurtenissen (Security Events, SEv) die eerder tijdens synchrone API-aanroepen in wachtrijen zijn geplaatst [SWS_IdsM_91000]. De periodieke activering zal typisch plaatsvinden via de BSW-scheduler of een cyclische besturingssysteemtaak. Vraag Q-86e2e870c3496bad (open)

Gelijktijdigheid en beperkingen

Volgens de specificatie is IdsM_MainFunction geclassificeerd als niet-re-entrant (Non Reentrant) [SWS_IdsM_91000]. De aanroepende systeemomgeving moet daarom waarborgen dat de functie op elk tijdstip slechts in één enkele instantie wordt uitgevoerd en dat er geen overlappende aanroepen plaatsvinden.

Wisselwerking bij de verwerking van gebeurtenissen

De hoofdtaak in het kader van de cyclische afhandeling omvat de volgende aspecten:

• Event-buffers: Na ontvangst van een SEv slaat de IdsM deze op in een event-buffer; deze buffers worden in het kader van IdsM_MainFunction asynchroon beheerd en gefilterd [SWS_IdsM_00702].
• Contextdatabuffers: Wordt een SEv met contextdata ontvangen, dan gebruikt de IdsM geschikte buffers uit een Context Data Buffer Pool; ook deze buffers worden in IdsM_MainFunction asynchroon beheerd en gefilterd [SWS_IdsM_00705].
• Kwalificatie: De in de event-buffers opgeslagen SEv's worden asynchroon verwerkt om ze te identificeren als gekwalificeerde beveiligingsgebeurtenissen (QSEv) [SWS_IdsM_00901].

De callback-functie wordt synchroon en re-entrant aangeroepen om zenddata voor segmenten van een I-PDU (N-PDU) op te halen [SWS_IdsM_91010]. Deze is beschikbaar via de header IdsM_Cbk.h en bedient het service-ID 0x43 [SWS_IdsM_91010].

Via id wordt de te verzenden I-PDU geïdentificeerd [SWS_IdsM_91010]. De parameter info draagt de doelbuffer (SduDataPtr) en de gevraagde bytelengte (SduLength) over; een waarde van 0 voor SduLength (waarbij SduDataPtr een NULL_PTR mag zijn) dient voor toestandsveranderingen in de parameter retry of voor het opvragen van resterende data [SWS_IdsM_91010]. Via availableDataPtr meldt de functie de in de Tx-buffer resterende hoeveelheid data terug, wat transportprotocollen met dynamische nuttige lengtes (bijv. FrIsoTp) in staat stelt de grootte van opeenvolgende opeenvolgende frames (Consecutive Frames) te bepalen [SWS_IdsM_91010].

Is retry een NULL_PTR, dan mogen gekopieerde data direct na het kopiëren worden vrijgegeven uit de buffer [SWS_IdsM_91010]. Anders stuurt RetryInfoType de foutafhandeling aan: bij TP_CONFPENDING blijven eerder gekopieerde data in de TP-buffer aanwezig, terwijl TP_DATACONF alle vóór deze aanroep gekopieerde data bevestigt en vrijgeeft [SWS_IdsM_91010]. Staat TpDataState op TP_DATARETRY, dan kopieert de functie eerder overgedragen data opnieuw vanaf de door TxTpDataCnt aangegeven byte-offset [SWS_IdsM_91010].

De functie retourneert BUFREQ_OK bij een succesvolle volledige kopie [SWS_IdsM_91010]. Zijn er niet voldoende zenddata beschikbaar, dan worden er geen data gekopieerd en wordt BUFREQ_E_BUSY geretourneerd, waarna de onderliggende module de aanroep kan herhalen [SWS_IdsM_91010]. Mislukt het verzoek, dan volgt teruggave van BUFREQ_E_NOT_OK zonder data-overname [SWS_IdsM_91010].

De functie IdsM_SetSecurityEvent dient als interface voor applicaties om beveiligingsgebeurtenissen aan de module IdsM (Intrusion Detection System Manager) te melden [SWS_IdsM_91002].

Gebruik en aanroepcontext

De aanroep vindt synchroon plaats via het headerbestand IdsM.h met de service-ID 0x03 [SWS_IdsM_91002]. Als enige overdrachtsparameter wordt de identifier van de beveiligingsgebeurtenis doorgegeven:

• securityEventId (IN, IdsM_SecurityEventIdType): Unieke identifier van de gemelde beveiligingsgebeurtenis [SWS_IdsM_91002].

De functie heeft geen retourwaarde (void) [SWS_IdsM_91002].

Foutafhandeling

Is de detectie van ontwikkelingsfouten (IdsMDevErrorDetect) geactiveerd, dan controleert de module de parameter securityEventId tegen de geconfigureerde beveiligingsgebeurtenissen [SWS_IdsM_02101]. Als een onbekende gebeurtenis-ID wordt doorgegeven die niet in IdsMEvent is geconfigureerd, meldt het IdsM de ontwikkelingsfout IDSM_E_PARAM_INVALID [SWS_IdsM_02101].

Gelijktijdigheid en beperkingen

De functie is gespecificeerd als niet-reentrant (Non Reentrant) [SWS_IdsM_91002]. Gelijktijdige of onderbrekende aanroepen vanuit verschillende contexten moeten daarom door de aanroeper worden gesynchroniseerd resp. vermeden.

De functie IdsM_SetSecurityEventWithContextData dient als applicatie-interface voor het synchroon melden van beveiligingsgebeurtenissen inclusief optionele contextdata aan de Intrusion Detection System Manager ([SWS_IdsM_91003]). De functie heeft geen retourwaarde.

Parameters en gebruik

• securityEventId: Unieke identificator van de gemelde beveiligingsgebeurtenis ([SWS_IdsM_91003]).
• contextData: Pointer naar optionele contextdata; als er geen contextdata beschikbaar zijn, moet NULL_PTR worden doorgegeven ([SWS_IdsM_91003]).
• contextDataSize: Grootte van de verstrekte contextdata in bytes ([SWS_IdsM_91003]).

Foutafhandeling

Bij geactiveerde ontwikkelingsdetectie (IdsMDevErrorDetect) voert de IdsM-module de volgende controles uit:

• Als de doorgegeven securityEventId niet afkomstig is uit de in IdsMEvent geconfigureerde beveiligingsgebeurtenissen, wordt de ontwikkelingsfout IDSM_E_PARAM_INVALID gemeld ([SWS_IdsM_02102]).
• Overschrijdt contextDataSize de maximaal geconfigureerde buffergrootte voor contextdata (gedefinieerd via de grootste geparametriseerde waarde van IdsMContextDataBufferSize), dan wordt de ontwikkelingsfout IDSM_E_PARAM_LENGTH gemeld ([SWS_IdsM_02107]).

Gelijktijdigheid en integratie

De interface is gespecificeerd als niet-re-entrant (Non Reentrant) ([SWS_IdsM_91003]). Aanroepers moeten er daarom voor zorgen dat concurrerende aanroepen worden vermeden of dienovereenkomstig worden gesynchroniseerd. De declaratie is beschikbaar via de header IdsM.h ([SWS_IdsM_91003]).

De synchrone functie IdsM_SetSecurityEventWithCount (service-ID 0x05) vormt de applicatie-interface voor Smart Sensors om beveiligingsgebeurtenissen (Security Events, SEvs) samen met een tellerwaarde door te geven aan de IdsM [SWS_IdsM_91018], [SWS_IdsM_00401]. Hierdoor kan de IdsM gebeurtenissen ontvangen met een door de sensor vooraf berekende teller [SWS_IdsM_00401]. De functiedeclaratie wordt via het headerbestand IdsM.h beschikbaar gesteld [SWS_IdsM_91018].

Bij de aanroep verwacht de functie twee ingangsparameters:

• securityEventId: Identificatie van de beveiligingsgebeurtenis van het type IdsM_SecurityEventIdType [SWS_IdsM_91018].
• count: Tellerwaarde van het type uint16, die afkomstig is van de sensor en fungeert als initiële startwaarde voor de gebeurtenis [SWS_IdsM_91018], [SWS_IdsM_00401].

De functie levert geen retourwaarde op en definieert geen uitgangsparameters [SWS_IdsM_91018]. Wat betreft concurrency en aanroepcontext is de functie gedeclareerd als niet re-entrant (Non Reentrant) [SWS_IdsM_91018]; parallelle aanroepen moeten daarom softwarematig worden vermeden.

Voor de foutafhandeling is vastgelegd dat de IdsM bij geactiveerde ontwikkelingsdetectie (IdsMDevErrorDetect) de parameters securityEventId en count controleert [SWS_IdsM_02103]. Wordt er een onbekende event-ID doorgegeven of heeft count de waarde 0, dan wordt de ontwikkelingsfout IDSM_E_PARAM_INVALID gemeld [SWS_IdsM_02103].

De functie IdsM_SetSecurityEventWithCountContextData dient als applicatie-interface voor smart sensors voor het synchroon melden van beveiligingsgebeurtenissen met tellerwaarde en optionele contextdata aan de [SWS_IdsM_91019].

Gebruik en parameters

De aanroep vindt synchroon plaats en is gespecificeerd als niet-re-entrant (Non Reentrant) [SWS_IdsM_91019]:

• securityEventId: Unieke identificator van de beveiligingsgebeurtenis [SWS_IdsM_91019].
• count: Tellerwaarde die als startwaarde voor de beveiligingsgebeurtenis wordt gebruikt [SWS_IdsM_91019].
• contextData: Pointer naar een byte-array met de beschikbaar te stellen contextdata [SWS_IdsM_00502]. Als er geen contextdata aanwezig zijn, moet NULL_PTR worden doorgegeven [SWS_IdsM_91019].
• contextDataSize: Grootte van de doorgegeven contextdata in bytes [SWS_IdsM_91019]. De functie ondersteunt een maximale lengte tot 1500 bytes [SWS_IdsM_00501].

Foutafhandeling

Bij geactiveerde ontwikkelingsdetectie (IdsMDevErrorDetect) controleert de module de geldigheid van de doorgegeven argumenten:

• De ontwikkelingsfout IDSM_E_PARAM_INVALID wordt gemeld als er een onbekende securityEventId wordt doorgegeven of als count de waarde 0 heeft [SWS_IdsM_02104].
• Overschrijdt contextDataSize de maximaal geconfigureerde buffergrootte (bepaald door de grootste geconfigureerde IdsMContextDataBufferSize), dan meldt de IdsM de ontwikkelingsfout IDSM_E_PARAM_LENGTH [SWS_IdsM_02108].

De functie levert geen retourwaarde op [SWS_IdsM_91019]; een foutreactie zal in geval van een fout primair gebaseerd zijn op de melding via de DET. Vraag Q-135f4b865790f34d (open)

De synchrone interface IdsM_SetSecurityEventWithTimestampCount dient voor Smart Sensors om beveiligingsgebeurtenissen met tijdstempel en tellerwaarde te melden aan de IdsM [SWS_IdsM_91020]. De functie heeft geen retourwaarde en is beschikbaar via het headerbestand IdsM.h [SWS_IdsM_91020].

De volgende invoerparameters worden verwerkt:

• securityEventId: Specifieke identificatie van de gemelde beveiligingsgebeurtenis [SWS_IdsM_91020].
• timestamp: Tijdstempel voor de temporele referentie van de gebeurtenis [SWS_IdsM_91020]. Is de tijdstempelfunctie actief en wordt een tijdstempel doorgegeven, dan gebruikt de IdsM deze voor de opslag of overdracht van het gekwalificeerde Security Event (QSEv) [SWS_IdsM_01108]. Wordt de gebeurtenis bij actieve feature daarentegen zonder tijdstempel gemeld, dan stelt de IdsM het optiebit voor de tijdstempel in de protocolheader vóór overdracht of opslag in op 0 [SWS_IdsM_01112].
• count: Tellerwaarde als startwaarde voor de beveiligingsgebeurtenis [SWS_IdsM_91020]. Als er vooraf geen berekende teller beschikbaar is, kan de functie met de waarde 1 worden aangeroepen [SWS_IdsM_00405].

Bij geactiveerde ontwikkelingsdetectie (IdsMDevErrorDetect) valideert de IdsM de argumenten securityEventId en count. Indien een onbekende event-ID wordt doorgegeven of count de waarde 0 heeft, meldt de module de ontwikkelingsfout IDSM_E_PARAM_INVALID [SWS_IdsM_02105].

Met betrekking tot concurrency is de functie gespecificeerd als niet re-entrant (Non Reentrant) [SWS_IdsM_91020].

De functie IdsM_SetSecurityEventWithTimestampCountContextData met de service-ID 0x08 dient als gestandaardiseerde applicatie-interface voor Smart Sensors om beveiligingsgebeurtenissen samen met een tijdstempel, een starttellerwaarde en optionele contextgegevens aan de Intrusion Detection System Manager (IdsM) te melden [SWS_IdsM_91021]. De declaratie van deze interface wordt beschikbaar gesteld via de header IdsM.h [SWS_IdsM_91021].

De aanroep wordt synchroon uitgevoerd en gebruikt uitsluitend ingangsparameters, terwijl er noch in-/uitgangsparameters noch uitgangsparameters bestaan [SWS_IdsM_91021]. Bij de aanroep moeten de volgende parameters worden doorgegeven [SWS_IdsM_91021]:

• securityEventId: Identificatie van de specifieke beveiligingsgebeurtenis die naar de IdsM moet worden verzonden [SWS_IdsM_91021].
• timestamp: Tijdstempelwaarde die fungeert als temporele referentie van de opgetreden beveiligingsgebeurtenis [SWS_IdsM_91021].
• count: Tellerwaarde die door de IdsM wordt gebruikt als startwaarde voor de desbetreffende beveiligingsgebeurtenis [SWS_IdsM_91021].
• contextData: Pointer naar optionele contextgegevens bij de gebeurtenis; als er geen gegevens beschikbaar zijn, moet NULL_PTR worden doorgegeven [SWS_IdsM_91021].
• contextDataSize: Numerieke opgave van de grootte van de doorgegeven contextgegevens [SWS_IdsM_91021].

Wat betreft het uitvoeringsgedrag is de functie geclassificeerd als niet re-entrant (Non Reentrant) en heeft deze geen retourwaarde (void) [SWS_IdsM_91021]. Aanroepende Smart Sensors moeten er daarom voor zorgen dat er geen gelijktijdige of overlappende aanroepen van de interface plaatsvinden [SWS_IdsM_91021].

De callback-functie IdsM_BswM_StateChanged ([SWS_IdsM_91005]) wordt aangeroepen door de BswM om wijzigingen van de actuele toestand van de regeleenheid te signaleren aan de Intrusion Detection System Manager (IdsM) ([SWS_IdsM_91005]). Deze is gedeclareerd in het headerbestand IdsM_Cbk.h en heeft de service-ID 0x0F ([SWS_IdsM_91005]).

De interface heeft de signatuur void IdsM_BswM_StateChanged (IdsM_Filters_BlockStateType state) ([SWS_IdsM_91005]). Als enige overdrachtswaarde dient de ingangsparameter state van het type IdsM_Filters_BlockStateType, die de actuele ECU-toestand afbeeldt ([SWS_IdsM_91005]). Er zijn noch in-/uitgangsparameters noch uitgangsparameters voorzien, en de functie retourneert geen retourwaarde ([SWS_IdsM_91005]). De aanroep wordt synchroon uitgevoerd en is geclassificeerd als reentrant ([SWS_IdsM_91005]).

In het functionele samenspel dient deze notificatieservice ertoe het IdsM door de BswM doorlopend te informeren over de actuele toestand ([SWS_IdsM_01022]). De ontvangen toestandsinformatie wordt binnen het IdsM bewaard en bij de latere asynchrone verwerking van block-state-filters (block state filter) in het kader van de hoofdfunctie (main function) geëvalueerd ([SWS_IdsM_01022]). Voor deze aanroep zijn binnen de specificatieomvang geen specifieke foutcodes, retourwaarden of meldingen aan het ontwikkelingsfout- (DET) of diagnose-event-management (DEM) vastgelegd.

De callback-functie IdsM_TpTxConfirmation wordt als synchrone en re-entrante service gedeclareerd via het headerbestand IdsM_Cbk.h [SWS_IdsM_91011]. Conform [SWS_IdsM_01502] ontvangt de module IdsM via deze service de bevestiging van de module PduR voor de overdracht van een gesegmenteerde PDU. De aanroep vindt plaats zodra de betreffende I-PDU op het onderliggende netwerk is overgedragen [SWS_IdsM_91011].

De interface heeft het service-ID 0x48 en levert geen retourwaarde op (void) [SWS_IdsM_91011]. Bij de aanroep worden twee ingangsparameters doorgegeven:

• id (type PduIdType): Unieke identificatie van de overgedragen I-PDU [SWS_IdsM_91011].
• result (type Std_ReturnType): Verzendt het resultaat van de I-PDU-overdracht en geeft aan of het verzendproces succesvol was of mislukte [SWS_IdsM_91011].

Specifieke foutcodes evenals DET- of DEM-meldingen zijn voor deze aanroep niet gedefinieerd in de specificatie. Dankzij de gespecificeerde re-entrantie kan de functie door de aanroepende laag parallel voor verschillende I-PDU's worden aangeroepen [SWS_IdsM_91011]. Interpretatie: De module IdsM zal de statusparameter result vermoedelijk evalueren om de interne overdrachtsstatus van de gesegmenteerde PDU bij te werken en bezette verzendbuffers na afronding vrij te geven. Vraag Q-9179efcbf744346d (open)

Gebruik

De callbackfunctie IdsM_TxConfirmation ([SWS_IdsM_91009]) wordt door een onderliggende communicatie-interfacemodule aangeroepen om de succesvolle verzending van een PDU of het mislukken van de overdracht te bevestigen. Deze is synchroon gedefinieerd, gedeclareerd in IdsM_Cbk.h en heeft geen retourwaarde. Zij accepteert de volgende parameters:

• TxPduId: Identificatie van de overgedragen PDU ([SWS_IdsM_91009]).
• result: Overdrachtsresultaat met E_OK bij succesvolle verzending resp. E_NOT_OK bij een opgetreden fout ([SWS_IdsM_91009]).

Gelijktijdigheid en beperkingen

De functie is re-entrant voor verschillende PDU-ID's, maar niet re-entrant voor dezelfde TxPduId ([SWS_IdsM_91009]).

Samenspel en volgordevoorwaarden

Voor de overdrachtsvolgorde geldt een strikte volgordevoorwaarde: volgens [SWS_IdsM_01499] mag de IdsM de verzendfunctie PduR_IdsMTransmit pas opnieuw aanroepen nadat vooraf IdsM_TxConfirmation of IdsM_TpTxConfirmation is aangeroepen. Interpretatie: de ontvangst van de bevestiging dient in de IdsM vermoedelijk als trigger om de overdracht af te ronden en vervolgaanroepen vrij te geven. Vraag Q-dd4013520e85370c (open)

Foutafhandeling

Het mislukken van de PDU-overdracht wordt direct via de parameter result = E_NOT_OK gemeld ([SWS_IdsM_91009]). Specifieke DET- of DEM-foutcodes zijn in de interfacespecificatie niet vermeld.

Gebruik en aanroepcontext

De synchrone functie IdsM_Dcm_GetReportingMode_RequestResults (service-ID 0x0D, header IdsM_Cbk.h) wordt aangeroepen door de Diagnostic Communication Manager (DCM) om de routineresultaten van een eerder via IdsM_Dcm_GetReportingMode_Start() geïnitieerd verzoek op te vragen [SWS_IdsM_91007]. Via de overdrachtsparameter OpStatus wordt de actuele operationele status verzonden [SWS_IdsM_91007]. Bij succesvolle afronding levert de functie E_OK terug en geeft via de uitvoerpointer Out_ReportingMode de vastgestelde rapportagemodus van het opgevraagde Security Event door [SWS_IdsM_91007]. Als de verwerking nog niet is voltooid, signaleert deze dit via de retourwaarde DCM_E_PENDING [SWS_IdsM_91007].

Foutafhandeling

Mislukt de opvraag, dan retourneert de functie E_NOT_OK [SWS_IdsM_91007]. In dit geval moet via de parameter ErrorCode een concrete Negative Response Code (Dcm_NegativeResponseCodeType) worden ingesteld; blijft deze oningesteld, dan verzendt de DCM de foutcode 0x22 [SWS_IdsM_91007]. Specifieke DET- of DEM-events zijn voor deze service niet aangeduid [SWS_IdsM_91007].

Gelijktijdigheid en wisselwerking

De functie is gespecificeerd als reentrant [SWS_IdsM_91007]. Wat betreft de aanroepvolgorde vereist deze dwingend dat de routine eerder via IdsM_Dcm_GetReportingMode_Start() werd geactiveerd [SWS_IdsM_91007]. Interpretatie: De parameter OpStatus wordt vermoedelijk door de DCM gebruikt bij herhaalde opvragingen na teruggave van DCM_E_PENDING om de voortgang van de diagnoseoperatie te coördineren. Vraag Q-c268fab018a1f5b3 (open)

De functie IdsM_Dcm_GetReportingMode_Start wordt aangeroepen door de diagnosemodule (DCM) om in de Intrusion Detection System Manager (IdsM) de uitvoering te starten van een routine voor het opvragen van de actuele rapportagemodus van een specifiek security-event (SEv) [SWS_IdsM_91006], [SWS_IdsM_02001]. De interface is gedeclareerd in de header IdsM_Cbk.h, heeft het service-ID 0x0C en is gespecificeerd als synchroon en re-entrant [SWS_IdsM_91006].

Bij de aanroep geeft de DCM het externe ID van het beveiligingsincident (In_SecurityEventId), het instantie-ID van de sensor (In_SensorInstanceId) en de bewerkingsstatus (OpStatus) door [SWS_IdsM_91006]. Als retourwaarde levert de functie Std_ReturnType op:

• E_OK: De operatie is met succes voltooid [SWS_IdsM_91006].
• DCM_E_PENDING: De bewerking is nog niet voltooid [SWS_IdsM_91006]. Dit zal vermoedelijk betekenen dat de interne verwerking van de routine over meerdere cycli resp. asynchroon wordt voortgezet totdat de gegevens beschikbaar zijn. Vraag Q-395a30fc3ed42497 (open)
• E_NOT_OK: De operatie is mislukt [SWS_IdsM_91006].

In geval van een fout (E_NOT_OK) is de IdsM verplicht om via de uitgangsparameter ErrorCode een concrete Negative Response Code (NRC) te verstrekken; gebeurt dit niet, dan verzendt de DCM standaard de NRC 0x22 (Conditions Not Correct) [SWS_IdsM_91006].

De functie start de routine slechts; het daadwerkelijke uitlezen van de verkregen resultaten vindt vervolgens plaats via de functie IdsM_Dcm_GetReportingMode_RequestResults [SWS_IdsM_91007].

De synchrone en reentrante functie IdsM_Dcm_SetReportingMode_Start wordt aangeroepen door de diagnosemodule (DCM) om de routine voor het wijzigen van de rapportagemodus (IdsMReportingModeFilter) voor een specifiek beveiligingsgebeurtenis in de Intrusion Detection System Manager te starten [SWS_IdsM_91008], [SWS_IdsM_01901]. De declaratie wordt beschikbaar gesteld via het headerbestand IdsM_Cbk.h [SWS_IdsM_91008].

Bij de aanroep worden de externe gebeurtenis-ID (In_SecurityEventId), de sensorinstantie-ID (In_SensorInstanceId), de nieuw in te stellen rapportagemodus (In_ReportingMode) en de operationele status (OpStatus) doorgegeven [SWS_IdsM_91008], [SWS_IdsM_01901]. De functie levert de volgende retourwaarden:

• E_OK: De uitvoering van de operatie is succesvol voltooid [SWS_IdsM_91008].
• DCM_E_PENDING: De verwerking is nog niet voltooid en wordt asynchroon voortgezet [SWS_IdsM_91008].
• E_NOT_OK: De operatie is mislukt; in dit geval moet via de uitgangsparameter ErrorCode een concrete Negative Response Code (NRC) worden ingesteld, aangezien de DCM anders de NRC 0x22 verzendt [SWS_IdsM_91008].

Mislukt de validatie van de gebeurtenis-ID omdat er een ongeldige Security Event Definition ID is gebruikt, dan retourneert de functie E_NOT_OK en stelt deze de foutcode ErrorCode dwingend in op DCM_E_REQUESTOUTOFRANGE [SWS_IdsM_01903].

Het gegevenstype IdsM_Filters_BlockStateType dient voor de definitie van bitmaskers voor zogeheten „Block State”-filters van de Intrusion Detection System Manager (IdsM) conform [SWS_IdsM_91017]. Het type is afgeleid van uint16, dekt het integer-waardebereik van 0 tot 65535 en wordt via de header IdsM_Filters_Types.h beschikbaar gemaakt voor softwaremodules ([SWS_IdsM_91017]).

De primaire toepassing vindt plaats in samenspel met de Basic Software Mode Manager (BswM). Bij wijzigingen in de systeem- of regeleenheidtoestand roept de BswM de callbackfunctie IdsM_BswM_StateChanged aan en geeft de actuele toestand van de regeleenheid door via parameter state van dit type ([SWS_IdsM_91005]). Deze callback-interface is gedeclareerd in IdsM_Cbk.h, heeft geen retourwaarden en is gespecificeerd als synchroon en re-entrant ([SWS_IdsM_91005]).

Interpretatie: aangezien het type is ontworpen als bitmasker voor filters, vergelijkt de IdsM de doorgegeven ECU-toestandswaarde vermoedelijk met geconfigureerde filtertoestanden om de registratie of blokkering van beveiligingsgebeurtenissen afhankelijk van de toestand van de regeleenheid te filteren. Vraag Q-00b355cc5ec6383f (open) Een zelfstandige foutafhandeling met specifieke foutcodes, DET- of DEM-meldingen bestaat niet voor dit gegevenstype.

Het gegevenstype IdsM_Filters_ReportingModeType is gebaseerd op het basistype uint8 en wordt via het headerbestand IdsM_Types.h beschikbaar gesteld voor softwarecomponenten [SWS_IdsM_91013]. Het beschrijft de gestandaardiseerde rapportagemodi die binnen het reporting-mode-filter in de Intrusion Detection System Manager (IdsM) worden toegepast voor de gerichte verwerking en doorzending van beveiligingsgebeurtenissen [SWS_IdsM_91013].

Via de gedefinieerde enumeratiewaarden wordt nauwkeurig gestuurd of een gebeurtenis wordt gemeld en welk detailniveau daarbij wordt gehanteerd [SWS_IdsM_91013]:

• IDSM_REPORTING_MODE_OFF (0x00): De gebeurtenis wordt onderdrukt en niet gemeld aan bovenliggende instanties [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_BRIEF (0x01): De gebeurtenis wordt zonder aanvullende contextgegevens in compacte vorm gemeld [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_DETAILED (0x02): De gebeurtenis wordt uitvoerig gemeld, met inbegrip van alle relevante contextgegevens [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_BRIEF_BYPASSING_FILTERS (0x03): De gebeurtenis omzeilt navolgende filterfasen en wordt zonder contextgegevens ongefilterd gemeld [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_DETAILED_BYPASSING_FILTERS (0x04): De gebeurtenis omzeilt navolgende filterfasen en wordt ongefilterd inclusief alle contextgegevens gemeld [SWS_IdsM_91013].
• IDSM_REPORTING_MODE_INVALID (0xFF): Markeert een ongeldige rapportagemodus binnen het waardebereik [SWS_IdsM_91013].

De waarden combineren zodoende twee functionele besturingsdimensies: het detailniveau via de contextgegevens en het gericht omzeilen van reguliere filtermechanismen door bypassing [SWS_IdsM_91013]. Dit stelt de IdsM in staat om beveiligingsincidenten gedifferentieerd af te handelen afhankelijk van de criticaliteit en filterconfiguratie [SWS_IdsM_91013].