فئة ara::diag::FileTransferService

[SWS_DM_01320] Upstream: RS_Diag_04135

class FileTransferService {...};

File Transfer service interface.

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

دليل المستخدممولَّد بالذكاء الاصطناعي

يتيح للتطبيقات التكيفية توفير عمليات الملفات والأدلة لخدمات تشخيص UDS.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 50ca3b00d3d3 المصدر أسئلة مفتوحة (2)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتيح للتطبيقات التكيفية توفير عمليات الملفات والأدلة لخدمات تشخيص UDS.

تُستخدم واجهة الخدمة لربط عمليات نقل الملفات الخاصة بالتطبيق بـ Diagnostic Management لخدمة UDS المعنية RequestFileTransfer ([SWS_DM_01320]، SWS_Diagnostics §7.3.2.8.20 «Service 0x38 – RequestFileTransfer»). وبعد إنشاء النسخة، يُفعل التطبيق إعادة توجيه طلبات الملفات الواردة باستخدام Offer() ويعالج عمليات الملفات مثل القراءة أو الكتابة أو الحذف بشكل غير متزامن عبر توابع معالجة متخصصة ([SWS_DM_01336]). وفي عمليات القراءة والكتابة، توفر الخدمة كائنات جلسة يُجرى من خلالها نقل البيانات الفعلي. ونسخ هذه الفئة غير قابلة للنسخ وتتطلب ربطًا ثابتًا عبر محدد نسخة.

السياق

تُعرّف الفئة ara::diag::FileTransferService واجهة التشخيص لتنفيذ خدمة UDS المعنية RequestFileTransfer (0x38) في AUTOSAR Adaptive Platform ([SWS_DM_01320]، SWS_Diagnostics §7.3.2.8.20 «Service 0x38 – RequestFileTransfer»). وتعمل كـ ServiceInterface بين Diagnostic Management (DM أو Diagnostic Server) وتطبيق التشخيص الفعلي للتعامل بمرونة مع قراءة الملفات أو الأدلة وكتابتها واستئنافها وحذفها عبر حدود العمليات (SWS_Diagnostics §7.3.2.8.20 «Service 0x38 – RequestFileTransfer»).

تشارك عادة ثلاثة أطراف في سيناريو نقل الملفات: عميل UDS الخارجي (فاحص التشخيص)، وDiagnostic Server كوسيط، والتطبيق التكيفي الذي يرث من FileTransferService. وعند ورود طلبات التشخيص، يفوض Diagnostic Server الطلب إلى الدوال الافتراضية المنفذة في الخدمة ([SWS_DM_01313]، [SWS_DM_01314]). ولعمليات نقل البيانات اللاحقة (UDS 0x36 TransferData) والإنهاء (UDS 0x37 RequestTransferExit)، يرجع Diagnostic Management مباشرة إلى فئات معالجة متوفرة عبر كائنات جلسة (DataTransferReadSession أو DataTransferWriteSession) ([SWS_DM_01317]، [SWS_DM_01318]).

مخطط السياق: التفاعل بين عميل UDS، وDiagnostic Management، وتنفيذ الخدمة، وجلسات النقل. المصادر: [SWS_DM_01317]، [SWS_DM_01318]، SWS_Diagnostics §7.3.2.8.20 «Service 0x38 – RequestFileTransfer».

دورة الحياة

يتم إنشاء نسخة من FileTransferService بتحديد ara::core::InstanceSpecifier منمذج ونموذج التزامن ConcurrencyType ([SWS_DM_01325]). ويحدد ConcurrencyType ما إذا كان يجب تنفيذ توابع رد الاتصال للفئة لتكون آمنة خيطيًا (kConcurrent) أو غير آمنة خيطيًا (kNotConcurrent) ([SWS_DM_01325]، [SWS_DM_01331]). وباعتبارها وظيفة مفردة محمية، فإن الفئة غير قابلة للنسخ ([SWS_DM_01327]، [SWS_DM_01329])، لكنها تدعم دلالات النقل ([SWS_DM_01328]، [SWS_DM_01330]).

بعد إنشاء النسخة، يجب تفعيل الخدمة صراحةً عبر التابع Offer() حتى يقوم Diagnostic Management بإعادة توجيه الطلبات الواردة ([SWS_DM_01336]). وباستخدام StopOffer()، يمكن إلغاء تفعيل إعادة التوجيه في أي وقت ([SWS_DM_01337]). تفسير: يُرجح أنه من الضروري استدعاء StopOffer() قبل تدمير الكائن بواسطة المدمّر الافتراضي ~FileTransferService() ([SWS_DM_01326])، وذلك لتجنب عمليات وصول معلقة لردود اتصال Diagnostic Management. سؤال Q-3c5c406a144ced0c (مفتوح) وليست أي من Offer() أو StopOffer() أو المدمّر آمنة خيطيًا ([SWS_DM_01326]، [SWS_DM_01336]، [SWS_DM_01337]).

مخطط الحالة: انتقالات حالة نسخة FileTransferService بين إنشاء النسخة والإتاحة والإنهاء. المصادر: [SWS_DM_01325]، [SWS_DM_01336]، [SWS_DM_01337]، [SWS_DM_01326].

مسار الاستخدام

ينقسم المسار النموذجي لعملية ملف إلى التهيئة، وإطلاق العملية، ونقل الكتل اللاحق. أولاً، يعيد Diagnostic Management توجيه الاستدعاء عند استلام طلب UDS 0x38 بالنمط ReadFile (0x04) إلى 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 بعد ذلك مباشرة التابع Read للمعالج المسجل لـ DataTransferReadSession ([SWS_DM_01317]). بمجرد نقل جميع الكتل، ينهي العميل المعاملة بـ RequestTransferExit (0x37)، حيث يستدعي Diagnostic Server التابع Exit للمعالج ([SWS_DM_01318]). وتطبق أنماط مماثلة للكتابة عبر RequestWriteFile ([SWS_DM_01313]، [SWS_DM_01333]) بالنمط WriteFileMode ([SWS_DM_01324])، والاستئناف عبر RequestResumeWriteFile ([SWS_DM_01316]، [SWS_DM_01334])، وقراءة الأدلة عبر RequestReadDirectory ([SWS_DM_01315]، [SWS_DM_01332])، أو الحذف المباشر عبر DeleteFile ([SWS_DM_01335]).

مخطط تسلسلي: مسار عملية قراءة عبر UDS 0x38 و0x36 و0x37. المصادر: [SWS_DM_01314]، [SWS_DM_01317]، [SWS_DM_01318]، [SWS_DM_01331].

سيناريوهات الأخطاء

قد تحدث أخطاء في مراحل متعددة:

انتهاكات البناء: إذا فشل حل InstanceSpecifier أو تعيينه، تظهر أخطاء نمذجة مثل InstanceSpecifierMappingIntegrityViolation، PortInterfaceMappingViolation، ProcessMappingViolation أو InstanceSpecifierAlreadyInUseViolation ([SWS_DM_01325]).
أخطاء التفعيل: يؤدي الاستدعاء المتكرر لـ Offer() أثناء كون الخدمة نشطة بالفعل إلى إرجاع الخطأ DiagOfferErrc::kAlreadyOffered ([SWS_DM_01336]).
رموز أخطاء التشخيص (NRC): إذا تعذر تنفيذ عملية بنجاح، تُرجع توابع رد الاتصال في ara::core::Future رمز استجابة UDS سلبيًا ملائمًا (NRC وفقًا للمواصفة ISO 14229-1) عبر DiagUdsNrcErrc ([SWS_DM_01331]، [SWS_DM_01333]، [SWS_DM_01335]).
معالجة الإلغاء: عبر الكائن CancellationHandler المُمرَّر، يمكن للتطبيق التحقق باستخدام IsCanceled مما إذا كانت المحادثة قد أُلغيت، أو تسجيل دالة إشعار للإلغاءات غير المتزامنة عبر SetNotifier ([SWS_DM_01331]، [SWS_DM_01335]).

يعتمد هذا الدليل حصريًا على مواصفة AUTOSAR بالنسخة R25-11 وقد أُنشئ آليًا.

خريطة الأعضاء

مخطط الفئة

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

عرض التفاصيل

اختر عنصرًا من المخطط.

لا توجد بيانات عناصر لهذا الإصدار

المُنشئات والمُتلف

FileTransferService دالة 3

Constructor for FileTransferService (inherited)

التحميلات الزائدة FileTransferService 3

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

FileTransferService (FileTransferService const &)=delete; SWS_DM_01327

FileTransferService (FileTransferService &&other) noexcept; SWS_DM_01328

~FileTransferService دالة

Destructor of class FileTransferService.

virtual ~FileTransferService () noexcept;

الدوال الأعضاء

DeleteFile دالة

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

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

Offer دالة

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

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

RequestReadDirectory دالة

Called for RequestFileTransfer with ModeOfOperation ReadDir. .

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

RequestReadFile دالة

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

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

RequestResumeWriteFile دالة

Called for RequestFileTransfer with ModeOfOperation ResumeFile.

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

RequestWriteFile دالة

Called for RequestFileTransfer with ModeOfOperation WriteFile.

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

StopOffer دالة

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

void StopOffer () const noexcept;

المعاملات

operator= دالة 2

FileTransferService shall be a single not assignable instance.

التحميلات الزائدة = 2

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

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

التعدادات

WriteFileMode تعداد

Determines the write file operation mode.

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

الأنواع المضمنة

FileSizes فئة

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الفئةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل صفحة الفئة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.جديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

توثيق الدوال

دالة 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 · الأصل الألماني

تتولى الطريقة DeleteFile من الفئة ara::diag::FileTransferService (SWS Diagnostics §8.18.1.2.3.1 «DeleteFile»، ملف الترويسة #include "ara/diag/file_transfer.h") معالجة عملية الحذف الكامل لملف في إطار خدمة UDS RequestFileTransfer (0x38) بالوضع DeleteFile [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]. يشير الإكمال الناجح لعميل التشخيص إلى سلوك استجابة إيجابي. وفي حالة الخطأ، يجب توفير UDS-NRC ملائم وفقًا للمعيار ISO 14229-1 عبر DiagUdsNrcErrc في Future [SWS_DM_01335].

تم تحديد الدالة على أنها noexcept وتُعد آمنة من الاستثناءات («exception safe») [SWS_DM_01335]. متطلب أمان مؤشرات الترابط مشروط ويتم التحكم فيه عبر ConcurrencyType الممرر إلى الدالة الإنشائية [SWS_DM_01335].

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

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

Parameter (in)

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

Rückgabewert

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

Fehler

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#8332cd052026-09-30
R22-11rel:R22-11#36673d0f2026-10-14
R23-11rel:R23-11#73618cf32026-10-14
R24-11rel:R24-11#1c7c75ef2026-10-14
R25-11rel:R25-11#5a76fff52026-10-14 active

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

دالة FileTransferService [SWS_DM_01325] Upstream: RS_Diag_04135, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

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

Constructor for FileTransferService (inherited)

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

Parameter (in)

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#52de53342026-09-30
R22-11rel:R22-11#8dbc776b2026-10-14
R23-11rel:R23-11#f58df40e2026-10-14
R24-11rel:R24-11#724c28ee2026-10-14
R25-11rel:R25-11#a08ef1982026-10-14 active

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

دالة FileTransferService [SWS_DM_01327] Upstream: RS_Diag_04135

FileTransferService (FileTransferService const &)=delete;

FileTransferService shall be a single not copy-able instance.

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#8b4a360b2026-09-30
R22-11rel:R22-11#685998602026-10-14
R23-11rel:R23-11#bfbeeb2e2026-10-14
R24-11rel:R24-11#d1dbc6e22026-10-14
R25-11rel:R25-11#1ed01f5a2026-10-14 active

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

دالة FileTransferService [SWS_DM_01328] Upstream: RS_Diag_04135

FileTransferService (FileTransferService &&other) noexcept;

Move constructs an instance of FileTransferService.

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

Parameter (out)

Parameter	Beschreibung
other	The other object

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#a64a8dae2026-09-30
R22-11rel:R22-11#2f0b9de52026-10-14
R23-11rel:R23-11#ebd249b42026-10-14
R24-11rel:R24-11#c90d4b792026-10-14
R25-11rel:R25-11#1bdc5a9f2026-10-14 active

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

دالة Offer [SWS_DM_01336] Upstream: RS_Diag_04135

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

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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ae7133c89fe4 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تسجل الطريقة Offer من الفئة ara::diag::FileTransferService المعالج لدى Diagnostic Management (DM)، حتى يتمكن الأخير من إعادة توجيه طلبات التشخيص الواردة لنقل الملفات إلى المثيل [SWS_DM_01336]. يتم الاستدعاء بدون معلمات وبشكل متزامن. ويُستخدم ara::core::Result<void> كنوع إرجاع، للإشارة إلى نجاح التسجيل أو حدوث خطأ [SWS_DM_01336].

معالجة الأخطاء

إذا حدث خطأ أثناء توفير الخدمة، تُرجع الدالة ara::core::Result يحتوي على خطأ. وإذا كانت الخدمة قد عُرضت بنجاح بالفعل للمثيل المعني من قبل، يتم إرجاع كود الخطأ المحدد DiagOfferErrc::kAlreadyOffered مع دلالات التراجع (rollback) [SWS_DM_01336].

التزامن والقيود

تم التصريح عن الدالة على أنها آمنة من الاستثناءات (exception safe) وnoexcept، ولكنها تُعتبر غير آمنة لمؤشرات الترابط (not thread-safe) [SWS_DM_01336]. لذلك، لا يجوز تنفيذ الاستدعاءات على نفس مثيل الخدمة بشكل متوازٍ من مؤشرات ترابط متعددة بدون حماية.

تفاعل

يتوافق العرض عبر Offer مع نمط التوفير الموحد لمعالجات التشخيص في Adaptive AUTOSAR. وتوجد آليات مماثلة لإعادة توجيه الطلبات بواسطة DM، على سبيل المثال، لتنزيل الملفات [SWS_DM_00792]، والرفع [SWS_DM_00802]، بالإضافة إلى خدمات UDS العامة [SWS_DM_00619].

تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR AP R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

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

Rückgabewert

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

Fehler

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#f8bdc8172026-09-30
R22-11rel:R22-11#980deda22026-10-14
R23-11rel:R23-11#429134002026-10-14
R24-11rel:R24-11#2a2a4d772026-10-14
R25-11rel:R25-11#780b487b2026-10-14 active

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

دالة RequestReadDirectory [SWS_DM_01332] Upstream: RS_Diag_04135

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

Called for RequestFileTransfer with ModeOfOperation ReadDir. .

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: a6ee000cae47 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتم استدعاء الطريقة ara::diag::FileTransferService::RequestReadDirectory بواسطة مثيل خادم التشخيص عندما يتم استلام طلب تشخيص لـ RequestFileTransfer (0x38) مع modeOfOperation ReadDir (0x05) [SWS_DM_01315]. تستقبل الدالة المعلمات التالية [SWS_DM_01332]:

directoryName: المسار متضمنًا اسم الدليل المراد قراءته.
metaInfo: المعلومات الوصفية لطلب التشخيص الوارد.
cancellationHandler: كائن للاستعلام عن إلغاء المحادثة عبر cancellationHandler.IsCanceled() أو لتسجيل دالة رد نداء (callback) عبر cancellationHandler.SetNotifier() لأحداث الإلغاء.

يتم الإرجاع بشكل غير متزامن عبر ara::core::Future<std::tuple<DataTransferReadSession, std::uint64_t>> [SWS_DM_01332]. وفي حالة النجاح، يحتوي الصف (tuple) على استراتيجية الوصول DataTransferReadSession بالإضافة إلى حجم الدليل الذي يُنقل إلى عميل UDS [SWS_DM_01332]. وينشئ الكائن DataTransferReadSession الربط بين التهيئة عبر RequestFileTransfer (0x38) وعمليات نقل الملفات اللاحقة عبر TransferData (0x36) SWS Diagnostics ص. 184 «Realization of modeOfOperation ReadDir (0x05)».

إذا فشلت المعالجة، يُرجع Future كود استجابة سلبيًا (NRC) وفقًا للمعيار ISO 14229-1 عبر DiagUdsNrcErrc [SWS_DM_01332]. تم تحديد الطريقة على أنها noexcept وآمنة من الاستثناءات (exception safe) [SWS_DM_01332]. أمان مؤشرات الترابط مشروط: يتم تحديد ما إذا كان يجب تنفيذ الدالة كآمنة لمؤشرات الترابط عبر ConcurrencyType الممرر في الدالة الإنشائية [SWS_DM_01332].

تستند ملاحظة الاستخدام هذه إلى مواصفات AUTOSAR Adaptive Platform لوحدة التشخيص.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

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

Parameter (in)

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

Rückgabewert

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

Fehler

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#bfc5a2d72026-09-30
R22-11rel:R22-11#de5ccbca2026-10-14
R23-11rel:R23-11#6a311b002026-10-14
R24-11rel:R24-11#68f15ec32026-10-14
R25-11rel:R25-11#58fefe542026-10-14 active

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

دالة RequestReadFile [SWS_DM_01331] Upstream: RS_Diag_04135

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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 81963250d021 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

يتم استدعاء الطريقة RequestReadFile بواسطة مثيل Diagnostic Server بمجرد ورود طلب تشخيص لـ RequestFileTransfer (0x38) مع وضع التشغيل ReadFile (0x04) [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، تُشير القيمة 0 لـ uncompressed_size أو compressed_size إلى أن الحجم المعني لا يتم نقله إلى عميل UDS؛ وفي حالة الملفات غير المضغوطة، يجب تعيين compressed_size إلى null [SWS_DM_01331].

معالجة الأخطاء

إذا فشل إعداد عملية القراءة، يُبلغ التطبيق عن UDS-NRC مناسب وفقًا للمعيار ISO 14229-1 عبر DiagUdsNrcErrc في كائن Future المرتجع [SWS_DM_01331].

التزامن والتفاعل

تم الإعلان عن الدالة على أنها noexcept. وأمان خيوط المعالجة مشروط (conditional): إذ يحدد ConcurrencyType الممرر إلى المُنشئ ما إذا كان يجب تصميم التنفيذ ليكون آمنًا لخيوط المعالجة [SWS_DM_01331]. ويشكل كائن DataTransferReadSession المرتجع حلقة الوصل بين معالجة RequestFileTransfer وخدمات TransferData اللاحقة (0x36)، والتي يتم عبرها نقل دفق بيانات الملف الفعلي SWS Diagnostics ص. 184.

تم توليد هذا النص بواسطة ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

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

Parameter (in)

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

Rückgabewert

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

Fehler

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#de746ccd2026-09-30
R22-11rel:R22-11#014f2e682026-10-14
R23-11rel:R23-11#e48290792026-10-14
R24-11rel:R24-11#40bb50212026-10-14
R25-11rel:R25-11#2da4b6c52026-10-14 active

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

دالة RequestResumeWriteFile [SWS_DM_01334] Upstream: RS_Diag_04135

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

Called for RequestFileTransfer with ModeOfOperation ResumeFile.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 84d8dcb5e2d5 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يتم استدعاء الطريقة RequestResumeWriteFile بواسطة مثيل لخادم التشخيص عند استلام طلب خدمة UDS لـ RequestFileTransfer (0x38) بوضع التشغيل ResumeFile (0x06) ([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 صفًا (tuple) يحتوي على مثيل لـ DataTransferWriteSession بالإضافة إلى موضع البايت الذي يجب متابعة النقل منه ([SWS_DM_01334]). يربط كائن الجلسة هذا التهيئة عبر RequestFileTransfer بخدمات TransferData اللاحقة (0x36) (SWS Diagnostics §[SWS_DM_01316] «Realization of modeOfOperation ResumeFile (0x06)»).

في حالة الخطأ، يجب إنهاء الـ Future باستخدام UDS-NRC مناسب وفقًا للمعيار ISO 14229-1 عبر DiagUdsNrcErrc ([SWS_DM_01334]). الدالة مصرح عنها كـ noexcept وآمنة من الاستثناءات؛ وأمان مؤشرات الترابط مشروط («conditional») ويتم تحديده بواسطة ConcurrencyType الممرر في الدالة الإنشائية ([SWS_DM_01334]).

تم تنظيم هذا النص بواسطة ذكاء اصطناعي ويستند حصريًا إلى مواصفات AUTOSAR Adaptive Platform R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

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

Parameter (in)

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

Rückgabewert

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

Fehler

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#89c39f932026-09-30
R22-11rel:R22-11#8fe1f4b12026-10-14
R23-11rel:R23-11#42daa99b2026-10-14
R24-11rel:R24-11#56b464b02026-10-14
R25-11rel:R25-11#f5ac33f72026-10-14 active

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

دالة RequestWriteFile [SWS_DM_01333] Upstream: RS_Diag_04135

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

Called for RequestFileTransfer with ModeOfOperation WriteFile.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d68fe452ba36 المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

يستدعي خادم التشخيص الطريقة [SWS_DM_01333] بمجرد استلام طلب خدمة UDS من نوع RequestFileTransfer (0x38) بوضع التشغيل WriteFile ([SWS_DM_01310]). وإذا تم إرسال الطلب بوضع التشغيل ReplaceFile (0x03)، يستدعي خادم التشخيص الواجهة بوضع الكتابة kReplace ([SWS_DM_01313]). يمرر الاستدعاء اسم الملف (fileName)، ومُعرّف تنسيق البيانات (dataFormatIdentifier)، وأحجام الملفات (fileSizes)، ووضع الاستبدال (mode)، وبيانات وصفية إضافية (metaInfo)، بالإضافة إلى cancellationHandler. ويُرجح أن تكون عبارة المواصفات «file to read» عند المعلمة fileName خطأً تحريريًا وتشير إلى المسار الهدف للملف المراد كتابته. سؤال 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++، بل يتم إرجاع UDS-NRC مطابق من DiagUdsNrcErrc وفقًا للمعيار ISO 14229-1 في الـ Future ([SWS_DM_01333]). وعبر cancellationHandler الممرر، يمكن الاستعلام عن حالة الإلغاء باستخدام IsCanceled() أو تسجيل إشعار باستخدام SetNotifier() في حالة انقطاع محادثة التشخيص. أمان مؤشرات الترابط مشروط: يتم تحديد ما إذا كان يجب تنفيذ الدالة كآمنة لمؤشرات الترابط عبر ConcurrencyType في الدالة الإنشائية ([SWS_DM_01333]).

تفاعل

تُكمل العملية التفاعل التبادلي لخدمات نقل الملفات وتُعد مكملة لعمليات القراءة مثل RequestReadFile ([SWS_DM_01314]) أو استئناف عمليات الكتابة المقاطعة عبر RequestResumeWriteFile ([SWS_DM_01316]).

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى حالة المواصفات.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

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

Parameter (in)

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

Rückgabewert

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

Fehler

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#c3df13832026-09-30
R22-11rel:R22-11#70b47e362026-10-14
R23-11rel:R23-11#5d904ef32026-10-14
R24-11rel:R24-11#27f280b82026-10-14
R25-11rel:R25-11#51c3d98c2026-10-14 active

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

دالة StopOffer [SWS_DM_01337] Upstream: RS_Diag_04135

void StopOffer () const noexcept;

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

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b1eec837af18 المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُستخدم الدالة StopOffer من الفئة ara::diag::FileTransferService لإلغاء تسجيل الخدمة لدى Diagnostic Management ([SWS_DM_01337]؛ AUTOSAR_AP_SWS_Diagnostics §8.18.1.2.3.7 «StopOffer»). ويؤدي استدعاؤها إلى توقف DM عن إعادة توجيه طلبات التشخيص الواردة إلى مثيل الخدمة هذا بدءًا من تلك اللحظة. الواجهة محددة في ملف الترويسة #include "ara/diag/file_transfer.h"، ولها التوقيع void StopOffer() const noexcept;، ولا تتوقع أي معلمات ولا تُرجع أي قيمة. يتم تنفيذ الاستدعاء بشكل متزامن.

لم يتم توفير أي آلية خطأ لـ StopOffer. الطريقة مصرح عنها على أنها آمنة من الاستثناءات (exception safe) وبالمُعرّف noexcept ([SWS_DM_01337]). لا يتم إطلاق استثناءات ولا إرجاع أكواد أخطاء إلى التطبيق. ولا تفشل عملية تعطيل إعادة التوجيه من منظور API.

وفقًا للمواصفات، تم تصنيف StopOffer على أنها غير آمنة لمؤشرات الترابط (not thread-safe) ([SWS_DM_01337]). لذلك، يجب حماية عمليات الوصول المتزامنة إلى نفس المثيل من ara::diag::FileTransferService ضد التزامن من جانب التطبيق. تفسير: يُرجح أن يحدث التعطيل نمطيًا قبل تدمير الكائن أو أثناء الإيقاف المنظم للتطبيق المعالج، حتى لا تذهب الطلبات إلى روتين لم يعد جاهزًا للعمل. سؤال Q-e7bb2a5621c39160 (مفتوح)

يتبع التعطيل عبر StopOffer النمط المعماري الموحد لـ AUTOSAR Adaptive لخدمات التشخيص المقدمة. وهو يتوافق مع دوال تعطيل مماثلة لفئات ذات صلة مثل ara::diag::DownloadService ([SWS_DM_00793])، وara::diag::UploadService ([SWS_DM_00803])، وara::diag::CommunicationControl ([SWS_DM_00810])، وara::diag::Monitor ([SWS_DM_01089]؛ AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors»).

تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفات.

دليل المنفِّذ قيد الإعداد (التعقيد 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#bbb73358
Content hash: bbb73358
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01337

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

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

Recorded Revisions (5):

R25-11rel:R25-11#a8ae9f322026-09-30
R22-11rel:R22-11#654bd0092026-10-14
R23-11rel:R23-11#f129c87f2026-10-14
R24-11rel:R24-11#70a7f50e2026-10-14
R25-11rel:R25-11#70a7f50e2026-10-14 active

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

دالة operator= [SWS_DM_01329] Upstream: RS_Diag_04135

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

FileTransferService shall be a single not assignable instance.

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#b87225482026-09-30
R22-11rel:R22-11#718170092026-10-14
R23-11rel:R23-11#5215d06f2026-10-14
R24-11rel:R24-11#1ea288352026-10-14
R25-11rel:R25-11#1ea288352026-10-14 active

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

دالة operator= [SWS_DM_01330] Upstream: RS_Diag_04135

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

Move assigns an instance of FileTransferService.

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

Parameter (out)

Parameter	Beschreibung
other	The other object

Rückgabewert

Typ	Beschreibung
FileTransferService	Reference to self

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#dc10e40b2026-09-30
R22-11rel:R22-11#2eaabf332026-10-14
R23-11rel:R23-11#2e1bc2e32026-10-14
R24-11rel:R24-11#275db4722026-10-14
R25-11rel:R25-11#3d2ac0df2026-10-14 active

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

دالة ~FileTransferService [SWS_DM_01326] Upstream: RS_Diag_04135

virtual ~FileTransferService () noexcept;

Destructor of class FileTransferService.

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#838a47062026-09-30
R22-11rel:R22-11#34fabb372026-10-14
R23-11rel:R23-11#0e9f351d2026-10-14
R24-11rel:R24-11#8e0522c62026-10-14
R25-11rel:R25-11#8e0522c62026-10-14 active

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

توثيق التعدادات

تعداد WriteFileMode [SWS_DM_01324] Upstream: RS_Diag_04135

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

Determines the write file operation mode.

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

Werte

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

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

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

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

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

Recorded Revisions (5):

R25-11rel:R25-11#5ddcfb102026-09-30
R22-11rel:R22-11#50d44c362026-10-14
R23-11rel:R23-11#0e3c6f352026-10-14
R24-11rel:R24-11#0e3c6f352026-10-14
R25-11rel:R25-11#ccf1739f2026-10-14 active

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

فئة ara::diag::FileTransferService

دليل المستخدممولَّد بالذكاء الاصطناعي

السياق

دورة الحياة

مسار الاستخدام

سيناريوهات الأخطاء

خريطة الأعضاء

المُنشئات والمُتلف

الدوال الأعضاء

المعاملات

التعدادات

الأنواع المضمنة

مخطط الفئة

عرض التفاصيل

المُنشئات والمُتلف

الدوال الأعضاء

المعاملات

التعدادات

الأنواع المضمنة

توثيق الدوال

دالة DeleteFile [SWS_DM_01335] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة FileTransferService [SWS_DM_01325] Upstream: RS_Diag_04135, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

Parameter (in)

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة FileTransferService [SWS_DM_01327] Upstream: RS_Diag_04135

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة FileTransferService [SWS_DM_01328] Upstream: RS_Diag_04135

Parameter (out)

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Offer [SWS_DM_01336] Upstream: RS_Diag_04135

الاستخدام

معالجة الأخطاء

التزامن والقيود

تفاعل

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة RequestReadDirectory [SWS_DM_01332] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة RequestReadFile [SWS_DM_01331] Upstream: RS_Diag_04135

الاستخدام

معالجة الأخطاء

التزامن والتفاعل

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة RequestResumeWriteFile [SWS_DM_01334] Upstream: RS_Diag_04135

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (5):