类 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

用户指南人工智能生成

允许自适应应用程序为 UDS 诊断服务提供文件和目录操作。

AI 生成未审核模型： gemini-3.8-flash-medium · 推理强度： medium · 温度：不可控 · 提示词： 50ca3b00d3d3 来源未决问题（2）

译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

允许自适应应用程序为 UDS 诊断服务提供文件和目录操作。

该服务接口用于将特定于应用程序的文件传输连接到 Diagnostic Management，以支持 UDS 服务 RequestFileTransfer（[SWS_DM_01320]、SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”）。实例化后，应用程序使用 Offer() 激活传入文件请求的转发，并通过专用处理程序方法异步处理读取、写入或删除等文件操作（[SWS_DM_01336]）。在读取和写入过程中，服务提供会话对象，实际的数据传输将通过这些对象进行处理。该类的实例不可复制，并且需要通过实例说明符进行固定绑定。

上下文

类 ara::diag::FileTransferService 定义了用于在 AUTOSAR Adaptive Platform 中实现 UDS 服务 RequestFileTransfer (0x38) 的诊断接口（[SWS_DM_01320]、SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”）。它充当 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”。

生命周期

通过指定建模的 ara::core::InstanceSpecifier 以及并发模型 ConcurrencyType 来创建 FileTransferService 的实例（[SWS_DM_01325]）。通过 ConcurrencyType 指定该类的回调方法必须实现为线程安全（kConcurrent）还是非线程安全（kNotConcurrent）（[SWS_DM_01325]、[SWS_DM_01331]）。作为受保护的单一功能，该类不可复制（[SWS_DM_01327]、[SWS_DM_01329]），但支持移动语义（[SWS_DM_01328]、[SWS_DM_01330]）。

实例化后，必须通过方法 Offer() 显式激活服务，以便 Diagnostic Management 转发传入请求（[SWS_DM_01336]）。使用 StopOffer() 可以随时再次停用转发（[SWS_DM_01337]）。解读：可能需要在对象被虚析构函数 ~FileTransferService() 销毁之前调用 StopOffer()（[SWS_DM_01326]），以避免 Diagnostic Management 进行孤立的回调访问。问题 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#8cf32cec
Content hash: 8cf32cec
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#ddb3d29f
Content hash: ddb3d29f
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#f7ef67f6
Content hash: f7ef67f6
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#997bf4da
Content hash: 997bf4da
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 中诊断处理程序的标准化提供模式。例如，针对文件下载 [SWS_DM_00792]、上传 [SWS_DM_00802] 以及通用 UDS 服务 [SWS_DM_00619]，存在由 DM 进行请求转发的类似机制。

本使用说明基于 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#548a58a5
Content hash: 548a58a5
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 · 德文原文

当接收到具有 modeOfOperation ReadDir (0x05) 的 RequestFileTransfer (0x38) 诊断请求时，Diagnostic Server 实例将调用方法 ara::diag::FileTransferService::RequestReadDirectory [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#b06f105f
Content hash: b06f105f
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 · 德文原文

使用

一旦收到操作模式为 ReadFile (0x04) 的 RequestFileTransfer (0x38) 诊断请求，Diagnostic Server 实例就会调用方法 RequestReadFile [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 必须设置为零 [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页。

本文由 AI 基于 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
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#04492abf
Content hash: 04492abf
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 · 德文原文

当接收到操作模式为 ResumeFile (0x06) 的 RequestFileTransfer (0x38) UDS 服务请求时，Diagnostic Server 的实例会调用方法 RequestResumeWriteFile ([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])。该 Session 对象将通过 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 Platform 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#86f43f02
Content hash: 86f43f02
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 · 德文原文

使用

一旦接收到操作模式为 WriteFile 的 UDS 服务请求 RequestFileTransfer (0x38)，诊断服务器就会调用方法 [SWS_DM_01333] ([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 中返回来自 DiagUdsNrcErrc 且符合 ISO 14229-1 的相应 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#8a5567c5
Content hash: 8a5567c5
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#cba2dd7b
Content hash: cba2dd7b
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#a9965044
Content hash: a9965044
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#b7adfc0e
Content hash: b7adfc0e
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#44eb446e
Content hash: 44eb446e
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#6d8e2821
Content hash: 6d8e2821
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

用户指南人工智能生成

上下文

生命周期

使用路径

错误场景

成员图

构造函数和析构函数

方法

运算符

枚举

嵌套类型

类图

详细视图

构造函数和析构函数

方法

运算符

枚举

嵌套类型

方法文档

函数 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):