classe 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

Guide utilisateurGÉNÉRÉ PAR IA

Permet aux applications adaptatives de fournir des opérations sur les fichiers et les répertoires pour les services de diagnostic UDS.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 50ca3b00d3d3 Provenance Questions ouvertes (2)

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Permet aux applications adaptatives de fournir des opérations sur les fichiers et les répertoires pour les services de diagnostic UDS.

L'interface de service sert à raccorder les transferts de fichiers spécifiques à l'application au Diagnostic Management pour le service UDS RequestFileTransfer ([SWS_DM_01320], SWS_Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer »). Après l'instanciation, l'application active le transfert des requêtes de fichiers entrantes avec Offer() et traite les opérations sur les fichiers telles que la lecture, l'écriture ou la suppression de manière asynchrone via des méthodes gestionnaires spécialisées ([SWS_DM_01336]). Lors des opérations de lecture et d'écriture, le service fournit des objets de session par l'intermédiaire desquels le transfert de données effectif est réalisé. Les instances de la classe ne sont pas copiables et nécessitent une liaison fixe via un spécificateur d'instance.

Contexte

La classe ara::diag::FileTransferService définit l'interface de diagnostic pour la réalisation du service UDS RequestFileTransfer (0x38) dans l'AUTOSAR Adaptive Platform ([SWS_DM_01320], SWS_Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer »). Elle fait office de Service-Interface entre le Diagnostic Management (DM ou Diagnostic Server) et l'application de diagnostic concrète afin de gérer de manière flexible la lecture, l'écriture, la reprise et la suppression de fichiers ou de répertoires au-delà des frontières de processus (SWS_Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer »).

Trois parties interviennent généralement dans un scénario de transfert de fichiers : le client UDS externe (testeur de diagnostic), le Diagnostic Server en tant qu'intermédiaire ainsi que l'application adaptative qui hérite de FileTransferService. Lors de requêtes de diagnostic entrantes, le Diagnostic Server délègue la requête aux méthodes virtuelles implémentées du service ([SWS_DM_01313], [SWS_DM_01314]). Pour les transferts de données ultérieurs (UDS 0x36 TransferData) et la finalisation (UDS 0x37 RequestTransferExit), le Diagnostic Management recourt directement à des classes gestionnaires fournies via des objets de session (DataTransferReadSession ou DataTransferWriteSession) ([SWS_DM_01317], [SWS_DM_01318]).

Diagramme de contexte : interaction entre le client UDS, le Diagnostic Management, l'implémentation de service et les sessions de transfert. Sources : [SWS_DM_01317], [SWS_DM_01318], SWS_Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer ».

Cycle de vie

Une instance de FileTransferService est créée en indiquant un ara::core::InstanceSpecifier modélisé ainsi que le modèle de concurrence ConcurrencyType ([SWS_DM_01325]). Le ConcurrencyType détermine si les méthodes de rappel de la classe doivent être implémentées de manière thread-safe (kConcurrent) ou non thread-safe (kNotConcurrent) ([SWS_DM_01325], [SWS_DM_01331]). En tant que fonction individuelle protégée, la classe n'est pas copiable ([SWS_DM_01327], [SWS_DM_01329]), mais prend en charge la sémantique de déplacement ([SWS_DM_01328], [SWS_DM_01330]).

Après l'instanciation, le service doit être explicitement activé via la méthode Offer() afin que le Diagnostic Management transmette les requêtes entrantes ([SWS_DM_01336]). Avec StopOffer(), la transmission peut être désactivée à tout moment ([SWS_DM_01337]). Interprétation : il devrait être nécessaire d'appeler StopOffer() avant la destruction de l'objet par le destructeur virtuel ~FileTransferService() ([SWS_DM_01326]) afin d'éviter les accès de rappel orphelins du Diagnostic Management. Question Q-3c5c406a144ced0c (ouverte) Ni Offer(), ni StopOffer(), ni le destructeur ne sont thread-safe ([SWS_DM_01326], [SWS_DM_01336], [SWS_DM_01337]).

Diagramme d'états : transitions d'état d'une instance de FileTransferService entre instanciation, mise à disposition et arrêt. Sources : [SWS_DM_01325], [SWS_DM_01336], [SWS_DM_01337], [SWS_DM_01326].

Parcours d'utilisation

Le déroulement typique d'une opération sur fichier se divise en configuration, déclenchement de l'opération et transfert de blocs consécutif. Tout d'abord, lors d'une requête UDS 0x38 avec le mode ReadFile (0x04), le Diagnostic Management transmet l'appel à RequestReadFile ([SWS_DM_01314], [SWS_DM_01331]). L'application traite le nom du fichier ainsi que les informations de format et les métadonnées, puis renvoie de manière asynchrone via un ara::core::Future un tuple composé d'une DataTransferReadSession et des tailles de fichier (FileSizes) ([SWS_DM_01331]). Interprétation : la stratégie de transfert utilisée (telle que copie, zero-copy ou handle de système de fichiers) est probablement déterminée par l'application lors de l'instanciation de la classe de session respective (SWS_Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer », [SWS_DM_01317]). Question Q-80b541ae6dd7cc34 (ouverte)

Après confirmation positive, le client demande les blocs de données via TransferData (0x36). Le Diagnostic Server appelle alors directement la méthode Read du gestionnaire enregistré de la DataTransferReadSession ([SWS_DM_01317]). Dès que tous les blocs sont transférés, le client clôture la transaction avec RequestTransferExit (0x37), à la suite de quoi le Diagnostic Server appelle la méthode Exit du gestionnaire ([SWS_DM_01318]). Des schémas similaires s'appliquent à l'écriture via RequestWriteFile ([SWS_DM_01313], [SWS_DM_01333]) avec le mode WriteFileMode ([SWS_DM_01324]), à la reprise via RequestResumeWriteFile ([SWS_DM_01316], [SWS_DM_01334]), à la lecture de répertoire via RequestReadDirectory ([SWS_DM_01315], [SWS_DM_01332]) ou à la suppression directe via DeleteFile ([SWS_DM_01335]).

Diagramme de séquence : déroulement d'une opération de lecture via UDS 0x38, 0x36 et 0x37. Sources : [SWS_DM_01314], [SWS_DM_01317], [SWS_DM_01318], [SWS_DM_01331].

Scénarios d'erreur

Des erreurs peuvent survenir au cours de plusieurs phases :

Violations de construction : si la résolution ou l'association du InstanceSpecifier échoue, des erreurs de modélisation telles que InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation, ProcessMappingViolation ou InstanceSpecifierAlreadyInUseViolation surviennent ([SWS_DM_01325]).
Erreurs d'activation : un appel répété de Offer() alors que le service est déjà actif renvoie l'erreur DiagOfferErrc::kAlreadyOffered ([SWS_DM_01336]).
Codes d'erreur de diagnostic (NRC) : si une opération ne peut pas être exécutée avec succès, les méthodes de rappel renvoient dans le ara::core::Future un code de réponse négatif UDS approprié (NRC selon ISO 14229-1) via DiagUdsNrcErrc ([SWS_DM_01331], [SWS_DM_01333], [SWS_DM_01335]).
Traitement de l'annulation : via l'objet CancellationHandler transmis, l'application peut vérifier avec IsCanceled si la conversation a été interrompue ou enregistrer via SetNotifier une fonction de notification pour les interruptions asynchrones ([SWS_DM_01331], [SWS_DM_01335]).

Ce guide se base exclusivement sur la spécification AUTOSAR R25-11 et a été créé de manière automatisée.

Carte des membres

Diagramme de classes

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

Vue détaillée

Sélectionnez une entrée dans le plan.

Aucune donnée d'élément pour cette version

Constructeurs et destructeur

FileTransferService fonction 3

Constructor for FileTransferService (inherited)

Surcharges 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 fonction

Destructor of class FileTransferService.

virtual ~FileTransferService () noexcept;

Méthodes

DeleteFile fonction

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 fonction

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

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

RequestReadDirectory fonction

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 fonction

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 fonction

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 fonction

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 fonction

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

void StopOffer () const noexcept;

Opérateurs

operator= fonction 2

FileTransferService shall be a single not assignable instance.

Surcharges = 2

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

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

Énumérations

WriteFileMode énumération

Determines the write file operation mode.

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

Types imbriqués

FileSizes classe

Cliquez sur une entrée pour voir ses relations.

Documentation des méthodes

fonction 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

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : d47efb319aaa Provenance Questions ouvertes (1)

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La méthode DeleteFile de la classe ara::diag::FileTransferService (SWS Diagnostics §8.18.1.2.3.1 « DeleteFile », en-tête #include "ara/diag/file_transfer.h") gère l'opération de suppression complète d'un fichier dans le cadre du service UDS RequestFileTransfer (0x38) avec le mode DeleteFile [SWS_DM_01335]. Le service UDS est fourni côté serveur conformément à l'ISO 14229-1 [SWS_DM_01310] SWS Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer ».

Trois paramètres sont transmis lors de l'appel [SWS_DM_01335] :

fileName (ara::core::String) : indication du chemin et nom du fichier cible (interprétation : malgré la mention rédactionnelle « file to read » dans le texte de spécification, il s'agit du fichier à supprimer). Question Q-cdbe1185bb030e87 (ouverte)
metaInfo (MetaInfo const &) : métadonnées de la requête de diagnostic actuelle.
cancellationHandler (CancellationHandler) : permet la vérification de l'état d'annulation via cancellationHandler.IsCanceled() ainsi que l'enregistrement d'une fonction de notification via cancellationHandler.SetNotifier() si la conversation en cours est interrompue.

Comme résultat asynchrone, la fonction renvoie un ara::core::Future<void> [SWS_DM_01335]. Une fin d'exécution réussie signale au client de diagnostic un comportement de réponse positive. En cas d'erreur, un NRC UDS approprié conformément à l'ISO 14229-1 doit être mis à disposition via DiagUdsNrcErrc dans le Future [SWS_DM_01335].

La fonction est spécifiée comme noexcept et considérée comme sûre vis-à-vis des exceptions (« exception safe ») [SWS_DM_01335]. L'exigence de sécurité des threads est conditionnelle et est régie par le ConcurrencyType transmis au constructeur [SWS_DM_01335].

Cette note d'utilisation a été générée automatiquement sur la base de la spécification AUTOSAR R25-11.

Guide de l'implémenteur à venir (complexité 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#9a80ff86
Content hash: 9a80ff86
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

fonction 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#c406b1a1
Content hash: c406b1a1
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

fonction 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#e50e28c9
Content hash: e50e28c9
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

fonction 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#2be76d70
Content hash: 2be76d70
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

fonction 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.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : ae7133c89fe4 Provenance

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Utilisation

La méthode Offer de la classe ara::diag::FileTransferService enregistre le gestionnaire auprès du Diagnostic Management (DM) afin que ce dernier puisse transférer les requêtes de diagnostic entrantes relatives au transfert de fichiers vers l'instance [SWS_DM_01336]. L'appel s'effectue sans paramètre et de manière synchrone. Le type de retour utilisé est ara::core::Result<void>, ce qui signale le succès de l'enregistrement ou une erreur survenue [SWS_DM_01336].

Gestion des erreurs

Si une erreur survient lors de la mise à disposition, la fonction renvoie un ara::core::Result en erreur. Si le service a déjà été proposé avec succès auparavant pour l'instance concernée, le code d'erreur spécifique DiagOfferErrc::kAlreadyOffered est renvoyé avec une sémantique de retour arrière (rollback) [SWS_DM_01336].

Concurrence et restrictions

La fonction est déclarée sûre vis-à-vis des exceptions (exception safe) et comme noexcept, mais est considérée comme non sûre vis-à-vis des threads (not thread-safe) [SWS_DM_01336]. Les appels sur la même instance de service ne doivent donc pas être exécutés en parallèle sans protection depuis plusieurs threads.

Interaction

La proposition via Offer correspond au modèle de mise à disposition standardisé pour les gestionnaires de diagnostic dans Adaptive AUTOSAR. Des mécanismes analogues de transfert des requêtes par le DM existent par exemple pour le téléchargement de fichiers [SWS_DM_00792], le téléversement [SWS_DM_00802] ainsi que les services UDS généraux [SWS_DM_00619].

Cette note d'utilisation a été générée de manière automatisée à partir de la spécification AUTOSAR AP R25-11.

Guide de l'implémenteur à venir (complexité 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#0126f584
Content hash: 0126f584
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

fonction 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. .

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : a6ee000cae47 Provenance

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La méthode ara::diag::FileTransferService::RequestReadDirectory est appelée par l'instance de serveur de diagnostic lorsqu'une requête de diagnostic pour RequestFileTransfer (0x38) avec le modeOfOperation ReadDir (0x05) est reçue [SWS_DM_01315]. La fonction prend en entrée les paramètres suivants [SWS_DM_01332] :

directoryName : chemin incluant le nom de répertoire du répertoire à lire.
metaInfo : métadonnées de la requête de diagnostic entrante.
cancellationHandler : objet permettant d'interroger une interruption de conversation via cancellationHandler.IsCanceled() ou d'enregistrer une fonction de rappel (callback) via cancellationHandler.SetNotifier() pour les événements d'interruption.

Le retour s'effectue de manière asynchrone via un ara::core::Future<std::tuple<DataTransferReadSession, std::uint64_t>> [SWS_DM_01332]. En cas de succès, le tuple contient la stratégie d'accès DataTransferReadSession ainsi que la taille du répertoire transmise au client UDS [SWS_DM_01332]. L'objet DataTransferReadSession établit ainsi la liaison entre l'initialisation par RequestFileTransfer (0x38) et les transferts de fichiers ultérieurs via TransferData (0x36) SWS Diagnostics p. 184 « Realization of modeOfOperation ReadDir (0x05) ».

Si le traitement échoue, le Future fournit un code de réponse négatif (NRC) conformément à l'ISO 14229-1 via DiagUdsNrcErrc [SWS_DM_01332]. La méthode est spécifiée comme noexcept et sûre vis-à-vis des exceptions (exception safe) [SWS_DM_01332]. La sécurité des threads est conditionnelle : le fait que la fonction doive être implémentée de manière thread-safe est déterminé par le ConcurrencyType transmis dans le constructeur [SWS_DM_01332].

Cette note d'utilisation est basée sur les spécifications de l'AUTOSAR Adaptive Platform pour le module de diagnostic.

Guide de l'implémenteur à venir (complexité 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#95f65abf
Content hash: 95f65abf
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

fonction 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;

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 81963250d021 Provenance

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Utilisation

La méthode RequestReadFile est appelée par l'instance de serveur de diagnostic dès qu'une requête de diagnostic pour RequestFileTransfer (0x38) avec le mode d'opération ReadFile (0x04) est reçue [SWS_DM_01314]. La fonction prend en entrée le chemin du fichier ainsi que son nom (fileName), le format de données (dataFormatIdentifier), les métadonnées de la requête (metaInfo) ainsi qu'un cancellationHandler [SWS_DM_01331]. Grâce au cancellationHandler, l'état d'annulation peut être interrogé (IsCanceled) ou une fonction de notification d'annulation de la conversation actuelle peut être enregistrée (SetNotifier) [SWS_DM_01331].

L'exécution s'effectue de manière asynchrone et renvoie un ara::core::Future. En cas de succès, le future fournit un tuple composé de DataTransferReadSession et de FileSizes [SWS_DM_01331]. Dans FileSizes, une valeur de 0 pour uncompressed_size ou compressed_size signale que la taille respective n'est pas transmise au client UDS ; pour les fichiers non compressés, compressed_size doit être défini à zéro [SWS_DM_01331].

Gestion des erreurs

Si la préparation de l'opération de lecture échoue, l'application signale un NRC UDS approprié conformément à l'ISO 14229-1 via DiagUdsNrcErrc dans le future renvoyé [SWS_DM_01331].

Concurrence et interaction

La fonction est déclarée comme noexcept. La sécurité des threads est conditionnelle (conditional) : le ConcurrencyType transmis au constructeur détermine si l'implémentation doit être conçue pour être thread-safe [SWS_DM_01331]. L'objet DataTransferReadSession renvoyé constitue le lien entre le traitement de RequestFileTransfer et les services TransferData ultérieurs (0x36), par lesquels le flux effectif de données de fichier est transféré SWS Diagnostics p. 184.

Ce texte a été généré par une IA sur la base de la spécification AUTOSAR R25-11.

Guide de l'implémenteur à venir (complexité 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#26b4e6b6
Content hash: 26b4e6b6
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

fonction 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.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 84d8dcb5e2d5 Provenance

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La méthode RequestResumeWriteFile est appelée par une instance du serveur de diagnostic lorsqu'une requête de service UDS pour RequestFileTransfer (0x38) avec le mode de fonctionnement ResumeFile (0x06) est reçue ([SWS_DM_01316], SWS Diagnostics §[SWS_DM_01316] « Realization of modeOfOperation ResumeFile (0x06) »). Son but est la reprise d'une opération d'écriture de fichier précédemment interrompue.

Lors de l'appel, le chemin du fichier (fileName), l'identifiant de format de données UDS (dataFormatIdentifier), les tailles de fichier (fileSizes), les métadonnées de la requête (metaInfo) ainsi qu'un cancellationHandler sont transmis ([SWS_DM_01334], SWS Diagnostics §8.18.1.2.3.5 « RequestResumeWriteFile »). Via le cancellationHandler, l'application peut vérifier activement à l'aide de IsCanceled si la conversation de diagnostic en cours a été interrompue, ou enregistrer via SetNotifier une fonction de notification pour une interruption ([SWS_DM_01334]).

Le retour s'effectue de manière asynchrone via ara::core::Future<std::tuple<DataTransferWriteSession, std::uint64_t>> ([SWS_DM_01334]). En cas de succès, le future met à disposition un tuple contenant une instance de la DataTransferWriteSession ainsi que la position d'octet à partir de laquelle le transfert doit être poursuivi ([SWS_DM_01334]). Cet objet session relie l'initialisation par RequestFileTransfer aux services TransferData ultérieurs (0x36) (SWS Diagnostics §[SWS_DM_01316] « Realization of modeOfOperation ResumeFile (0x06) »).

En cas d'erreur, le future doit être terminé avec un NRC UDS approprié conformément à l'ISO 14229-1 via DiagUdsNrcErrc ([SWS_DM_01334]). La fonction est déclarée comme noexcept et sûre vis-à-vis des exceptions ; la sécurité des threads est conditionnelle (« conditional ») et est déterminée par le ConcurrencyType transmis dans le constructeur ([SWS_DM_01334]).

Ce texte a été élaboré par une IA et repose exclusivement sur les spécifications de l'AUTOSAR Adaptive Platform R25-11.

Guide de l'implémenteur à venir (complexité 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#897d6a14
Content hash: 897d6a14
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

fonction 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.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : d68fe452ba36 Provenance Questions ouvertes (1)

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Utilisation

La méthode [SWS_DM_01333] est appelée par le serveur de diagnostic dès qu'une requête de service UDS RequestFileTransfer (0x38) avec le mode de fonctionnement WriteFile est reçue ([SWS_DM_01310]). Si la requête est transmise avec le mode de fonctionnement ReplaceFile (0x03), le serveur de diagnostic appelle l'interface avec le mode d'écriture kReplace ([SWS_DM_01313]). L'appel transmet le nom du fichier (fileName), l'identifiant du format de données (dataFormatIdentifier), les tailles de fichier (fileSizes), le mode de remplacement (mode), des métadonnées supplémentaires (metaInfo) ainsi qu'un cancellationHandler. L'indication « file to read » dans la spécification pour le paramètre fileName semble être une inadvertance rédactionnelle et désigne le chemin cible du fichier à écrire. Question Q-f14158fc20fda8af (ouverte)

Le traitement s'effectue de manière asynchrone et renvoie un ara::core::Future<DataTransferWriteSession> ([SWS_DM_01333]). La session résultante sert de lien entre l'initialisation via le service 0x38 et les transferts de données ultérieurs via TransferData (0x36) (AUTOSAR_AP_SWS_Diagnostics §7.3.2.8.20 « Service 0x38 – RequestFileTransfer »).

Gestion des erreurs et concurrence

La méthode est déclarée comme noexcept. En cas d'erreur, aucune erreur C++ n'est levée, mais un NRC UDS approprié issu de DiagUdsNrcErrc conformément à l'ISO 14229-1 est renvoyé dans le future ([SWS_DM_01333]). Grâce au cancellationHandler transmis, l'état d'annulation peut être interrogé au moyen de IsCanceled() ou une notification peut être enregistrée avec SetNotifier() si la conversation de diagnostic s'interrompt. La sécurité des threads est conditionnelle : le fait que la fonction doive être implémentée de manière thread-safe est déterminé par le ConcurrencyType dans le constructeur ([SWS_DM_01333]).

Interaction

L'opération complète l'interaction des services de transfert de fichiers et est complémentaire des opérations de lecture telles que RequestReadFile ([SWS_DM_01314]) ou de la reprise d'opérations d'écriture interrompues via RequestResumeWriteFile ([SWS_DM_01316]).

Cette note d'utilisation a été générée automatiquement sur la base de l'état de la spécification.

Guide de l'implémenteur à venir (complexité 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#640d30b0
Content hash: 640d30b0
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

fonction StopOffer [SWS_DM_01337] Upstream: RS_Diag_04135

void StopOffer () const noexcept;

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

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : b1eec837af18 Provenance Questions ouvertes (1)

traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La fonction StopOffer de la classe ara::diag::FileTransferService sert à désinscrire le service auprès du Diagnostic Management ([SWS_DM_01337] ; AUTOSAR_AP_SWS_Diagnostics §8.18.1.2.3.7 « StopOffer »). Son appel a pour effet que le DM ne transfère plus aucune requête de diagnostic entrante à cette instance de service à partir de cet instant. L'interface est définie dans l'en-tête #include "ara/diag/file_transfer.h", possède la signature void StopOffer() const noexcept;, n'attend aucun paramètre et ne fournit aucune valeur de retour. L'appel est exécuté de manière synchrone.

Aucun mécanisme d'erreur n'est prévu pour StopOffer. La méthode est déclarée comme sûre vis-à-vis des exceptions (exception safe) et avec l'identifiant noexcept ([SWS_DM_01337]). Aucune exception n'est déclenchée et aucun code d'erreur n'est renvoyé à l'application. La désactivation du transfert n'échoue pas du point de vue de l'API.

Conformément à la spécification, StopOffer est classé comme non sûr vis-à-vis des threads (not thread-safe) ([SWS_DM_01337]). Par conséquent, les accès parallèles à la même instance de ara::diag::FileTransferService doivent être protégés contre la concurrence côté application. Interprétation : la désactivation devrait typiquement avoir lieu avant la destruction de l'objet ou pendant un arrêt ordonné de l'application de traitement, afin qu'aucune requête n'arrive dans une routine qui n'est plus opérationnelle. Question Q-e7bb2a5621c39160 (ouverte)

La désactivation via StopOffer suit le modèle d'architecture uniforme d'AUTOSAR Adaptive pour les services de diagnostic fournis. Elle correspond à des fonctions de désactivation similaires de classes apparentées telles que ara::diag::DownloadService ([SWS_DM_00793]), ara::diag::UploadService ([SWS_DM_00803]), ara::diag::CommunicationControl ([SWS_DM_00810]) et ara::diag::Monitor ([SWS_DM_01089] ; AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors »).

Ce texte a été généré par une IA sur la base de la spécification.

Guide de l'implémenteur à venir (complexité 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#f99778b7
Content hash: f99778b7
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

fonction 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#b7f9d076
Content hash: b7f9d076
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

fonction 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#5030d077
Content hash: 5030d077
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

fonction ~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#174f7001
Content hash: 174f7001
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

Documentation des énumérations

énumération 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#a12b6aab
Content hash: a12b6aab
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

classe ara::diag::FileTransferService

Guide utilisateurGÉNÉRÉ PAR IA

Contexte

Cycle de vie

Parcours d'utilisation

Scénarios d'erreur

Carte des membres

Constructeurs et destructeur

Méthodes

Opérateurs

Énumérations

Types imbriqués

Diagramme de classes

Vue détaillée

Constructeurs et destructeur

Méthodes

Opérateurs

Énumérations

Types imbriqués

Documentation des méthodes

fonction 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:

fonction 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:

fonction FileTransferService [SWS_DM_01327] Upstream: RS_Diag_04135

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

fonction FileTransferService [SWS_DM_01328] Upstream: RS_Diag_04135

Parameter (out)

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

fonction Offer [SWS_DM_01336] Upstream: RS_Diag_04135

Utilisation

Gestion des erreurs

Concurrence et restrictions

Interaction

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

fonction 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:

fonction RequestReadFile [SWS_DM_01331] Upstream: RS_Diag_04135

Utilisation

Gestion des erreurs

Concurrence et interaction

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

fonction RequestResumeWriteFile [SWS_DM_01334] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):