class ara::crypto::CryptoErrorDomain

Verwendung und Aufrufkontext

Der Standardkonstruktor CryptoErrorDomain() initialisiert eine Instanz der Fehlerdomäne für kryptografische Operationen [SWS_CRYPT_19902]. Er ist als constexpr und noexcept spezifiziert, nimmt keine Argumente entgegen und besitzt keinen Rückgabewert. Die Ausführung erfolgt synchron und kann zur Übersetzungszeit stattfinden. In Anwendungsprogrammen dürfte eine manuelle Instanziierung selten erforderlich sein, da der Zugriff auf die Domäne regulär über die globale Funktion GetCryptoErrorDomain() erfolgt [SWS_CRYPT_19952]. Frage Q-1e029d80fb7bf7d1 (offen)

Fehlerbehandlung und Nebenläufigkeit

Die Erzeugung des Objekts ist als exception safe sowie thread-safe definiert [SWS_CRYPT_19902]. Da der Konstruktor mit noexcept deklariert ist, treten beim Aufruf keine Fehler oder Ausnahmen auf; Fehlermeldungen an DET oder DEM existieren für diesen Konstruktor nicht.

Zusammenspiel im Modul

Die erzeugte Domäne bildet den Kontext für kryptografische Fehlerbeschreibungen:

• Sie kapselt die Fehlercodes der Aufzählung CryptoErrc [SWS_CRYPT_10099] über den Typalias Errc [SWS_CRYPT_19903].
• Über die freie Funktion MakeErrorCode() werden Instanzen von ara::core::ErrorCode erstellt, die fest auf diese Domäne referenzieren [SWS_CRYPT_19951].
• Die Elementfunktionen der Domäne ermöglichen die Abfrage des Bezeichners via Name() [SWS_CRYPT_19950], die Textauflösung über Message() [SWS_CRYPT_19953] sowie das Werfen systemspezifischer Fehler über ThrowAsException() [SWS_CRYPT_19954] mit dem Basistyp Exception [SWS_CRYPT_19904].

Die Methode Message der Klasse ara::crypto::CryptoErrorDomain übersetzt einen Fehlercodewert in eine lesbare Klartext-Fehlermeldung [SWS_CRYPT_19953]. Sie überschreibt die Basismethode zur Fehlertextauflösung und wird über die Header-Datei ara/crypto/common/crypto_error_domain.h eingebunden [SWS_CRYPT_19953]. Zudem ist die Schnittstelle fachlich mit der Anforderung RS_CRYPTO_02310 verknüpft [SWS_CRYPT_19953].

Verwendung und Aufrufkontext

Der Aufruf erfolgt synchron als konstante Elementfunktion (const), wodurch die Methode zustandslos arbeitet und das Fehlerdomänenobjekt unverändert bleibt [SWS_CRYPT_19953]. Die Funktion erwartet folgenden Eingabeparameter [SWS_CRYPT_19953]:

• errorCode: Ein numerischer Fehlercode-Identifikator aus der Aufzählung CryptoErrc, der übergeben wird als Typ ara::core::ErrorDomain::CodeType [SWS_CRYPT_19953].

Als Rückgabewert liefert die Funktion einen Zeiger auf eine konstante Zeichenkette (const char *), welcher den beschreibenden Nachrichtentext zum jeweiligen Fehlercode enthält [SWS_CRYPT_19953].

Nebenläufigkeit und Ausnahmesicherheit

Hinsichtlich Ausführungssicherheit und Nebenläufigkeit gelten folgende Randbedingungen [SWS_CRYPT_19953]:

• Thread-Sicherheit: Die Funktion ist explizit als threadsicher (thread-safe) spezifiziert, wodurch konkurrierende Aufrufe aus unterschiedlichen Threads ohne externe Synchronisation zulässig sind [SWS_CRYPT_19953].
• Ausnahmesicherheit: Die Methode ist als ausnahmesicher (exception safe) eingestuft und mit dem Spezifizierer noexcept versehen, weshalb garantiert keine C++-Ausnahmen ausgelöst werden [SWS_CRYPT_19953].

Die Elementfunktion Name der Klasse ara::crypto::CryptoErrorDomain liefert den eindeutigen Bezeichner der Fehlerdomäne für kryptografische Operationen [SWS_CRYPT_19950]. Die Funktion wird über die Header-Datei ara/crypto/common/crypto_error_domain.h bereitgestellt und überschreibt die entsprechende Basisschnittstelle für Fehlerdomänen [SWS_CRYPT_19950].

Verwendung und Semantik

Der Aufruf erfolgt synchron, parameterlos und ohne verändernde Nebeneffekte auf die Instanz. Als Rückgabewert wird ein const char * zurückgegeben, der den eindeutigen Namen der Domäne repräsentiert [SWS_CRYPT_19950]. Interpretation: Der zurückgegebene Zeiger dürfte auf eine statisch persistierte Zeichenkette verweisen, da die Schnittstelle keinen dynamischen Lebenszyklus oder Speicherbesitzübergang vorsieht. Frage Q-b7f2dab65f25b7e6 (offen)

Fehlerbehandlung und Nebenläufigkeit

• Ausnahmesicherheit: Die Methode ist mit noexcept deklariert und als ausnahmesicher (exception safe) definiert, sodass Aufrufer keine C++-Exceptions abfangen müssen [SWS_CRYPT_19950].
• Fehlersignalisierung: Für die Funktion sind keine spezifischen Fehlercodes spezifiziert; der Namensabruf schlägt im regulären Betrieb nicht fehl [SWS_CRYPT_19950].
• Thread-Sicherheit: Die Operation ist als thread-safe spezifiziert und kann ohne externe Sperrmechanismen nebenläufig aus mehreren Threads ausgeführt werden [SWS_CRYPT_19950].

Zusammenspiel

Die Funktion dient innerhalb des AUTOSAR-Adaptive-Fehlerbehandlungsmodells der Identifikation der Fehlerdomäne bei der Auswertung und Protokollierung kryptografischer Fehlerursachen [SWS_CRYPT_19950].

Die Methode ThrowAsException der Klasse ara::crypto::CryptoErrorDomain dient dem Auslösen einer C++-Exception auf Basis eines übergebenen Fehlercodes [SWS_CRYPT_19954]. Sie überschreibt die entsprechende Basismethode und ist mit dem Attribut [[noreturn]] deklariert, weshalb Aufrufe keinen Rückgabewert besitzen und bei erfolgreicher Ausführung nicht regulär zurückkehren [SWS_CRYPT_19954].

Hinsichtlich Verwendung und Parametrierung gelten folgende Spezifikationsdetails:

• Parameter: Als Eingabeparameter wird errorCode vom Typ const ara::core::ErrorCode& übergeben, der eine Fehlerkennung aus der Aufzählung CryptoErrc kapselt [SWS_CRYPT_19954].
• Header-Einbindung: Die Funktion wird über die Header-Datei #include "ara/crypto/common/crypto_error_domain.h" bereitgestellt [SWS_CRYPT_19954].
• Nebenläufigkeit: Die Ausführung ist als thread-safe spezifiziert und kann somit sicher aus nebenläufigen Kontexten aufgerufen werden [SWS_CRYPT_19954].

In Bezug auf die Fehlerbehandlung und Ausnahme-Sicherheit ist die Methode als not exception safe eingestuft [SWS_CRYPT_19954]. Eine wesentliche Compiler- und Toolchain-Einschränkung ergibt sich aus [SWS_CORE_10304]: Falls C++-Exceptions in der Compiler-Toolchain deaktiviert sind, nimmt ThrowAsException nicht an der Überladungsauflösung teil und steht dem Aufrufer somit nicht zur Verfügung [SWS_CRYPT_19954].