class ara::fw::FwErrorDomain

The type alias Errc is defined according to [AP_SWS_Fw_83007] as an alias for the error code enumeration FwErrc (using Errc = FwErrc;). The element is declared in the scope of class ara::fw::FwErrorDomain and is to be included via header file ara/fw/fw_error_domain.h [AP_SWS_Fw_83007].

Regarding usage, Errc represents no executable function call and therefore has neither parameters, return values, nor synchronous or asynchronous semantics [AP_SWS_Fw_83007]. Rather, it provides a uniform identifier for enumerating domain-specific error causes. Interpretation: The alias is likely intended to offer developers simplified and consistent access to the enumeration values of FwErrc within ara::fw::FwErrorDomain to type and query error states [AP_SWS_Fw_83007]. Question Q-bd8949830961e459 (open)

Since it is a purely compile-time construct, no runtime constraints regarding reentrancy, thread safety, or call sequences exist [AP_SWS_Fw_83007]. Specific error values or associations with DET or DEM reports are not prescribed in the specification element and are governed by the values of the underlying enumeration [AP_SWS_Fw_83007].

The default constructor FwErrorDomain() is declared as deleted ([AP_SWS_Fw_83009]). Direct instantiation of objects of class ara::fw::FwErrorDomain via this constructor is thus excluded in application code. Interpretation: The deletion is presumably intended to ensure that the error domain is managed exclusively as a singleton. Question Q-54f7bc341f074e2c (open)

For using the error domain, the free function GetFwErrorDomain() is available ([AP_SWS_Fw_83002]). This returns a thread-safe reference to the existing domain object of type ara::core::ErrorDomain. Via this reference, the interfaces of the domain can be used:

• Querying the name of the error domain via Name() ([AP_SWS_Fw_83010]).
• Determining descriptive texts for error codes using Message() ([AP_SWS_Fw_83011]).
• Throwing exceptions via ThrowAsException() ([AP_SWS_Fw_83012]), where the alias Exception refers to FwException ([AP_SWS_Fw_83008]).

The associated error codes are defined by the enumeration FwErrc ([AP_SWS_Fw_83001]), which is also available within the class via the alias Errc ([AP_SWS_Fw_83007]). Valid values are kServiceNotAvailable and kInvalidStateDependentFirewall. Developers should therefore not create their own instances, but always use the global reference.

Usage and Semantics

The member function Name of class ara::fw::FwErrorDomain serves to retrieve the identifier of the error domain [AP_SWS_Fw_83010]. The call is synchronous and requires including header file ara/fw/fw_error_domain.h [AP_SWS_Fw_83010]. The function takes no arguments and returns a pointer of type const char * representing the name of the domain [AP_SWS_Fw_83010]. The return value is likely to be a null-terminated string whose validity is bound to the lifetime of the error domain. Question Q-6bd465d82e79a682 (open)

Error handling

The method is declared with the specifier noexcept [AP_SWS_Fw_83010]. Consequently, it throws no exceptions and does not define any specific error codes or error returns [AP_SWS_Fw_83010].

Concurrency and Limitations

According to the specification, the function is classified as thread-safe (thread-safe) [AP_SWS_Fw_83010]. Since it is a const member function (const), access does not modify the state of the instance and can be called safely concurrently from different execution contexts [AP_SWS_Fw_83010]. According to the specification, no special preconditions or ordering requirements exist [AP_SWS_Fw_83010].

use

The member function Message of class ara::fw::FwErrorDomain is declared via header file ara/fw/fw_error_domain.h and serves to synchronously retrieve an error message [AP_SWS_Fw_83011]. Upon invocation, the caller passes an error code errorCode of type CodeType. As a return value, the function returns a pointer of type const char * to the string assigned to the error code [AP_SWS_Fw_83011]. As override, the function overrides the corresponding interface of the base class [AP_SWS_Fw_83011].

Concurrency and Thread Safety

The specification explicitly defines Message as thread-safe [AP_SWS_Fw_83011]. Callers can therefore call the method in parallel from different threads for the same instance without additional synchronization measures. Due to qualification as a const method, the state of the error domain is not modified upon invocation [AP_SWS_Fw_83011].

Error Handling and Boundary Conditions

Due to declaration as noexcept, the method guarantees that no C++ exceptions are thrown [AP_SWS_Fw_83011]. Specific error codes or error values for unresolvable codes are not defined in the element [AP_SWS_Fw_83011]. The returned pointer presumably refers to an immutable, statically allocated string, meaning there is no memory management obligation for the caller. Question Q-2e98884ffd517367 (open)

The member function ThrowAsException of class ara::fw::FwErrorDomain serves to instantiate and throw a FwException from a passed error code errorCode [AP_SWS_Fw_83012]. The function is included via header file ara/fw/fw_error_domain.h and takes a const reference to ara::core::ErrorCode as its sole parameter [AP_SWS_Fw_83012]. It has no return value (void) and is declared with const as well as override [AP_SWS_Fw_83012].

Through the specification clause noexcept(false), it is explicitly defined that exceptions may be thrown upon method invocation; the function deterministically creates and throws a FwException for the corresponding error case [AP_SWS_Fw_83012]. Regarding exception safety, the method is classified as not exception safe [AP_SWS_Fw_83012]. Calling code must therefore be prepared for the resulting exception interrupting regular control flow, requiring appropriate exception handling provisions.

Regarding concurrency, the method is specified as thread-safe, permitting concurrent invocation from multiple threads [AP_SWS_Fw_83012]. By virtue of keyword override, the method presumably overrides the interface function of the same name in a higher-level error domain [AP_SWS_Fw_83012]. Question Q-aae02c046243335c (open)