classe ara::crypto::CryptoErrorDomain

Utilisation et contexte d'appel

Le constructeur par défaut CryptoErrorDomain() initialise une instance du domaine d'erreur pour les opérations cryptographiques [SWS_CRYPT_19902]. Il est spécifié comme constexpr et noexcept, n'accepte aucun argument et ne possède aucune valeur de retour. L'exécution s'effectue de manière synchrone et peut avoir lieu au moment de la compilation. Dans les programmes applicatifs, une instanciation manuelle devrait rarement être nécessaire, car l'accès au domaine s'effectue régulièrement via la fonction globale GetCryptoErrorDomain() [SWS_CRYPT_19952]. Question Q-1e029d80fb7bf7d1 (ouverte)

Gestion des erreurs et concurrence

La création de l'objet est définie comme exception safe ainsi que thread-safe [SWS_CRYPT_19902]. Étant donné que le constructeur est déclaré avec noexcept, aucune erreur ni exception ne survient lors de l'appel ; il n'existe pas de messages d'erreur vers DET ou DEM pour ce constructeur.

Interaction au sein du module

Le domaine créé constitue le contexte pour les descriptions d'erreurs cryptographiques :

• Il encapsule les codes d'erreur de l'énumération CryptoErrc [SWS_CRYPT_10099] via l'alias de type Errc [SWS_CRYPT_19903].
• Des instances de ara::core::ErrorCode référençant de manière fixe ce domaine sont créées via la fonction libre MakeErrorCode() [SWS_CRYPT_19951].
• Les fonctions membres du domaine permettent l'interrogation de l'identifiant via Name() [SWS_CRYPT_19950], la résolution textuelle via Message() [SWS_CRYPT_19953] ainsi que la levée d'erreurs spécifiques au système via ThrowAsException() [SWS_CRYPT_19954] avec le type de base Exception [SWS_CRYPT_19904].

La méthode Message de la classe ara::crypto::CryptoErrorDomain traduit une valeur de code d'erreur en un message d'erreur lisible en texte clair [SWS_CRYPT_19953]. Elle surcharge la méthode de base de résolution de texte d'erreur et est incluse via le fichier d'en-tête ara/crypto/common/crypto_error_domain.h [SWS_CRYPT_19953]. De plus, l'interface est fonctionnellement liée à l'exigence RS_CRYPTO_02310 [SWS_CRYPT_19953].

Utilisation et contexte d'appel

L'appel s'effectue de manière synchrone en tant que fonction membre constante (const), ce qui fait que la méthode fonctionne sans état et que l'objet de domaine d'erreur reste inchangé [SWS_CRYPT_19953]. La fonction attend le paramètre d'entrée suivant [SWS_CRYPT_19953] :

• errorCode : un identificateur numérique de code d'erreur issu de l'énumération CryptoErrc, qui est transmis en tant que type ara::core::ErrorDomain::CodeType [SWS_CRYPT_19953].

Comme valeur de retour, la fonction renvoie un pointeur vers une chaîne de caractères constante (const char *), qui contient le texte descriptif du message associé au code d'erreur respectif [SWS_CRYPT_19953].

Concurrence et sécurité vis-à-vis des exceptions

Concernant la sécurité d'exécution et la concurrence, les conditions aux limites suivantes s'appliquent [SWS_CRYPT_19953] :

• Sécurité des threads : La fonction est explicitement spécifiée comme thread-safe (thread-safe), ce qui autorise les appels concurrents depuis différents threads sans synchronisation externe [SWS_CRYPT_19953].
• Sécurité vis-à-vis des exceptions : La méthode est classée comme sûre vis-à-vis des exceptions (exception safe) et dotée du spécificateur noexcept, raison pour laquelle il est garanti qu'aucune exception C++ n'est levée [SWS_CRYPT_19953].

La fonction membre Name de la classe ara::crypto::CryptoErrorDomain fournit l'identifiant unique du domaine d'erreur pour les opérations cryptographiques [SWS_CRYPT_19950]. La fonction est mise à disposition via le fichier d'en-tête ara/crypto/common/crypto_error_domain.h et surcharge l'interface de base correspondante pour les domaines d'erreur [SWS_CRYPT_19950].

Utilisation et sémantique

L'appel s'effectue de manière synchrone, sans paramètres et sans effets secondaires modifiant l'instance. La valeur de retour est un const char *, qui représente le nom unique du domaine [SWS_CRYPT_19950]. Interprétation : le pointeur renvoyé devrait pointer vers une chaîne de caractères persistée statiquement, car l'interface ne prévoit aucun cycle de vie dynamique ni transfert de propriété de la mémoire. Question Q-b7f2dab65f25b7e6 (ouverte)

Gestion des erreurs et concurrence

• Sécurité vis-à-vis des exceptions : La méthode est déclarée avec noexcept et définie comme sûre vis-à-vis des exceptions (exception safe), de sorte que les appelants n'ont pas à intercepter d'exceptions C++ [SWS_CRYPT_19950].
• Signalement des erreurs : Aucun code d'erreur spécifique n'est spécifié pour la fonction ; la récupération du nom n'échoue pas en fonctionnement normal [SWS_CRYPT_19950].
• Sécurité des threads : L'opération est spécifiée comme thread-safe et peut être exécutée de manière concurrente depuis plusieurs threads sans mécanismes de verrouillage externes [SWS_CRYPT_19950].

Interaction

Au sein du modèle de traitement des erreurs d'AUTOSAR Adaptive, la fonction sert à identifier le domaine d'erreur lors de l'évaluation et de la journalisation des causes d'erreurs cryptographiques [SWS_CRYPT_19950].

La méthode ThrowAsException de la classe ara::crypto::CryptoErrorDomain sert à déclencher une exception C++ sur la base d'un code d'erreur transmis [SWS_CRYPT_19954]. Elle surcharge la méthode de base correspondante et est déclarée avec l'attribut [[noreturn]], c'est pourquoi les appels ne possèdent pas de valeur de retour et ne retournent pas normalement en cas d'exécution réussie [SWS_CRYPT_19954].

Concernant l'utilisation et le paramétrage, les détails de spécification suivants s'appliquent :

• Paramètre : errorCode de type const ara::core::ErrorCode& est transmis comme paramètre d'entrée, encapsulant un identifiant d'erreur issu de l'énumération CryptoErrc [SWS_CRYPT_19954].
• Inclusion de l'en-tête : La fonction est mise à disposition via le fichier d'en-tête #include "ara/crypto/common/crypto_error_domain.h" [SWS_CRYPT_19954].
• Concurrence : L'exécution est spécifiée comme thread-safe et peut ainsi être appelée en toute sécurité depuis des contextes concurrents [SWS_CRYPT_19954].

En ce qui concerne le traitement des erreurs et la sécurité vis-à-vis des exceptions, la méthode est classée comme not exception safe [SWS_CRYPT_19954]. Une restriction importante liée au compilateur et à la chaîne d'outils découle de [SWS_CORE_10304] : si les exceptions C++ sont désactivées dans la chaîne d'outils du compilateur, ThrowAsException ne participe pas à la résolution de surcharge et n'est donc pas disponible pour l'appelant [SWS_CRYPT_19954].