DEENESPTFRRUARHIKOZHNL

क्लास 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"
Scopenamespace ara::diag

उपयोगकर्ता गाइडएआई जनित

अनुकूली एप्लिकेशन्स को UDS डायग्नोस्टिक सेवाओं के लिए फ़ाइल और निर्देशिका संचालन प्रदान करने में सक्षम बनाता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 50ca3b00d3d3 उद्गम खुले प्रश्न (2)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

अनुकूली एप्लिकेशन्स को UDS डायग्नोस्टिक सेवाओं के लिए फ़ाइल और निर्देशिका संचालन प्रदान करने में सक्षम बनाता है।

सर्विस इंटरफ़ेस UDS सेवा RequestFileTransfer ([SWS_DM_01320], SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”) के लिए Diagnostic Management से एप्लिकेशन-विशिष्ट फ़ाइल ट्रांसफ़र के जुड़ाव का कार्य करता है। इंस्टेंटिएशन के बाद, एप्लिकेशन Offer() के साथ आने वाले फ़ाइल अनुरोधों के अग्रेषण को सक्रिय करता है और विशिष्ट हैंडलर विधियों ([SWS_DM_01336]) के माध्यम से पढ़ने, लिखने या हटाने जैसे फ़ाइल ऑपरेशन्स को एसिंक्रोनस रूप से संसाधित करता है। पढ़ने और लिखने की प्रक्रियाओं के दौरान, सेवा सेशन ऑब्जेक्ट्स प्रदान करती है जिसके माध्यम से वास्तविक डेटा ट्रांसफ़र निष्पादित किया जाता है। क्लास के इंस्टेंस प्रतिलिपि योग्य नहीं हैं और उन्हें एक इंस्टेंस विनिर्देशक के माध्यम से निश्चित बाइंडिंग की आवश्यकता होती है।

संदर्भ

क्लास ara::diag::FileTransferService AUTOSAR Adaptive Platform ([SWS_DM_01320], SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”) में UDS सेवा RequestFileTransfer (0x38) के कार्यान्वयन के लिए डायग्नोस्टिक इंटरफ़ेस को परिभाषित करती है। यह प्रोसेस सीमाओं के पार फ़ाइलों या निर्देशिकाओं को पढ़ने, लिखने, फिर से शुरू करने और हटाने को लचीले ढंग से संभालने के लिए Diagnostic Management (DM या Diagnostic Server) और ठोस डायग्नोस्टिक्स एप्लिकेशन के बीच एक Service-Interface के रूप में कार्य करती है (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])।

Kontext client UDS-Client (Tester) dm निदान प्रबंधन client->dm UDS 0x38, 0x36, 0x37 app Adaptive Application (FileTransferService) dm->app RequestReadFile / RequestWriteFile / ... session DataTransferReadSession / DataTransferWriteSession dm->session Read / Write / Exit app->session erzeugt Session

संदर्भ आरेख: UDS क्लाइंट, Diagnostic Management, सर्विस कार्यान्वयन और ट्रांसफ़र सेशन्स के बीच परस्पर क्रिया। स्रोत: [SWS_DM_01317], [SWS_DM_01318], SWS_Diagnostics §7.3.2.8.20 “Service 0x38 – RequestFileTransfer”।

जीवनचक्र

FileTransferService का एक इंस्टेंस एक मॉडल किए गए ara::core::InstanceSpecifier और समवर्ती मॉडल ConcurrencyType को निर्दिष्ट करके बनाया जाता है ([SWS_DM_01325])। ConcurrencyType के माध्यम से यह निर्धारित किया जाता है कि क्लास की कॉलबैक विधियों को थ्रेड-सुरक्षित (kConcurrent) या गैर-थ्रेड-सुरक्षित (kNotConcurrent) रूप से कार्यान्वित किया जाना चाहिए ([SWS_DM_01325], [SWS_DM_01331])। एक संरक्षित एकल फ़ंक्शन के रूप में क्लास प्रतिलिपि योग्य नहीं है ([SWS_DM_01327], [SWS_DM_01329]), लेकिन मूव सिमेंटिक्स ([SWS_DM_01328], [SWS_DM_01330]) का समर्थन करती है।

इंस्टेंटिएशन के बाद, सेवा को Offer() विधि के माध्यम से स्पष्ट रूप से सक्रिय किया जाना चाहिए ताकि Diagnostic Management आने वाले अनुरोधों को अग्रेषित करे ([SWS_DM_01336])। StopOffer() के साथ किसी भी समय अग्रेषण को पुनः निष्क्रिय किया जा सकता है ([SWS_DM_01337])। व्याख्या: Diagnostic Management द्वारा लावारिस कॉलबैक एक्सेस से बचने के लिए वर्चुअल डिस्ट्रक्टर ~FileTransferService() द्वारा ऑब्जेक्ट के नष्ट होने से पहले StopOffer() को कॉल करना आवश्यक हो सकता है ([SWS_DM_01326])। प्रश्न Q-3c5c406a144ced0c (खुला) न तो Offer(), न StopOffer(), और न ही डिस्ट्रक्टर थ्रेड-सुरक्षित हैं ([SWS_DM_01326], [SWS_DM_01336], [SWS_DM_01337])।

Lebenszyklus Init आरंभीकृत नहीं Instanziiert Instanziiert (kNotOffered) Init->Instanziiert FileTransferService(...) Bereitgestellt Bereitgestellt (Offered) Instanziiert->Bereitgestellt Offer() Ende नष्ट Instanziiert->Ende ~FileTransferService() Gestoppt Gestoppt (kNotOffered) Bereitgestellt->Gestoppt StopOffer() Gestoppt->Bereitgestellt Offer() Gestoppt->Ende ~FileTransferService()

स्थिति आरेख: इंस्टेंटिएशन, प्रावधान और समाप्ति के बीच 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]) के माध्यम से सीधे हटाने के लिए लागू होते हैं।

फ़ाइल स्थानांतरण का प्रवाह (ReadFile)UDS-Clientनिदान प्रबंधनFileTransferServiceDataTransferReadSessionRequestFileTransfer (0x38, ReadFile)RequestReadFile(fileName, ...)Erzeugt ReadSessionFuture<tuple<DataTransferReadSession, FileSizes>>Positive Response (0x78 / 0x38)Use Case: डेटा ट्रांसमिशनloopजब तक डेटा ब्लॉक उपलब्ध हैंTransferData (0x36)Read(...)DatenblockTransferData Response (0x76)Use Case: AbschlussRequestTransferExit (0x37)Exit()StatusRequestTransferExit Response (0x77)

अनुक्रम आरेख: 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 पर आधारित है और स्वचालित रूप से तैयार किया गया था।

सदस्य मानचित्र

कंस्ट्रक्टर और डिस्ट्रक्टर

2

ऑपरेटर

1

एन्यूमरेशन

1

नेस्टेड टाइप

1

क्लास आरेख

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

G nara__diag__FileTransferService20 FileTransferService + ~FileTransferService() + FileTransferService() + DeleteFile() + Offer() + RequestReadDirectory() + RequestReadFile() + RequestResumeWriteFile() + RequestWriteFile() + StopOffer() + operator=()

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

कंस्ट्रक्टर और डिस्ट्रक्टर

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

एआई-जनित असत्यापित मॉडल: 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"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
fileNamePath including name of the file to read
metaInfoMetaInfo of the request.
cancellationHandlerThis 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

TypBeschreibung
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

FehlercodeBeschreibung
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#38dbf7ae
Content hash
38dbf7ae
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitthread-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)

ParameterBeschreibung
instanceSpecifierInstanceSpecifier to a PortPrototype of a DiagnosticRequestFileTransferInterface.
concurrencyTypeSpecifies 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#ca4bcdcc
Content hash
ca4bcdcc
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
Sichtbarkeitprotected

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#7a38da19
Content hash
7a38da19
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Sichtbarkeitprotected

Parameter (out)

ParameterBeschreibung
otherThe 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#0ff783de
Content hash
0ff783de
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: ae7133c89fe4 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::diag::FileTransferService का मेथड Offer हैंडलर को Diagnostic Management (DM) के साथ पंजीकृत करता है, ताकि यह फ़ाइल स्थानांतरण के लिए इनकमिंग डायग्नोस्टिक अनुरोधों को इंस्टेंस पर अग्रेषित कर सके [SWS_DM_01336]। कॉल पैरामीटर रहित और सिंक्रोनस होता है। रिटर्न प्रकार के रूप में ara::core::Result<void> कार्य करता है, जो पंजीकरण की सफलता या हुई त्रुटि का संकेत देता है [SWS_DM_01336]।

त्रुटि प्रबंधन

यदि प्रावधान के दौरान कोई त्रुटि होती है, तो फ़ंक्शन एक त्रुटिपूर्ण ara::core::Result लौटाता है। यदि संबंधित इंस्टेंस के लिए सेवा पहले से ही सफलतापूर्वक पेश की जा चुकी है, तो रोलबैक सिमेंटिक्स के साथ विशिष्ट त्रुटि कोड DiagOfferErrc::kAlreadyOffered लौटाया जाता है [SWS_DM_01336]।

समवर्तीता और प्रतिबंध

फ़ंक्शन को अपवाद-सुरक्षित (exception safe) और noexcept के रूप में घोषित किया गया है, लेकिन इसे गैर-थ्रेड-सुरक्षित (not thread-safe) माना जाता है [SWS_DM_01336]। इसलिए उसी सर्विस इंस्टेंस पर कॉल्स को समानांतर में एकाधिक थ्रेड्स से असुरक्षित रूप से निष्पादित नहीं किया जाना चाहिए।

इंटरैक्शन

Offer के माध्यम से पेश करना Adaptive AUTOSAR में डायग्नोस्टिक हैंडलर के लिए मानकीकृत परिनियोजन पैटर्न से मेल खाता है। DM द्वारा अनुरोधों के अग्रेषण के लिए समान तंत्र उदाहरण के लिए फ़ाइल डाउनलोड [SWS_DM_00792], अपलोड [SWS_DM_00802] और सामान्य UDS सेवाओं [SWS_DM_00619] के लिए मौजूद हैं।

यह उपयोग संबंधी निर्देश AUTOSAR AP R25-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "ara/diag/file_transfer.h"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

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

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_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#72206445
Content hash
72206445
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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. .

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: a6ee000cae47 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

मेथड ara::diag::FileTransferService::RequestReadDirectory को Diagnostic Server इंस्टेंस द्वारा तब कॉल किया जाता है, जब modeOfOperation ReadDir (0x05) के साथ RequestFileTransfer (0x38) के लिए एक डायग्नोस्टिक अनुरोध प्राप्त होता है [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 [SWS_DM_01332] के माध्यम से ISO 14229-1 के अनुसार एक नकारात्मक प्रतिक्रिया कोड (NRC) लौटाता है। मेथड को noexcept और अपवाद-सुरक्षित (exception safe) के रूप में निर्दिष्ट किया गया है [SWS_DM_01332]। थ्रेड सुरक्षा सशर्त है: क्या फ़ंक्शन को थ्रेड-सुरक्षित कार्यान्वित किया जाना चाहिए, यह कंस्ट्रक्टर में पास किए गए ConcurrencyType के माध्यम से निर्धारित किया जाता है [SWS_DM_01332]।

यह उपयोग निर्देश डायग्नोस्टिक मॉड्यूल के लिए AUTOSAR Adaptive Platform के विनिर्देशों पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

ParameterBeschreibung
directoryNamePath including name of the directory to read
metaInfoMetaInfo of the request.
cancellationHandlerThis 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

TypBeschreibung
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

FehlercodeBeschreibung
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#667c13b3
Content hash
667c13b3
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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;

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.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 81963250d021 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

मेथड RequestReadFile को Diagnostic Server इंस्टेंस द्वारा तब कॉल किया जाता है, जब ऑपरेशन मोड ReadFile (0x04) के साथ RequestFileTransfer (0x38) के लिए कोई डायग्नोस्टिक अनुरोध प्राप्त होता है [SWS_DM_01314]। फ़ंक्शन फ़ाइल पथ और नाम (fileName), डेटा प्रारूप (dataFormatIdentifier), अनुरोध मेटाडेटा (metaInfo) तथा एक cancellationHandler स्वीकार करता है [SWS_DM_01331]। cancellationHandler के माध्यम से रद्दीकरण स्थिति को क्वेरी किया जा सकता है (IsCanceled) या वर्तमान वार्तालाप के रद्दीकरण के लिए एक अधिसूचना फ़ंक्शन पंजीकृत किया जा सकता है (SetNotifier) [SWS_DM_01331]।

निष्पादन एसिंक्रोनस रूप से होता है और एक ara::core::Future लौटाता है। सफलता की स्थिति में, Future DataTransferReadSession और FileSizes का एक टुपल प्रदान करता है [SWS_DM_01331]। FileSizes में, uncompressed_size या compressed_size के लिए 0 का मान यह संकेत देता है कि संबंधित आकार UDS क्लाइंट को प्रेषित नहीं किया जाएगा; असंपीड़ित फ़ाइलों के लिए compressed_size को शून्य (null) पर सेट किया जाना चाहिए [SWS_DM_01331]।

त्रुटि प्रबंधन

यदि पढ़ने के ऑपरेशन की तैयारी विफल हो जाती है, तो एप्लिकेशन लौटाए गए Future में DiagUdsNrcErrc के माध्यम से ISO 14229-1 के अनुसार एक उपयुक्त UDS-NRC रिपोर्ट करता है [SWS_DM_01331]।

समवर्तीता और परस्पर क्रिया

फ़ंक्शन को noexcept के रूप में घोषित किया गया है। थ्रेड सुरक्षा सशर्त है (conditional): क्या कार्यान्वयन को थ्रेड-सुरक्षित डिज़ाइन किया जाना चाहिए, इसका निर्णय कंस्ट्रक्टर को पास किए गए ConcurrencyType [SWS_DM_01331] द्वारा किया जाता है। लौटाया गया DataTransferReadSession ऑब्जेक्ट RequestFileTransfer के प्रसंस्करण और बाद की TransferData सेवाओं (0x36) के बीच कड़ी बनता है, जिसके माध्यम से वास्तविक फ़ाइल डेटा स्ट्रीम स्थानांतरित किया जाता है SWS Diagnostics पृ. 184।

यह पाठ AUTOSAR R25-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

ParameterBeschreibung
fileNamePath including name of the file to read
dataFormatIdentifierUDS dataFormat Identifier
metaInfoMetaInfo of the request.
cancellationHandlerThis 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

TypBeschreibung
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

FehlercodeBeschreibung
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#b4fd9a30
Content hash
b4fd9a30
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 84d8dcb5e2d5 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

मेथड RequestResumeWriteFile को Diagnostic Server के एक इंस्टेंस द्वारा तब कॉल किया जाता है, जब ऑपरेटिंग मोड ResumeFile (0x06) के साथ RequestFileTransfer (0x38) के लिए एक UDS सर्विस अनुरोध प्राप्त होता है ([SWS_DM_01316], SWS Diagnostics §[SWS_DM_01316] “Realization of modeOfOperation ResumeFile (0x06)”)। इसका उद्देश्य किसी फ़ाइल के लिए पहले से बाधित लेखन प्रक्रिया को फिर से शुरू करना है।

कॉल के समय फ़ाइल पथ (fileName), UDS डेटा प्रारूप पहचानकर्ता (dataFormatIdentifier), फ़ाइल आकार (fileSizes), अनुरोध का मेटाडेटा (metaInfo) और एक cancellationHandler पास किए जाते हैं ([SWS_DM_01334], SWS Diagnostics §8.18.1.2.3.5 “RequestResumeWriteFile”)। cancellationHandler के माध्यम से, एप्लिकेशन IsCanceled का उपयोग करके सक्रिय रूप से जांच कर सकता है कि क्या चल रहा डायग्नोस्टिक वार्तालाप रद्द कर दिया गया था, या SetNotifier के माध्यम से रद्दीकरण के लिए एक अधिसूचना फ़ंक्शन पंजीकृत कर सकता है ([SWS_DM_01334])।

रिटर्न ara::core::Future<std::tuple<DataTransferWriteSession, std::uint64_t>> ([SWS_DM_01334]) के माध्यम से एसिंक्रोनस रूप से होता है। सफलता की स्थिति में, Future एक टुपल प्रदान करता है, जिसमें DataTransferWriteSession का एक इंस्टेंस और वह बाइट स्थिति शामिल होती है जिससे स्थानांतरण जारी रखा जाना चाहिए ([SWS_DM_01334])। यह सत्र ऑब्जेक्ट RequestFileTransfer के माध्यम से आरंभीकरण को बाद की TransferData सेवाओं (0x36) के साथ जोड़ता है (SWS Diagnostics §[SWS_DM_01316] “Realization of modeOfOperation ResumeFile (0x06)”)।

त्रुटि की स्थिति में, Future को DiagUdsNrcErrc के माध्यम से ISO 14229-1 के अनुसार एक उपयुक्त UDS-NRC के साथ समाप्त किया जाना चाहिए ([SWS_DM_01334])। फ़ंक्शन को noexcept के रूप में घोषित किया गया है और यह अपवाद-सुरक्षित है; थ्रेड सुरक्षा सशर्त ("conditional") है और कंस्ट्रक्टर में पास किए गए ConcurrencyType द्वारा निर्धारित की जाती है ([SWS_DM_01334])।

यह पाठ एक AI द्वारा तैयार किया गया था और विशेष रूप से AUTOSAR Adaptive प्लेटफॉर्म R25-11 के विनिर्देशों पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

ParameterBeschreibung
fileNamePath including name of the file to read
dataFormatIdentifierUDS dataFormat Identifier
fileSizesThe compressed/uncompressed files sizes
metaInfoMetaInfo of the request.
cancellationHandlerThis 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

TypBeschreibung
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

FehlercodeBeschreibung
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#a6ef9a99
Content hash
a6ef9a99
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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.

एआई-जनित असत्यापित मॉडल: 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 में ISO 14229-1 के अनुसार DiagUdsNrcErrc से एक उपयुक्त UDS-NRC लौटाया जाता है ([SWS_DM_01333])। पास किए गए cancellationHandler के माध्यम से, IsCanceled() का उपयोग करके रद्दीकरण स्थिति को क्वेरी किया जा सकता है या SetNotifier() के साथ एक अधिसूचना पंजीकृत की जा सकती है यदि डायग्नोस्टिक वार्तालाप बाधित हो जाता है। थ्रेड सुरक्षा सशर्त है: क्या फ़ंक्शन को थ्रेड-सुरक्षित कार्यान्वित किया जाना चाहिए, यह कंस्ट्रक्टर में ConcurrencyType के माध्यम से निर्धारित किया जाता है ([SWS_DM_01333])।

इंटरैक्शन

ऑपरेशन फ़ाइल स्थानांतरण सेवाओं के इंटरैक्शन को पूरा करता है और RequestReadFile ([SWS_DM_01314]) जैसे पढ़ने के ऑपरेशनों या RequestResumeWriteFile ([SWS_DM_01316]) के माध्यम से बाधित राइट प्रक्रियाओं को फिर से शुरू करने का पूरक है।

यह उपयोग निर्देश विनिर्देश स्थिति के आधार पर स्वचालित रूप से उत्पन्न किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

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

Parameter (in)

ParameterBeschreibung
fileNamePath including name of the file to read
dataFormatIdentifierUDS dataFormat Identifier
fileSizesThe compressed/uncompressed files sizes
modeThe file replacement mode
metaInfoMetaInfo of the request.
cancellationHandlerThis 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

TypBeschreibung
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

FehlercodeBeschreibung
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#b4c05de9
Content hash
b4c05de9
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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.

एआई-जनित असत्यापित मॉडल: 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”) से सेवा को अपंजीकृत (unregister) करने का कार्य करता है। इसके कॉल का प्रभाव यह होता है कि 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"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
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#f981dae6
Content hash
f981dae6
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
Sichtbarkeitprotected

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#00bc07a7
Content hash
00bc07a7
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe
Sichtbarkeitprotected

Parameter (out)

ParameterBeschreibung
otherThe other object

Rückgabewert

TypBeschreibung
FileTransferServiceReference 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#2021bc7c
Content hash
2021bc7c
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
Exception-Sicherheitexception safe
Thread-Sicherheitnot 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#21e25df3
Content hash
21e25df3
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::FileTransferService
SymbolWriteFileMode
Basistypara::core::Byte

Werte

EnumeratorBeschreibung
kAddThe file shall be added only if not existing.
kReplaceThe 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#36decc33
Content hash
36decc33
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
Point-in-Time History:
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
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill