네임스페이스 ara::nm

Diese Seite wurde vollständig KI-generiert auf Basis von SWS NetworkManagement (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.

사용자 가이드AI 생성

요청된 네트워크 상태 및 유효 네트워크 상태의 제어와 표준화된 오류 처리를 가능하게 합니다.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 602561c10e10 출처 열린 질문 (2)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

요청된 네트워크 상태 및 유효 네트워크 상태의 제어와 표준화된 오류 처리를 가능하게 합니다.

네임스페이스 ara::nm은 NetworkHandle을 통해 AUTOSAR Adaptive Platform의 요청된 네트워크 상태 및 유효 네트워크 상태에 대한 제어된 접근 인터페이스를 제공합니다. 동작 중 발생할 수 있는 오류 상황은 kServiceNotAvailable 또는 kInvalidHandler와 같은 열거형 NmErrc의 표준화된 오류 코드를 통해 매핑됩니다 [SWS_ANM_01111]. 구조화된 오류 처리를 위해 MakeErrorCode은 GetNmDomain을 통해 참조되는 오류 도메인 NmErrorDomain에 대한 오류 코드를 스레드 안전하게 생성합니다 [SWS_ANM_01109]. 애플리케이션은 상태 조회 시 실패를 방지하기 위해 호출 전에 Network Management 서비스의 접근 가능성을 고려해야 합니다.

컨텍스트

네임스페이스 ara::nm은 AUTOSAR Adaptive Platform에서 기능적 Network Management를 위한 핵심 인터페이스를 제공합니다. 기본 기능 인터페이스는 요청된 네트워크 상태뿐만 아니라 유효 네트워크 상태에 대한 제어된 접근을 캡슐화하는 클래스 NetworkHandle로 구성됩니다. 이 추상화 메커니즘을 통해 기능 애플리케이션 및 플랫폼 서비스는 기반 통신 네트워크의 현재 운영 상태를 모니터링하고 상태 변경을 시작할 수 있습니다.

일관되고 견고한 오류 처리를 위해 ara::nm은 AUTOSAR Adaptive의 오류 아키텍처에 통합된 표준화된 타입 및 헬퍼 함수를 제공합니다. 여기에는 오류 도메인 NmErrorDomain, 예외 클래스 NmException 및 도메인 특정 열거형 NmErrc [SWS_ANM_01111]이 포함됩니다. 또한 오류 상태의 인스턴스화 및 타입 준수 처리를 보장하는 스레드 안전한 함수 GetNmDomain [SWS_ANM_01109] 및 MakeErrorCode [SWS_ANM_01110]을 사용할 수 있습니다.

컨텍스트 다이어그램: ara::nm에서의 애플리케이션, NetworkHandle 및 오류 아키텍처의 상호작용. 출처: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

사용 경로

전형적인 배포 시나리오에서 Adaptive Application은 네임스페이스 ara::nm과 상호작용하여 네트워크 상태를 제어하고 런타임 이벤트에 반응합니다. 상호작용 시퀀스는 다음 단계로 나뉩니다:

상태 접근 시작: 애플리케이션은 NetworkHandle을 사용하여 요청된 네트워크 상태 또는 현재 유효 네트워크 상태를 쿼리합니다.
오류 감지: 네트워크 요청을 올바르게 처리할 수 없는 경우, 인터페이스는 해당 오류 이벤트를 신호합니다. 해석: 기반 네트워크 서비스에 장애가 발생할 경우, NetworkHandle은 내부적으로 NmErrc을 기반으로 오류 코드를 생성할 것으로 추정됩니다. 질문 Q-97b1567be5e28121 (열림)
오류 코드 생성: 헬퍼 함수 MakeErrorCode [SWS_ANM_01110]은 NmErrc [SWS_ANM_01111]의 값 및 애플리케이션별 추가 데이터(ara::core::ErrorDomain::SupportDataType)를 전달받아 완전한 ara::core::ErrorCode를 생성합니다. 이 함수는 constexpr 및 noexcept로 명세되어 있으며 완전한 스레드 안전성을 보장합니다 [SWS_ANM_01110].
오류 도메인 검증: 호출 컴포넌트는 GetNmDomain [SWS_ANM_01109]을 통해 전역 NmErrorDomain에 대한 스레드 안전한 참조를 검색하여 반환된 코드의 오류 도메인을 확인하고 도메인 특정 오류 설명을 확인할 수 있습니다.

시퀀스 다이어그램: ara::nm을 통한 네트워크 상태 쿼리 및 오류 해결 흐름. 출처: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

오류 시나리오

모듈의 표준화된 오류 코드는 ara::core::ErrorDomain::CodeType을 기반으로 하는 열거형 NmErrc에 묶여 있습니다 [SWS_ANM_01111]. 모듈은 다음과 같은 오류 사례를 구분합니다:

NmErrc::kServiceNotAvailable(코드 1): 이 오류는 네트워크 관리에 필요한 서비스가 런타임에 도달할 수 없거나 작동 준비가 되지 않았음을 나타냅니다 [SWS_ANM_01111]. 이 경우 호출자는 재시도 또는 대체 전략으로 대응해야 합니다.
NmErrc::kInvalidHandler(코드 2): 작업 시 유효하지 않거나 등록되지 않은 핸들러가 전달되었거나 참조되었을 때 발생합니다 [SWS_ANM_01111]. 이는 일반적으로 호출자의 구성 또는 초기화 오류를 나타냅니다.

견고한 호출을 위한 사전 조건은 NmErrc::kServiceNotAvailable 또는 NmErrc::kInvalidHandler를 방지하기 위해 초기화된 서비스 인프라 및 NetworkHandle에 접근할 때의 유효한 매개변수입니다 [SWS_ANM_01111]. MakeErrorCode [SWS_ANM_01110] 및 GetNmDomain [SWS_ANM_01109]과 같은 오류 처리의 모든 핵심 함수는 자체적으로 예외를 발생시키지 않습니다(noexcept). 해석: 예외 기반 제어 구조를 선호하는 애플리케이션의 경우 예외 클래스 NmException가 호출 스택을 통해 오류 상태를 구조화된 방식으로 전파하는 매개체 역할을 할 것으로 추정됩니다. 질문 Q-67a17c37021e8beb (열림)

이 가이드는 AUTOSAR Adaptive(릴리스 R25-11) 명세를 기반으로 AI에 의해 작성되었습니다.

주제 맵

상세 보기

개요에서 항목을 선택하세요.

이 릴리스에 대한 요소 데이터가 없습니다

클래스

NetworkHandle 클래스

Zugang zu angefordertem und effektivem Netzstatus.

NmErrorDomain 클래스

Fehlerdomäne für ara::nm.

NmException 클래스

Exception-Typ für ara::nm.

함수

GetNmDomain 함수

constexpr const ara::core::ErrorDomain& GetNmDomain() noexcept;

MakeErrorCode 함수

constexpr ara::core::ErrorCode MakeErrorCode(NmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

타입 및 상수

NmErrc 열거형

enum class NmErrc : ara::core::ErrorDomain::CodeType { kServiceNotAvailable = 1, kInvalidHandler = 2 };

항목을 클릭하면 관계가 표시됩니다.

열거형

열거형 NmErrc [SWS_ANM_01111]

enum class NmErrc : ara::core::ErrorDomain::CodeType { kServiceNotAvailable = 1, kInvalidHandler = 2 };

Header	`ara/nm/nm_error_domain.h`
Upstream-Anforderung	RS_AP_00122, RS_AP_00125, RS_AP_00127, RS_AP_00149

Standardisierte Network-Management-Fehlercodes.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: ca4d8d10606f 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

열거형 [SWS_ANM_01111]은(는) 헤더 ara/nm/nm_error_domain.h에서 Network Management(NM)의 표준화된 오류 코드를 정의합니다. 또한 타입 별칭 Errc [SWS_ANM_01103]을(를) 통해 제공되며 스레드 안전 팩토리 함수 MakeErrorCode [SWS_ANM_01110]와(과) 함께 ara::core::Result 반환값 내의 오류 상태를 캡슐화하는 데 사용됩니다.

정의된 오류 값은 NM 인터페이스의 특정 오류 사례를 처리합니다:

kServiceNotAvailable(값 1): 기본 NM 서비스를 사용할 수 없을 때 네트워크 상태의 동기식 쿼리 및 요청 중에 발생합니다. 이는 GetNetworkState [SWS_ANM_01007]을(를) 통한 유효 네트워크 상태 읽기, GetNetworkRequestedState [SWS_ANM_01008]을(를) 통한 요청된 상태 쿼리, SetNetworkRequestedState [SWS_ANM_01009]을(를) 통한 네트워크 요청 또는 해제에 영향을 미칩니다.
kInvalidHandler(값 2): 알림 핸들러 등록 함수, 즉 RegisterNetworkStateChangeNotifier [SWS_ANM_01010], [SWS_ANM_01015] 및 RegisterNetworkRequestedStateChangeNotifier [SWS_ANM_01012], [SWS_ANM_01014]에 의해 보고됩니다. 인터페이스당 최대 하나의 알림자만 등록할 수 있으므로 빈 콜백이 전달되거나 이미 등록이 존재하는 경우 이 오류가 발생할 것으로 추정됩니다(해석). 질문 Q-59365b2b5b2e664c (열림)

동시성과 관련하여 네트워크 상태에 대한 순수 읽기 작업은 thread-safe인 반면, SetNetworkRequestedState 및 모든 알림자 등록은 명시적으로 non-thread-safe로 지정되어 있다는 점에 유의해야 합니다. 따라서 호출자는 잘못된 호출 상태를 방지하기 위해 등록 및 요청 변경에 대한 경쟁적 액세스를 외부에서 동기화해야 합니다.

이 텍스트는 AI에 의해 작성되고 큐레이션되었습니다.

구현자 가이드 준비 중 (복잡도 I1)

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_ANM_01111
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_ANM_01111@rel:R25-11#c9a1e4e8
Content hash: c9a1e4e8
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01111

Status: valid/unmigrated Version: rel:R25-11#31e88722 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_ANM_01111@rel:R25-11#31e88722

Recorded Revisions (4):

R25-11rel:R25-11#3bd1d10b2026-09-30
R23-11rel:R23-11#b1db0f132026-10-14
R24-11rel:R24-11#74d33b0b2026-10-14
R25-11rel:R25-11#31e887222026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

자유 함수 문서

함수 GetNmDomain [SWS_ANM_01109]

constexpr const ara::core::ErrorDomain& GetNmDomain() noexcept;

Header	`ara/nm/nm_error_domain.h`
Upstream-Anforderung	RS_AP_00119, RS_AP_00120, RS_AP_00159
Thread Safety	thread-safe
Rückgabe	const ara::core::ErrorDomain&

Gibt eine Referenz auf NmErrorDomain zurück.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_ANM_01109
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_ANM_01109@rel:R25-11#91601dba
Content hash: 91601dba
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01109

Status: valid/unmigrated Version: rel:R25-11#f3783a2f Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_ANM_01109@rel:R25-11#f3783a2f

Recorded Revisions (4):

R25-11rel:R25-11#43e9e8262026-09-30
R23-11rel:R23-11#0c322a072026-10-14
R24-11rel:R24-11#f3783a2f2026-10-14
R25-11rel:R25-11#f3783a2f2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 MakeErrorCode [SWS_ANM_01110]

constexpr ara::core::ErrorCode MakeErrorCode(NmErrc code, ara::core::ErrorDomain::SupportDataType data) noexcept;

Header	`ara/nm/nm_error_domain.h`
Upstream-Anforderung	RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00159, RS_AP_00135
Thread Safety	thread-safe
Rückgabe	ara::core::ErrorCode

Erzeugt einen ara::core::ErrorCode für NmErrc.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 9124227d46ba 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

사용

함수 MakeErrorCode은 모듈 anm에서 Network Management의 오류를 위한 표준화된 ara::core::ErrorCode 생성을 담당합니다 [SWS_ANM_01110]. 이 함수는 헤더 ara/nm/nm_error_domain.h에 정의되어 있으며 열거형 NmErrc의 특정 오류 코드 code를 유형 ara::core::ErrorDomain::SupportDataType의 제조업체별 추가 데이터 data과 함께 동기적으로 해당 오류 객체 [SWS_ANM_01110]로 캡슐화합니다. 호출자는 추가적인 오류 처리를 위한 일관된 오류 객체를 얻기 위해 각 오류 상태 및 컨텍스트 데이터를 전달합니다 [SWS_ANM_01110].

오류 처리 및 동시성

MakeErrorCode은 지정자 noexcept로 선언되어 있으므로, 실행 시 함수가 예외를 발생시키지 않음이 보장됩니다 [SWS_ANM_01110]. 동시성 동작과 관련하여 이 함수는 thread-safe으로 분류되어 있습니다. 따라서 추가적인 외부 동기화 조치 없이도 병렬 스레드에서 안전하게 호출될 수 있습니다 [SWS_ANM_01110]. constexpr로 한정되어 있으므로, 상수 인수가 전달될 때 컴파일러에 의해 컴파일 타임에 오류 객체 생성이 이미 완전히 수행될 수 있을 것으로 보입니다 [SWS_ANM_01110]. 질문 Q-a04f5f6a2218370e (열림)

상호 작용

Network Management 오류 코드를 위한 중앙 생성 함수로서 MakeErrorCode은 모듈을 AUTOSAR 어댑티브 플랫폼의 일반적인 오류 처리 개념에 연결합니다 [SWS_ANM_01110]. 이때 상위 업스트림 요구사항인 RS_AP_00119, RS_AP_00120, RS_AP_00121, RS_AP_00159 및 RS_AP_00135를 직접 다룹니다 [SWS_ANM_01110].

이 사용 지침은 AUTOSAR R25-11 사양을 바탕으로 자동 생성되었습니다.

Request a governed re-review of this record. The record is not changed immediately.

Record: AUTOSAR/AP/record/SWS_ANM_01110
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_ANM_01110@rel:R25-11#705d8823
Content hash: 705d8823
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_NetworkManagement.pdf#nameddest=SWS_ANM_01110

Status: valid/unmigrated Version: rel:R25-11#2b6b1c06 Versionshistorie & Revisions (1 transition, 4 revision)

Current State: valid/unmigrated
Reason: mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign: 2026-08-13-status-backfill
Active Version: AUTOSAR/AP/record/SWS_ANM_01110@rel:R25-11#2b6b1c06

Recorded Revisions (4):

R25-11rel:R25-11#428b741c2026-09-30
R23-11rel:R23-11#1edc012e2026-10-14
R24-11rel:R24-11#2b6b1c062026-10-14
R25-11rel:R25-11#2b6b1c062026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

네임스페이스 ara::nm

사용자 가이드AI 생성

컨텍스트

사용 경로

오류 시나리오

주제 맵

클래스

함수

타입 및 상수

상세 보기

클래스

함수

타입 및 상수

열거형

열거형 NmErrc [SWS_ANM_01111]

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

자유 함수 문서

함수 GetNmDomain [SWS_ANM_01109]

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 MakeErrorCode [SWS_ANM_01110]

사용

오류 처리 및 동시성

상호 작용

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: