클래스 ara::diag::FileTransferService

[SWS_DM_01320] Upstream: RS_Diag_04135

class FileTransferService {...};

File Transfer service interface.

Header-Datei	#include "ara/diag/file_transfer.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	namespace ara::diag

사용자 가이드AI 생성

어댑티브 애플리케이션이 UDS 진단 서비스를 위한 파일 및 디렉터리 작업을 제공할 수 있도록 합니다.

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

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

어댑티브 애플리케이션이 UDS 진단 서비스를 위한 파일 및 디렉터리 작업을 제공할 수 있도록 합니다.

이 서비스 인터페이스는 UDS 서비스 RequestFileTransfer([SWS_DM_01320], SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”)을 위해 애플리케이션별 파일 전송을 Diagnostic Management에 연결하는 역할을 합니다. 인스턴스화 후 애플리케이션은 Offer()을 사용하여 들어오는 파일 요청의 전달을 활성화하고, 특수 핸들러 메서드([SWS_DM_01336])를 통해 읽기, 쓰기 또는 삭제와 같은 파일 작업을 비동기식으로 처리합니다. 읽기 및 쓰기 작업의 경우 서비스는 실제 데이터 전송이 처리되는 세션 객체를 제공합니다. 이 클래스의 인스턴스는 복사할 수 없으며 인스턴스 지정자를 통한 고정 바인딩이 필요합니다.

컨텍스트

클래스 ara::diag::FileTransferService은 AUTOSAR Adaptive Platform([SWS_DM_01320], SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”)에서 UDS 서비스 RequestFileTransfer(0x38)을 구현하기 위한 진단 인터페이스를 정의합니다. 이 클래스는 프로세스 경계를 넘어 파일 또는 디렉터리의 읽기, 쓰기, 이어받기 및 삭제를 유연하게 처리하기 위해 Diagnostic Management(DM 또는 Diagnostic Server)와 구체적인 진단 애플리케이션 사이의 ServiceInterface 역할을 합니다(SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”).

파일 전송 시나리오에는 일반적으로 세 당사자가 관여합니다. 외부 UDS 클라이언트(진단 테스터), 중개자로서의 Diagnostic Server, FileTransferService을 상속받는 어댑티브 애플리케이션입니다. 진단 요청이 수신되면 Diagnostic Server는 서비스의 구현된 가상 메서드로 요청을 위임합니다([SWS_DM_01313], [SWS_DM_01314]). 후속 데이터 전송(UDS 0x36 TransferData) 및 완료(UDS 0x37 RequestTransferExit)를 위해 Diagnostic Management는 세션 객체(DataTransferReadSession 또는 DataTransferWriteSession)를 통해 제공되는 핸들러 클래스에 직접 액세스합니다([SWS_DM_01317], [SWS_DM_01318]).

컨텍스트 다이어그램: UDS 클라이언트, Diagnostic Management, 서비스 구현 및 전송 세션 간의 상호 작용. 출처: [SWS_DM_01317], [SWS_DM_01318], SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”.

수명 주기

FileTransferService의 인스턴스는 모델링된 ara::core::InstanceSpecifier 및 동시성 모델 ConcurrencyType를 지정하여 생성됩니다([SWS_DM_01325]). ConcurrencyType를 통해 클래스의 콜백 메서드가 스레드 안전(kConcurrent)하게 구현되어야 하는지 아니면 스레드 안전하지 않게(kNotConcurrent) 구현되어야 하는지가 결정됩니다([SWS_DM_01325], [SWS_DM_01331]). 이 클래스는 보호된 단일 기능으로서 복사할 수 없으나([SWS_DM_01327], [SWS_DM_01329]), 이동 시맨틱을 지원합니다([SWS_DM_01328], [SWS_DM_01330]).

인스턴스화 후, Diagnostic Management가 들어오는 요청을 전달하도록 하려면 메서드 Offer()을 통해 서비스를 명시적으로 활성화해야 합니다([SWS_DM_01336]). StopOffer()를 사용하면 전달을 언제든지 다시 비활성화할 수 있습니다([SWS_DM_01337]). 해석: Diagnostic Management의 고아 콜백 액세스를 방지하기 위해 가상 소멸자 ~FileTransferService()에 의해 객체가 파괴되기 전에 StopOffer()를 호출해야 할 것으로 보입니다([SWS_DM_01326]). 질문 Q-3c5c406a144ced0c (열림) Offer(), StopOffer() 및 소멸자 모두 스레드 안전하지 않습니다([SWS_DM_01326], [SWS_DM_01336], [SWS_DM_01337]).

상태 다이어그램: 인스턴스화, 제공 및 종료 사이의 FileTransferService 인스턴스 상태 전이. 출처: [SWS_DM_01325], [SWS_DM_01336], [SWS_DM_01337], [SWS_DM_01326].

사용 경로

파일 작업의 일반적인 흐름은 구성, 작업 트리거 및 후속 블록 전송으로 나뉩니다. 먼저 모드 ReadFile(0x04)을 갖는 UDS 요청 0x38이 발생하면 Diagnostic Management는 RequestReadFile로 호출을 전달합니다([SWS_DM_01314], [SWS_DM_01331]). 애플리케이션은 파일 이름과 형식 및 메타 정보를 처리하고, ara::core::Future를 통해 DataTransferReadSession와 파일 크기(FileSizes)로 구성된 튜플을 비동기식으로 반환합니다([SWS_DM_01331]). 해석: 어떠한 전송 전략(예: 복사, 제로 카피 또는 파일 시스템 핸들)을 사용할지는 애플리케이션이 각 세션 클래스를 인스턴스화할 때 결정하는 것으로 추정됩니다(SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”, [SWS_DM_01317]). 질문 Q-80b541ae6dd7cc34 (열림)

긍정 응답 후 클라이언트는 TransferData(0x36)을 통해 데이터 블록을 요청합니다. 그러면 Diagnostic Server는 DataTransferReadSession의 등록된 핸들러의 Read 메서드를 직접 호출합니다([SWS_DM_01317]). 모든 블록이 전송되면 클라이언트는 RequestTransferExit(0x37)로 트랜잭션을 완료하며, 그 후 Diagnostic Server는 핸들러의 Exit 메서드를 호출합니다([SWS_DM_01318]). 모드 WriteFileMode([SWS_DM_01324])을 사용하는 RequestWriteFile([SWS_DM_01313], [SWS_DM_01333])을 통한 쓰기, RequestResumeWriteFile([SWS_DM_01316], [SWS_DM_01334])를 통한 이어받기, RequestReadDirectory([SWS_DM_01315], [SWS_DM_01332])를 통한 디렉터리 읽기 또는 DeleteFile([SWS_DM_01335])을 통한 직접 삭제에도 유사한 패턴이 적용됩니다.

시퀀스 다이어그램: UDS 0x38, 0x36 및 0x37을 통한 읽기 작업 흐름. 출처: [SWS_DM_01314], [SWS_DM_01317], [SWS_DM_01318], [SWS_DM_01331].

오류 시나리오

오류는 여러 단계에서 발생할 수 있습니다:

생성 위반: InstanceSpecifier의 확인 또는 매핑에 실패하면 InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation, ProcessMappingViolation 또는 InstanceSpecifierAlreadyInUseViolation와 같은 모델링 오류가 발생합니다([SWS_DM_01325]).
활성화 오류: 서비스가 이미 활성화된 상태에서 Offer()을 반복 호출하면 오류 DiagOfferErrc::kAlreadyOffered이 반환됩니다([SWS_DM_01336]).
진단 오류 코드(NRC): 작업을 성공적으로 실행할 수 없는 경우, 콜백 메서드는 ara::core::Future에서 DiagUdsNrcErrc을 통해 적절한 부정 UDS 응답 코드(ISO 14229-1에 따른 NRC)를 반환합니다([SWS_DM_01331], [SWS_DM_01333], [SWS_DM_01335]).
중단 처리: 전달된 CancellationHandler 객체를 통해 애플리케이션은 대화가 중단되었는지 IsCanceled로 확인하거나, SetNotifier를 통해 비동기 중단에 대한 알림 함수를 등록할 수 있습니다([SWS_DM_01331], [SWS_DM_01335]).

이 가이드는 전적으로 AUTOSAR 사양 R25-11을 기반으로 하며 자동으로 작성되었습니다.

멤버 맵

클래스 다이어그램

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

상세 보기

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

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

생성자 및 소멸자

FileTransferService 함수 3

Constructor for FileTransferService (inherited)

오버로드 FileTransferService 3

FileTransferService (ara::core::InstanceSpecifier const &instance Specifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_01325

FileTransferService (FileTransferService const &)=delete; SWS_DM_01327

FileTransferService (FileTransferService &&other) noexcept; SWS_DM_01328

~FileTransferService 함수

Destructor of class FileTransferService.

virtual ~FileTransferService () noexcept;

메서드

DeleteFile 함수

Called for RequestFileTransfer with ModeOfOperation DeleteFile. This method is the complete operation of deleting a file

virtual auto DeleteFile (ara::core::String fileName, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< void >=0;

Offer 함수

This Offer will enable the DM to forward request messages to this handler.

auto Offer () noexcept -> ara::core::Result< void >;

RequestReadDirectory 함수

Called for RequestFileTransfer with ModeOfOperation ReadDir. .

virtual auto RequestReadDirectory (ara::core::String directoryName, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< std::tuple< DataTransferReadSession, std::uint64_t > >=0;

RequestReadFile 함수

Called for RequestFileTransfer with ModeOfOperation ReadFile. • uncompressed_size: If set to 0, the parameter will not be reported to the diagnostic client. • compressed_size: If set to 0, the parameter will not be reported to the diagnostic client. If no compression is used, the value shall be zero.

virtual auto RequestReadFile (ara::core::String fileName, ara::core::Byte dataFormatIdentifier, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< std::tuple< DataTransferReadSession, FileSizes > >=0;

RequestResumeWriteFile 함수

Called for RequestFileTransfer with ModeOfOperation ResumeFile.

virtual auto RequestResumeWriteFile (ara::core::String fileName, ara::core::Byte dataFormatIdentifier, FileSizes fileSizes, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< std::tuple< DataTransferWriteSession, std::uint64_t > >=0;

RequestWriteFile 함수

Called for RequestFileTransfer with ModeOfOperation WriteFile.

virtual auto RequestWriteFile (ara::core::String fileName, ara::core::Byte dataFormatIdentifier, FileSizes fileSizes, WriteFile Mode mode, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept -> ara::core::Future< DataTransferWriteSession >=0;

StopOffer 함수

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () const noexcept;

연산자

operator= 함수 2

FileTransferService shall be a single not assignable instance.

오버로드 = 2

auto operator= (FileTransferService const &) -> FileTransferService &=delete; SWS_DM_01329

auto operator= (FileTransferService &&other) & noexcept -> File TransferService &; SWS_DM_01330

열거형

WriteFileMode 열거형

Determines the write file operation mode.

enum class WriteFileMode : ara::core::Byte {...};

중첩 타입

FileSizes 클래스

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

메서드 문서

함수 DeleteFile [SWS_DM_01335] Upstream: RS_Diag_04135

virtual auto DeleteFile (ara::core::String fileName, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< void >=0;

Called for RequestFileTransfer with ModeOfOperation DeleteFile. This method is the complete operation of deleting a file

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

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

클래스 ara::diag::FileTransferService(SWS Diagnostics §8.18.1.2.3.1 “DeleteFile”, 헤더 #include "ara/diag/file_transfer.h")의 메서드 DeleteFile은(는) 모드 DeleteFile을(를) 갖는 UDS 서비스 RequestFileTransfer(0x38) 프레임워크 내에서 파일의 완전한 삭제 프로세스를 처리합니다 [SWS_DM_01335]. 해당 UDS 서비스는 ISO 14229-1에 따라 서버 측에서 제공됩니다 [SWS_DM_01310] SWS Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”.

호출 시 세 개의 매개변수가 전달됩니다 [SWS_DM_01335]:

fileName (ara::core::String): 대상 파일의 경로 지정 및 이름(해석: 명세 텍스트의 편집상 표기인 “file to read”에도 불구하고 삭제할 파일에 해당함). 질문 Q-cdbe1185bb030e87 (열림)
metaInfo (MetaInfo const &): 현재 진단 요청의 메타 정보.
cancellationHandler (CancellationHandler): cancellationHandler.IsCanceled()을(를) 통한 취소 상태 확인 및 진행 중인 대화가 중단된 경우 cancellationHandler.SetNotifier()을(를) 통한 알림 함수 등록을 가능하게 함.

비동기 결과로서 이 함수는 ara::core::Future<void>을(를) 반환합니다 [SWS_DM_01335]. 성공적인 완료는 진단 클라이언트에 긍정 응답 동작을 시그널링합니다. 오류 발생 시 Future 내에서 DiagUdsNrcErrc을(를) 통해 ISO 14229-1에 따른 적절한 UDS NRC를 제공해야 합니다 [SWS_DM_01335].

이 함수는 noexcept(으)로 명시되어 있으며 예외 안전(“exception safe”)으로 간주됩니다 [SWS_DM_01335]. 스레드 안전성에 대한 요구사항은 조건부이며 생성자에 전달된 ConcurrencyType을(를) 통해 제어됩니다 [SWS_DM_01335].

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

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
fileName	Path including name of the file to read
metaInfo	MetaInfo of the request.
cancellationHandler	This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A Future with either a void data result to be reported to the UDS client (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

Fehlercode	Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

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

Status: valid/unmigrated Version: rel:R25-11#5a76fff5 Versionshistorie & Revisions (1 transition, 5 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_DM_01335@rel:R25-11#5a76fff5

Recorded Revisions (5):

R25-11rel:R25-11#8332cd052026-09-30
R22-11rel:R22-11#36673d0f2026-10-14
R23-11rel:R23-11#73618cf32026-10-14
R24-11rel:R24-11#1c7c75ef2026-10-14
R25-11rel:R25-11#5a76fff52026-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

함수 FileTransferService [SWS_DM_01325] Upstream: RS_Diag_04135, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

FileTransferService (ara::core::InstanceSpecifier const &instance Specifier, ConcurrencyType concurrencyType) noexcept;

Constructor for FileTransferService (inherited)

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Verletzungen (Violations)	InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is typed by a pingViolation DiagnosticRequestFileTransferInterface needs to be referenced by a DiagnosticServiceGenericMapping. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

Parameter	Beschreibung
instanceSpecifier	InstanceSpecifier to a PortPrototype of a DiagnosticRequestFileTransferInterface.
concurrencyType	Specifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).

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

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

Status: valid/unmigrated Version: rel:R25-11#a08ef198 Versionshistorie & Revisions (1 transition, 5 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_DM_01325@rel:R25-11#a08ef198

Recorded Revisions (5):

R25-11rel:R25-11#52de53342026-09-30
R22-11rel:R22-11#8dbc776b2026-10-14
R23-11rel:R23-11#f58df40e2026-10-14
R24-11rel:R24-11#724c28ee2026-10-14
R25-11rel:R25-11#a08ef1982026-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

함수 FileTransferService [SWS_DM_01327] Upstream: RS_Diag_04135

FileTransferService (FileTransferService const &)=delete;

FileTransferService shall be a single not copy-able instance.

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Sichtbarkeit	protected

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

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

Status: valid/unmigrated Version: rel:R25-11#1ed01f5a Versionshistorie & Revisions (1 transition, 5 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_DM_01327@rel:R25-11#1ed01f5a

Recorded Revisions (5):

R25-11rel:R25-11#8b4a360b2026-09-30
R22-11rel:R22-11#685998602026-10-14
R23-11rel:R23-11#bfbeeb2e2026-10-14
R24-11rel:R24-11#d1dbc6e22026-10-14
R25-11rel:R25-11#1ed01f5a2026-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

함수 FileTransferService [SWS_DM_01328] Upstream: RS_Diag_04135

FileTransferService (FileTransferService &&other) noexcept;

Move constructs an instance of FileTransferService.

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

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

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

Status: valid/unmigrated Version: rel:R25-11#1bdc5a9f Versionshistorie & Revisions (1 transition, 5 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_DM_01328@rel:R25-11#1bdc5a9f

Recorded Revisions (5):

R25-11rel:R25-11#a64a8dae2026-09-30
R22-11rel:R22-11#2f0b9de52026-10-14
R23-11rel:R23-11#ebd249b42026-10-14
R24-11rel:R24-11#c90d4b792026-10-14
R25-11rel:R25-11#1bdc5a9f2026-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

함수 Offer [SWS_DM_01336] Upstream: RS_Diag_04135

auto Offer () noexcept -> ara::core::Result< void >;

This Offer will enable the DM to forward request messages to this handler.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: ae7133c89fe4 출처

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

사용

클래스 ara::diag::FileTransferService의 메서드 Offer은(는) Diagnostic Management(DM)가 파일 전송을 위한 수신 진단 요청을 해당 인스턴스로 전달할 수 있도록 핸들러를 등록합니다 [SWS_DM_01336]. 호출은 매개변수 없이 동기식으로 수행됩니다. 반환 유형으로는 ara::core::Result<void>이(가) 사용되어 등록 성공 또는 발생한 오류를 알립니다 [SWS_DM_01336].

오류 처리

제공 중 오류가 발생하면 함수는 오류 상태의 ara::core::Result을(를) 반환합니다. 해당 인스턴스에 대해 서비스가 이미 이전에 성공적으로 제공된 경우, 롤백 시맨틱을 갖는 특정 오류 코드 DiagOfferErrc::kAlreadyOffered이(가) 반환됩니다 [SWS_DM_01336].

동시성 및 제약사항

이 함수는 예외 안전(exception safe) 및 noexcept(으)로 선언되어 있지만, 스레드 안전하지 않은 것(not thread-safe)으로 간주됩니다 [SWS_DM_01336]. 따라서 동일한 서비스 인스턴스에 대한 호출은 여러 스레드에서 보호되지 않은 채 병렬로 실행되어서는 안 됩니다.

상호 작용

Offer을(를) 통한 서비스 제공은 Adaptive AUTOSAR의 진단 핸들러에 대한 표준화된 제공 패턴에 해당합니다. DM에 의한 요청 전달을 위한 유사한 메커니즘은 예를 들어 파일 다운로드 [SWS_DM_00792], 업로드 [SWS_DM_00802] 및 일반 UDS 서비스 [SWS_DM_00619]에 대해 존재합니다.

이 사용 참고사항은 AUTOSAR AP R25-11 명세를 기반으로 자동 생성되었습니다.

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	Returns nothing or an error.

Fehler

Fehlercode	Beschreibung
DiagOfferErrc::kAlreadyOffered	rollback_semantics The service is already offered.

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

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

Status: valid/unmigrated Version: rel:R25-11#780b487b Versionshistorie & Revisions (1 transition, 5 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_DM_01336@rel:R25-11#780b487b

Recorded Revisions (5):

R25-11rel:R25-11#f8bdc8172026-09-30
R22-11rel:R22-11#980deda22026-10-14
R23-11rel:R23-11#429134002026-10-14
R24-11rel:R24-11#2a2a4d772026-10-14
R25-11rel:R25-11#780b487b2026-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

함수 RequestReadDirectory [SWS_DM_01332] Upstream: RS_Diag_04135

virtual auto RequestReadDirectory (ara::core::String directoryName, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< std::tuple< DataTransferReadSession, std::uint64_t > >=0;

Called for RequestFileTransfer with ModeOfOperation ReadDir. .

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: a6ee000cae47 출처

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

메서드 ara::diag::FileTransferService::RequestReadDirectory은(는) modeOfOperation ReadDir(0x05)을(를) 갖는 RequestFileTransfer(0x38)에 대한 진단 요청이 수신될 때 Diagnostic Server 인스턴스에 의해 호출됩니다 [SWS_DM_01315]. 이 함수는 다음 매개변수를 받습니다 [SWS_DM_01332]:

directoryName: 읽을 디렉터리의 디렉터리 이름을 포함한 경로.
metaInfo: 수신 진단 요청의 메타 정보.
cancellationHandler: cancellationHandler.IsCanceled()을(를) 통해 대화 취소를 조회하거나 취소 이벤트에 대해 cancellationHandler.SetNotifier()을(를) 통해 콜백 함수를 등록하기 위한 객체.

반환은 ara::core::Future<std::tuple<DataTransferReadSession, std::uint64_t>>을(를) 통해 비동기적으로 수행됩니다 [SWS_DM_01332]. 성공 시 튜플에는 접근 전략 DataTransferReadSession 및 UDS 클라이언트로 전송될 디렉터리 크기가 포함됩니다 [SWS_DM_01332]. 이때 DataTransferReadSession 객체는 RequestFileTransfer(0x38)을 통한 초기화와 TransferData(0x36)을 통한 후속 파일 전송 간의 연결을 설정합니다 SWS Diagnostics 184쪽 “Realization of modeOfOperation ReadDir (0x05)”.

처리에 실패하면 Future은(는) DiagUdsNrcErrc을(를) 통해 ISO 14229-1에 따른 부정 응답 코드(NRC)를 제공합니다 [SWS_DM_01332]. 이 메서드는 noexcept 및 예외 안전(exception safe)으로 명시되어 있습니다 [SWS_DM_01332]. 스레드 안전성은 조건부입니다: 함수를 스레드 안전하게 구현해야 하는지 여부는 생성자에서 전달된 ConcurrencyType을(를) 통해 결정됩니다 [SWS_DM_01332].

이 사용 지침은 진단 모듈에 대한 AUTOSAR Adaptive Platform 명세를 기반으로 합니다.

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
directoryName	Path including name of the directory to read
metaInfo	MetaInfo of the request.
cancellationHandler	This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::tuple< DataTransferReadSession, std::uint64_t > >	A Future with either the access strategy to be used during reading and the directory information size to be reported to the UDS client (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

Fehlercode	Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

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

Status: valid/unmigrated Version: rel:R25-11#58fefe54 Versionshistorie & Revisions (1 transition, 5 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_DM_01332@rel:R25-11#58fefe54

Recorded Revisions (5):

R25-11rel:R25-11#bfc5a2d72026-09-30
R22-11rel:R22-11#de5ccbca2026-10-14
R23-11rel:R23-11#6a311b002026-10-14
R24-11rel:R24-11#68f15ec32026-10-14
R25-11rel:R25-11#58fefe542026-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

함수 RequestReadFile [SWS_DM_01331] Upstream: RS_Diag_04135

virtual auto RequestReadFile (ara::core::String fileName, ara::core::Byte dataFormatIdentifier, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< std::tuple< DataTransferReadSession, FileSizes > >=0;

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 81963250d021 출처

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

사용

메서드 RequestReadFile은(는) 동작 모드가 ReadFile(0x04)인 RequestFileTransfer(0x38)에 대한 진단 요청이 수신되는 즉시 Diagnostic Server 인스턴스에 의해 호출됩니다 [SWS_DM_01314]. 이 함수는 이름을 포함한 파일 경로(fileName), 데이터 포맷(dataFormatIdentifier), 요청 메타데이터(metaInfo) 및 cancellationHandler을(를) 받습니다 [SWS_DM_01331]. cancellationHandler을(를) 통해 취소 상태를 쿼리하거나(IsCanceled) 현재 대화 취소에 대한 알림 함수를 등록할 수 있습니다(SetNotifier) [SWS_DM_01331].

실행은 비동기적으로 수행되며 ara::core::Future을(를) 반환합니다. 성공 시 Future는 DataTransferReadSession 및 FileSizes의 튜플을 제공합니다 [SWS_DM_01331]. FileSizes에서 uncompressed_size 또는 compressed_size의 값 0은 해당 크기가 UDS 클라이언트에 전송되지 않음을 나타내며, 압축되지 않은 파일의 경우 compressed_size은(는) null로 설정되어야 합니다 [SWS_DM_01331].

오류 처리

읽기 작업 준비에 실패하면 애플리케이션은 반환된 Future 내에서 DiagUdsNrcErrc을(를) 통해 ISO 14229-1에 따른 적절한 UDS NRC를 보고합니다 [SWS_DM_01331].

동시성 및 상호 작용

이 함수는 noexcept(으)로 선언되어 있습니다. 스레드 안전성은 조건부입니다(conditional): 구현이 스레드 안전하게 설계되어야 하는지 여부는 생성자에 전달된 ConcurrencyType에 의해 결정됩니다 [SWS_DM_01331]. 반환된 DataTransferReadSession 객체는 RequestFileTransfer의 처리와 실제 파일 데이터 스트림이 전송되는 후속 TransferData 서비스(0x36) 간의 연결고리를 형성합니다 SWS Diagnostics 184쪽.

이 텍스트는 AUTOSAR R25-11 사양을 바탕으로 AI에 의해 생성되었습니다.

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
fileName	Path including name of the file to read
dataFormatIdentifier	UDS dataFormat Identifier
metaInfo	MetaInfo of the request.
cancellationHandler	This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::tuple< DataTransferReadSession, FileSizes>>	A Future with either the access strategy to be used during reading and the file sizes to be reported to the UDS client (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

Fehlercode	Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

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

Status: valid/unmigrated Version: rel:R25-11#2da4b6c5 Versionshistorie & Revisions (1 transition, 5 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_DM_01331@rel:R25-11#2da4b6c5

Recorded Revisions (5):

R25-11rel:R25-11#de746ccd2026-09-30
R22-11rel:R22-11#014f2e682026-10-14
R23-11rel:R23-11#e48290792026-10-14
R24-11rel:R24-11#40bb50212026-10-14
R25-11rel:R25-11#2da4b6c52026-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

함수 RequestResumeWriteFile [SWS_DM_01334] Upstream: RS_Diag_04135

virtual auto RequestResumeWriteFile (ara::core::String fileName, ara::core::Byte dataFormatIdentifier, FileSizes fileSizes, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept -> ara::core::Future< std::tuple< DataTransferWriteSession, std::uint64_t > >=0;

Called for RequestFileTransfer with ModeOfOperation ResumeFile.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: 84d8dcb5e2d5 출처

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

메서드 RequestResumeWriteFile은(는) 동작 모드가 ResumeFile(0x06)인 RequestFileTransfer(0x38)에 대한 UDS 서비스 요청이 수신될 때 Diagnostic Server 인스턴스에 의해 호출됩니다([SWS_DM_01316], SWS Diagnostics §[SWS_DM_01316] “Realization of modeOfOperation ResumeFile (0x06)”). 그 목적은 이전에 중단된 파일 쓰기 작업을 재개하는 것입니다.

호출 시 파일 경로(fileName), UDS 데이터 포맷 식별자(dataFormatIdentifier), 파일 크기(fileSizes), 요청의 메타데이터(metaInfo) 및 cancellationHandler이(가) 전달됩니다([SWS_DM_01334], SWS Diagnostics §8.18.1.2.3.5 “RequestResumeWriteFile”). 애플리케이션은 cancellationHandler을(를) 통해 IsCanceled을(를) 사용하여 진행 중인 진단 대화가 중단되었는지 능동적으로 확인하거나, SetNotifier(으)로 중단에 대한 알림 함수를 등록할 수 있습니다([SWS_DM_01334]).

반환은 ara::core::Future<std::tuple<DataTransferWriteSession, std::uint64_t>>을(를) 통해 비동기적으로 수행됩니다([SWS_DM_01334]). 성공 시 Future는 DataTransferWriteSession의 인스턴스와 전송이 재개되어야 하는 바이트 위치를 포함하는 튜플을 제공합니다([SWS_DM_01334]). 이 세션 객체는 RequestFileTransfer을 통한 초기화와 후속 TransferData 서비스(0x36)를 연결합니다(SWS Diagnostics §[SWS_DM_01316] “Realization of modeOfOperation ResumeFile (0x06)”).

오류 발생 시 Future는 DiagUdsNrcErrc을(를) 통해 ISO 14229-1에 따른 적절한 UDS NRC로 종료되어야 합니다([SWS_DM_01334]). 이 함수는 noexcept(으)로 선언되어 있고 예외 안전합니다; 스레드 안전성은 조건부(“conditional”)이며 생성자에 전달된 ConcurrencyType에 의해 결정됩니다([SWS_DM_01334]).

이 텍스트는 AI에 의해 큐레이션되었으며 AUTOSAR Adaptive 플랫폼 R25-11의 명세만을 기반으로 합니다.

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
fileName	Path including name of the file to read
dataFormatIdentifier	UDS dataFormat Identifier
fileSizes	The compressed/uncompressed files sizes
metaInfo	MetaInfo of the request.
cancellationHandler	This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::tuple< DataTransferWriteSession, std::uint64_t > >	A Future with either an instance of the file writing session and the byte position where to start resuming from to be reported to the UDS client (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

Fehlercode	Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

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

Status: valid/unmigrated Version: rel:R25-11#f5ac33f7 Versionshistorie & Revisions (1 transition, 5 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_DM_01334@rel:R25-11#f5ac33f7

Recorded Revisions (5):

R25-11rel:R25-11#89c39f932026-09-30
R22-11rel:R22-11#8fe1f4b12026-10-14
R23-11rel:R23-11#42daa99b2026-10-14
R24-11rel:R24-11#56b464b02026-10-14
R25-11rel:R25-11#f5ac33f72026-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

함수 RequestWriteFile [SWS_DM_01333] Upstream: RS_Diag_04135

virtual auto RequestWriteFile (ara::core::String fileName, ara::core::Byte dataFormatIdentifier, FileSizes fileSizes, WriteFile Mode mode, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept -> ara::core::Future< DataTransferWriteSession >=0;

Called for RequestFileTransfer with ModeOfOperation WriteFile.

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

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

사용

메서드 [SWS_DM_01333]은(는) 동작 모드가 WriteFile인 UDS 서비스 요청 RequestFileTransfer(0x38)가 수신되는 즉시 진단 서버에 의해 호출됩니다([SWS_DM_01310]). 동작 모드 ReplaceFile(0x03)와 함께 요청이 전달되면 진단 서버는 쓰기 모드 kReplace(으)로 인터페이스를 호출합니다([SWS_DM_01313]). 이 호출은 파일 이름(fileName), 데이터 포맷 식별자(dataFormatIdentifier), 파일 크기(fileSizes), 대체 모드(mode), 추가 메타데이터(metaInfo) 및 cancellationHandler을(를) 전달합니다. 매개변수 fileName의 명세 설명인 “file to read”는 편집상의 실수인 것으로 추정되며 기록할 대상 파일의 경로를 나타냅니다. 질문 Q-f14158fc20fda8af (열림)

처리는 비동기적으로 수행되며 ara::core::Future<DataTransferWriteSession>을(를) 반환합니다([SWS_DM_01333]). 생성된 세션은 서비스 0x38을 통한 초기화와 TransferData(0x36)를 통한 후속 데이터 전송 간의 연결고리 역할을 합니다(AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”).

오류 처리 및 동시성

이 메서드는 noexcept(으)로 선언되어 있습니다. 오류가 발생하면 C++ 오류가 발생하지 않고, Future에 ISO 14229-1에 따른 DiagUdsNrcErrc의 적절한 UDS NRC가 반환됩니다([SWS_DM_01333]). 전달된 cancellationHandler을(를) 통해 IsCanceled()을(를) 사용하여 취소 상태를 쿼리하거나 SetNotifier()(으)로 알림을 등록할 수 있습니다, 진단 대화가 중단될 경우. 스레드 안전성은 조건부입니다: 함수를 스레드 안전하게 구현해야 하는지 여부는 생성자의 ConcurrencyType을(를) 통해 결정됩니다([SWS_DM_01333]).

상호 작용

이 연산은 파일 전송 서비스의 상호작용을 보완하며, RequestReadFile([SWS_DM_01314])과 같은 읽기 작업이나 RequestResumeWriteFile([SWS_DM_01316])를 통한 중단된 쓰기 작업의 재개와 상호 보완 관계에 있습니다.

이 사용 지침은 명세 상태를 기반으로 자동으로 생성되었습니다.

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

Parameter	Beschreibung
fileName	Path including name of the file to read
dataFormatIdentifier	UDS dataFormat Identifier
fileSizes	The compressed/uncompressed files sizes
mode	The file replacement mode
metaInfo	MetaInfo of the request.
cancellationHandler	This parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

Typ	Beschreibung
ara::core::Future< DataTransferWriteSession >	A Future with either an instance of the file writing session to be reported to the UDS client (for a positive response message) or an UDS NRC value (for a negative response message).

Fehler

Fehlercode	Beschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

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

Status: valid/unmigrated Version: rel:R25-11#51c3d98c Versionshistorie & Revisions (1 transition, 5 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_DM_01333@rel:R25-11#51c3d98c

Recorded Revisions (5):

R25-11rel:R25-11#c3df13832026-09-30
R22-11rel:R22-11#70b47e362026-10-14
R23-11rel:R23-11#5d904ef32026-10-14
R24-11rel:R24-11#27f280b82026-10-14
R25-11rel:R25-11#51c3d98c2026-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

함수 StopOffer [SWS_DM_01337] Upstream: RS_Diag_04135

void StopOffer () const noexcept;

This StopOffer will disable the forwarding of request messages from DM.

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

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

클래스 ara::diag::FileTransferService의 함수 StopOffer은(는) Diagnostic Management에서 서비스를 등록 취소하는 데 사용됩니다([SWS_DM_01337]; AUTOSAR_AP_SWS_Diagnostics §8.18.1.2.3.7 “StopOffer”). 그 호출은 DM이 이 시점부터 해당 서비스 인스턴스로 수신 진단 요청을 더 이상 전달하지 않도록 합니다. 해당 인터페이스는 헤더 #include "ara/diag/file_transfer.h"에 정의되어 있고 시그니처 void StopOffer() const noexcept;을(를) 가지며, 매개변수를 요구하지 않고 반환값을 갖지 않습니다. 호출은 동기적으로 실행됩니다.

StopOffer에는 오류 메커니즘이 제공되지 않습니다. 이 메서드는 예외 안전(exception safe) 및 식별자 noexcept(으)로 선언되어 있습니다([SWS_DM_01337]). 예외가 발생하지도 않고 오류 코드가 애플리케이션에 반환되지도 않습니다. 전달 비활성화는 API 관점에서 실패하지 않습니다.

명세에 따라 StopOffer은(는) 스레드 안전하지 않은 것(not thread-safe)으로 분류되어 있습니다([SWS_DM_01337]). 따라서 ara::diag::FileTransferService의 동일한 인스턴스에 대한 병렬 접근은 애플리케이션 측에서 동시성에 대해 보호되어야 합니다. 해석: 더 이상 작동 준비가 되지 않은 루틴으로 요청이 유입되지 않도록 하기 위해, 비활성화는 일반적으로 객체가 파괴되기 전이나 처리 애플리케이션의 정상적인 종료 중에 수행될 것으로 추정됩니다. 질문 Q-e7bb2a5621c39160 (열림)

StopOffer을(를) 통한 비활성화는 제공되는 진단 서비스에 대한 AUTOSAR Adaptive의 통합 아키텍처 패턴을 따릅니다. 이는 ara::diag::DownloadService([SWS_DM_00793]), ara::diag::UploadService([SWS_DM_00803]), ara::diag::CommunicationControl([SWS_DM_00810]) 및 ara::diag::Monitor([SWS_DM_01089]; AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”)과(와) 같은 관련 클래스의 동등한 비활성화 함수와 일치합니다.

이 텍스트는 사양을 기반으로 AI에 의해 생성되었습니다.

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

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

Rückgabewert

Typ	Beschreibung
None

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

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

Status: valid/unmigrated Version: rel:R25-11#70a7f50e Versionshistorie & Revisions (1 transition, 5 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_DM_01337@rel:R25-11#70a7f50e

Recorded Revisions (5):

R25-11rel:R25-11#a8ae9f322026-09-30
R22-11rel:R22-11#654bd0092026-10-14
R23-11rel:R23-11#f129c87f2026-10-14
R24-11rel:R24-11#70a7f50e2026-10-14
R25-11rel:R25-11#70a7f50e2026-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

함수 operator= [SWS_DM_01329] Upstream: RS_Diag_04135

auto operator= (FileTransferService const &) -> FileTransferService &=delete;

FileTransferService shall be a single not assignable instance.

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Sichtbarkeit	protected

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

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

Status: valid/unmigrated Version: rel:R25-11#1ea28835 Versionshistorie & Revisions (1 transition, 5 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_DM_01329@rel:R25-11#1ea28835

Recorded Revisions (5):

R25-11rel:R25-11#b87225482026-09-30
R22-11rel:R22-11#718170092026-10-14
R23-11rel:R23-11#5215d06f2026-10-14
R24-11rel:R24-11#1ea288352026-10-14
R25-11rel:R25-11#1ea288352026-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

함수 operator= [SWS_DM_01330] Upstream: RS_Diag_04135

auto operator= (FileTransferService &&other) & noexcept -> File TransferService &;

Move assigns an instance of FileTransferService.

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe
Sichtbarkeit	protected

Parameter (out)

Parameter	Beschreibung
other	The other object

Rückgabewert

Typ	Beschreibung
FileTransferService	Reference to self

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

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

Status: valid/unmigrated Version: rel:R25-11#3d2ac0df Versionshistorie & Revisions (1 transition, 5 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_DM_01330@rel:R25-11#3d2ac0df

Recorded Revisions (5):

R25-11rel:R25-11#dc10e40b2026-09-30
R22-11rel:R22-11#2eaabf332026-10-14
R23-11rel:R23-11#2e1bc2e32026-10-14
R24-11rel:R24-11#275db4722026-10-14
R25-11rel:R25-11#3d2ac0df2026-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

함수 ~FileTransferService [SWS_DM_01326] Upstream: RS_Diag_04135

virtual ~FileTransferService () noexcept;

Destructor of class FileTransferService.

Header-Datei	#include "ara/diag/file_transfer.h"
Scope	class ara::diag::FileTransferService
Exception-Sicherheit	exception safe
Thread-Sicherheit	not thread-safe

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

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

Status: valid/unmigrated Version: rel:R25-11#8e0522c6 Versionshistorie & Revisions (1 transition, 5 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_DM_01326@rel:R25-11#8e0522c6

Recorded Revisions (5):

R25-11rel:R25-11#838a47062026-09-30
R22-11rel:R22-11#34fabb372026-10-14
R23-11rel:R23-11#0e9f351d2026-10-14
R24-11rel:R24-11#8e0522c62026-10-14
R25-11rel:R25-11#8e0522c62026-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

열거형 문서

열거형 WriteFileMode [SWS_DM_01324] Upstream: RS_Diag_04135

enum class WriteFileMode :             ara::core::Byte {...};

Determines the write file operation mode.

Header-Datei	#include "ara/diag/file_transfer.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	class ara::diag::FileTransferService
Symbol	WriteFileMode
Basistyp	ara::core::Byte

Werte

Enumerator	Beschreibung
kAdd	The file shall be added only if not existing.
kReplace	The file shall be added in any case, if already exists, will be replaced.

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

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

Status: valid/unmigrated Version: rel:R25-11#ccf1739f Versionshistorie & Revisions (1 transition, 5 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_DM_01324@rel:R25-11#ccf1739f

Recorded Revisions (5):

R25-11rel:R25-11#5ddcfb102026-09-30
R22-11rel:R22-11#50d44c362026-10-14
R23-11rel:R23-11#0e3c6f352026-10-14
R24-11rel:R24-11#0e3c6f352026-10-14
R25-11rel:R25-11#ccf1739f2026-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::diag::FileTransferService

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

멤버 맵

생성자 및 소멸자

메서드

연산자

열거형

중첩 타입

클래스 다이어그램

상세 보기

생성자 및 소멸자

메서드

연산자

열거형

중첩 타입

메서드 문서

함수 DeleteFile [SWS_DM_01335] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 FileTransferService [SWS_DM_01325] Upstream: RS_Diag_04135, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

Parameter (in)

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 FileTransferService [SWS_DM_01327] Upstream: RS_Diag_04135

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 FileTransferService [SWS_DM_01328] Upstream: RS_Diag_04135

Parameter (out)

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 Offer [SWS_DM_01336] Upstream: RS_Diag_04135

사용

오류 처리

동시성 및 제약사항

상호 작용

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 RequestReadDirectory [SWS_DM_01332] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 RequestReadFile [SWS_DM_01331] Upstream: RS_Diag_04135

사용

오류 처리

동시성 및 상호 작용

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 RequestResumeWriteFile [SWS_DM_01334] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):