فئة ara::diag::SovdSwUpdate

[SWS_DM_01874] Upstream: RS_Diag_04265

class SovdSwUpdate {...};

Class to implement the SovdSwUpdate interface.

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

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

تعمل كواجهة لتنفيذ تحديثات البرمجيات عبر بروتوكول ASAM SOVD في خادم تشخيص AUTOSAR.

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

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

تعمل كواجهة لتنفيذ تحديثات البرمجيات عبر بروتوكول ASAM SOVD في خادم تشخيص AUTOSAR.

توفر الفئة واجهة من جهة التطبيق لتنفيذ تحديثات البرمجيات القياسية عبر بروتوكول SOVD وفقاً لـ ASAM SOVD [SWS_DM_01796]. بعد إنشاء النسخة، ينشط التطبيق إعادة توجيه طلبات التشخيص إلى معالجات التحديث المحددة عبر الدالة Offer() [SWS_DM_01924]. وتُسجل الحزم وتُجهز وتُثبت آلياً أو يدوياً وتُحذف مجدداً عبر دوال غير متزامنة. وتتم معالجة كافة العمليات ذات الصلة بنقل البيانات ودورة الحياة بشكل غير حاجب عبر كائنات Futures.

السياق

تحدد الفئة ara::diag::SovdSwUpdate الواجهة لتنفيذ تحديثات البرمجيات القياسية وفقاً لـ ASAM SOVD ضمن AUTOSAR Adaptive Platform [SWS_DM_01874]. ونظراً لأن منطق العمل الفعلي لتحديثات البرمجيات لا يقع ضمن الكتلة الوظيفية Diagnostic Management (DM)، فإن التنفيذ يظل من مسؤولية التطبيق المعني، بينما يركز ara::diag::SovdSwUpdate على المعالجة المتوافقة مع المعايير لبروتوكول SOVD الأساسي AUTOSAR_AP_SWS_Diagnostics §7.4 «SOVD Software Update API - concept». وتُستخدم لتحميل ملفات التحديث استراتيجيات نقل كالتي تم تحديدها لخدمة UDS ذات الرمز 0x38 (RequestFileTransfer) AUTOSAR_AP_SWS_Diagnostics §7.4 «SOVD Software Update API - concept»، [SWS_DM_01923].

تشترك ثلاثة مكونات رئيسية في العمليات: عميل SOVD الخارجي، ونسخة خادم التشخيص (DM) لإدارة البروتوكول والمسارات، وتنفيذ المعالج الخاص بالتطبيق لـ ara::diag::SovdSwUpdate [SWS_DM_01796]، [SWS_DM_01924].

مخطط السياق: التفاعل بين عميل SOVD وخادم التشخيص (DM) وara::diag::SovdSwUpdate. المصادر: [SWS_DM_01796]، [SWS_DM_01924]، AUTOSAR_AP_SWS_Diagnostics §7.4 «SOVD Software Update API - concept»

دورة الحياة

يتم إنشاء نسخة من ara::diag::SovdSwUpdate عبر المنشئ مع تحديد ara::core::InstanceSpecifier يشير إلى نموذج أولي لمنفذ تابع لـ DiagnosticSovdUpdateInterface مُصمَّم، بالإضافة إلى نمط التزامن (ConcurrencyType: kConcurrent أو kNotConcurrent) [SWS_DM_01910]. المنشئ محدد ليكون آمناً خيطياً وآمناً من حيث الاستثناءات [SWS_DM_01910]. وباعتباره ممثلاً لنسخة واجهة فريدة، فإن منشئ النسخ ومعامل إسناد النسخ محذوفان (=delete) ومحميان [SWS_DM_01912]، [SWS_DM_01914]. ويتوفر منشئ النقل وإسناد النقل بشكل محمي، إلا أنهما ليسا آمنين خيطياً [SWS_DM_01913]، [SWS_DM_01915].

تتم معالجة تدمير الكائن عبر المُدمّر الافتراضي ~SovdSwUpdate()، والذي يعتبر غير آمن خيطياً [SWS_DM_01911]. ويعتمد ما إذا كان يجب تنفيذ دوال رد الاتصال الافتراضية للفئة بالتوازي بشكل مباشر على ConcurrencyType المُمرَّر إلى المنشئ [SWS_DM_01910]، [SWS_DM_01916].

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

تفسير: نظراً لأن دوال الواجهة المتوفرة مصرح عنها كدوال افتراضية بحتة (=0)، يُفترض أن تقوم فئة تطبيق مشتقة بتنفيذها لإجراء التنفيذ الفعلي للتحديث، بينما تنظم الفئة الأساسية الارتباط بالمنصة. سؤال Q-10500d9fc58503ea (مفتوح)

ينقسم المسار المنتظم إلى المراحل التالية:

الإتاحة: بعد إنشاء الكائن، يستدعي التطبيق Offer() لتمكين Diagnostic Management من إعادة توجيه رسائل SOVD الواردة إلى هذه النسخة [SWS_DM_01924].
الاستعلام والتسجيل: يمكن الاستعلام عن حزم التحديثات المتوفرة عبر GetAllUpdates() [SWS_DM_01797]، [SWS_DM_01916]. وإذا كان يتعين نقل حزمة جديدة، يطلب خادم التشخيص عبر RequestUpdatePackageRegistration() تسجيلاً يوفر بشكل غير متزامن جلسة كتابة (DataTransferWriteSession) مع معرف حزمة تحديث [SWS_DM_01923]. ويتم تحديد التفاصيل والحالة عبر GetUpdatePackageDetails() وGetUpdatePackageStatus() [SWS_DM_01802]، [SWS_DM_01917]، [SWS_DM_01921].
التثبيت أو الحذف: يمكن بدء التثبيت إما آلياً بواسطة PutUpdatePackageAutomated() [SWS_DM_01799]، [SWS_DM_01918] أو في خطوتين عبر PrepareUpdatePackage() [SWS_DM_01800]، [SWS_DM_01919] متبوعاً بـ ExecuteUpdatePackage() [SWS_DM_01801]، [SWS_DM_01920]. وتتم إزالة الحزم التي لم تعد هناك حاجة إليها عبر DeleteUpdatePackage() [SWS_DM_01922].
الإنهاء: قبل إيقاف التشغيل، يعطل التطبيق إعادة توجيه الرسائل عن طريق استدعاء StopOffer() [SWS_DM_01925].

مخطط التسلسل: المسار النموذجي لتسجيل حزمة وتثبيتها عبر SOVD. المصادر: [SWS_DM_01799]، [SWS_DM_01800]، [SWS_DM_01801]، [SWS_DM_01919]، [SWS_DM_01920]، [SWS_DM_01923]، [SWS_DM_01924]

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

عند تقديم الخدمات عبر Offer()، يمكن أن تحدث أخطاء معينة في نوع الإرجاع ara::core::Result<void>: DiagOfferErrc::kAlreadyOffered، إذا كانت النسخة مقدمة بالفعل، وكذلك DiagOfferErrc::kConfigurationMismatch، إذا كان التكوين لا يتطابق مع مستخرج التشخيص (DEXT) [SWS_DM_01924].

إذا تم استدعاء المنشئ مع حالة نموذج غير صحيحة، فسيتم الإبلاغ عن انتهاكات معمارية، بما في ذلك InstanceSpecifierMappingIntegrityViolation، PortInterfaceMappingViolation، ProcessMappingViolation أو InstanceSpecifierAlreadyInUseViolation [SWS_DM_01910].

تُرجع كافة عمليات التحديث الوظيفية ara::core::Future، والذي ينقل في حالة الخطأ رموز أخطاء وفقاً لـ ASAM SOVD 1.1 أو ISO 17978-3 [SWS_DM_01917]، [SWS_DM_01919]، [SWS_DM_01920]، [SWS_DM_01923]. بالإضافة إلى ذلك، تستقبل كافة الدوال غير المتزامنة CancellationHandler يُشار من خلاله إلى الإنهاء المبكر لاتصال التشخيص الجاري [SWS_DM_01916]، [SWS_DM_01919]، [SWS_DM_01923].

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive R25-11 وقد تم إنشاؤه آليًا.

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

مخطط الفئة

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

عرض التفاصيل

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

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

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

SovdSwUpdate دالة 3

Constructor for SovdSwUpdate.

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

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_01910

SovdSwUpdate (SovdSwUpdate const &)=delete; SWS_DM_01912

SovdSwUpdate (SovdSwUpdate &&other) noexcept; SWS_DM_01913

~SovdSwUpdate دالة

Destructor of class SovdSwUpdate.

virtual ~SovdSwUpdate () noexcept;

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

DeleteUpdatePackage دالة

Called for SOVD method "Delete Update Package from an SOVD Server".

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

ExecuteUpdatePackage دالة

Called for SOVD method "Execute Installation of an Update".

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

GetAllUpdates دالة

Called for SOVD method "Retrieve List of All Updates".

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

GetUpdatePackageDetails دالة

Called for SOVD method "Get Details of Update".

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

GetUpdatePackageStatus دالة

Called for SOVD method "Get Status of an Update".

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Offer دالة

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

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

PrepareUpdatePackage دالة

Called for SOVD method "Prepare Installation of an Update".

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

PutUpdatePackageAutomated دالة

Called for SOVD method "Automated Installation of an Update".

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

RequestUpdatePackageRegistration دالة

Called for SOVD method "Register an Update at the SOVD Server".

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

StopOffer دالة

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

void StopOffer () const noexcept;

المعاملات

operator= دالة 2

SovdSwUpdate shall be a single not assignable instance.

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

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete; SWS_DM_01914

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept; SWS_DM_01915

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

SubProgress فئة

UpdatePackageDetails فئة

UpdatePackageStatus فئة

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

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

توثيق الدوال

دالة DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

virtual ara::core::Future< void > DeleteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Delete Update Package from an SOVD Server".

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

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

تُستدعى الدالة الافتراضية الصرفة DeleteUpdatePackage للفئة ara::diag::SovdSwUpdate وفقًا لـ [SWS_DM_01803] بواسطة مثيل Diagnostic Server عندما يُراد تنفيذ أسلوب SOVD المسمى ”Delete Update Package from an SOVD Server“ ([SWS_DM_01922]). وهي تطلق عملية إزالة حزمة التحديث من جانب الخادم.

يتم الاستدعاء بشكل غير متزامن ويُرجع ara::core::Future<void>، والذي يشير إلى الاكتمال الناجح أو يوفر كائن خطأ [SWS_DM_01922]. تتطلب البنية المعلمات المدخلة التالية:

updatePackageId: يحدد بصفته ara::core::String المعرّف الفريد ID لحزمة التحديث المراد حذفها.
metaInfo: يمرر بصفته MetaInfo const& معلومات سياقية إضافية للطلب.
cancellationHandler: ينقل كائنًا من النوع CancellationHandler يبلّغ عما إذا كانت المحادثة الحالية قد أُلغيت.

إذا حدث خطأ أثناء المعالجة، يُملأ Future بخطأ SOVD المطابق. وتنص المواصفة هنا على استخدام أكواد خطأ مناسبة من ASAM SOVD 1.1 أو ISO 17978-3 [SWS_DM_01922].

فيما يتعلق بالتزامن، يُعرّف الأسلوب بأنه آمن لخيوط المعالجة بشكل مشروط: ويتحدد ما إذا كان يجب تنفيذ التنفيذ ليكون thread-safe أو non-thread-safe عبر ConcurrencyType الممرر في الدالة الإنشائية [SWS_DM_01922]. بالإضافة إلى ذلك، تم التصريح عن الدالة كـ noexcept وآمنة من الاستثناءات، ولهذا السبب لا يجوز أن يفلت أي استثناء.

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

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
updatePackageId	update-package-id to be deleted
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive results or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#6203bff42026-09-30
R23-11rel:R23-11#af1834882026-10-14
R24-11rel:R24-11#113a04fa2026-10-14
R25-11rel:R25-11#3e5d53622026-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

دالة ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

virtual ara::core::Future< void > ExecuteUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Execute Installation of an Update".

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

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

الاستخدام

يُستخدم أسلوب pure-virtual ExecuteUpdatePackage للواجهة ara::diag::SovdSwUpdate لتنفيذ أسلوب SOVD المسمى ”Execute Installation of an Update“ [SWS_DM_01920]. ويوجد التصريح في الترويسة ara/diag/sovd_sw_update.h AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.2 «ExecuteUpdatePackage». ويتم تمرير معرّف حزمة التحديث (updatePackageId) بالإضافة إلى بيانات الطلب (metaInfo) كمعلمات إدخال [SWS_DM_01920]. بالإضافة إلى ذلك، يبلّغ الكائن cancellationHandler بما إذا كانت المحادثة الجارية قد أُلغيت [SWS_DM_01920]. يتم الاستدعاء بشكل غير متزامن ويُرجع ara::core::Future<void>، والذي يوفر نتيجة إيجابية أو يبلّغ عن خطأ SOVD [SWS_DM_01920].

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

الواجهة محددة كـ noexcept وآمنة من الاستثناءات (”exception safe“) [SWS_DM_01920]. وبالتالي لا يجوز إطلاق الأخطاء أثناء التنفيذ عبر استثناءات C++‎، بل يجب إرجاعها بشكل غير متزامن عبر ara::core::Future باستخدام أكواد خطأ سارية من ASAM SOVD 1.1 أو ISO 17978-3 [SWS_DM_01920].

التزامن والشروط الحدية

فيما يتعلق بأمان خيوط المعالجة، هناك متطلب مشروط (”conditional“): يتحدد ما إذا كان يجب تنفيذ الدالة لتكون آمنة لخيوط المعالجة أو غير آمنة لخيوط المعالجة عبر المعلمة ConcurrencyType التي تم تمريرها إلى الدالة الإنشائية [SWS_DM_01920]. ويُرجح أن يتعين على التنفيذ تقييم cancellationHandler لإنهاء تثبيت الحزمة بطريقة منظمة عند إلغاء المحادثة [SWS_DM_01920]. سؤال Q-8fe6950e8f5a168c (مفتوح)

تم توليد هذا النص بواسطة ذكاء اصطناعي وهو بمثابة دليل توجيهي. المواصفات الرسمية لـ AUTOSAR هي وحدها الملزمة.

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
updatePackageId	update-package-id of the update to be executed
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive results or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#250ba828 Versionshistorie & Revisions (1 transition, 4 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_01920@rel:R25-11#250ba828

Recorded Revisions (4):

R25-11rel:R25-11#da8394102026-09-30
R23-11rel:R23-11#c3f2b7802026-10-14
R24-11rel:R24-11#f4456b492026-10-14
R25-11rel:R25-11#250ba8282026-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

دالة GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

virtual ara::core::Future< ara::core::Vector< ara::core::String > > GetAllUpdates (ara::core::String targetVersion, ara::core::String origin, MetaInfo const &metaInfo, CancellationHandler cancellation Handler) noexcept=0;

Called for SOVD method "Retrieve List of All Updates".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
targetVersion	Optional parameter to be used if the target-version query parameter is used in the request. If the parameter is not set the String shall be left empty. set in the request the String shall be left empty
origin	Optional parameter to be used if the origin query parameter is used in the request. If the parameter is not set the String shall be left empty
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<ara::core::Vector<ara::core::String > >	A future with a span of all update package ids. The span shall not be modified until the releaseHandler is called.

Fehler

Fehlercode	Beschreibung
This function does not specify any standardized errors.

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#cfb37af32026-09-30
R23-11rel:R23-11#1313500b2026-10-14
R24-11rel:R24-11#2fff52ce2026-10-14
R25-11rel:R25-11#fa31eee52026-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

دالة GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageDetails > GetUpdatePackage Details (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Details of Update".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
updatePackageId	update-package-id of the update to be read
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<UpdatePackageDetails >	A future with the details of the requested update package or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

Status: valid/unmigrated Version: rel:R25-11#08879f75 Versionshistorie & Revisions (1 transition, 4 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_01917@rel:R25-11#08879f75

Recorded Revisions (4):

R25-11rel:R25-11#5194b7fa2026-09-30
R23-11rel:R23-11#bed00f3c2026-10-14
R24-11rel:R24-11#71be4b722026-10-14
R25-11rel:R25-11#08879f752026-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

دالة GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

virtual ara::core::Future< UpdatePackageStatus > GetUpdatePackage Status (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Get Status of an Update".

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
updatePackageId	update-package-id of which the status shall be read
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<UpdatePackageStatus >	A future with either the current UpdatePackageStatus or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#6c5291e82026-09-30
R23-11rel:R23-11#6a27c4202026-10-14
R24-11rel:R24-11#f41bfa0b2026-10-14
R25-11rel:R25-11#a8720fc82026-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_01924] Upstream: RS_Diag_04265

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

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

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

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

تسجل دالة العضو ara::diag::SovdSwUpdate::Offer معالج تحديثات برمجيات SOVD لدى Diagnostic Management (DM) لتمكينه من توجيه رسائل الطلب الواردة إلى المعالج [SWS_DM_01924]. يتم الاستدعاء بشكل متزامن وبدون معلمات عبر الترويسة ara/diag/sovd_sw_update.h ولا يطلق أي استثناءات C++‎ وفقًا لـ noexcept [SWS_DM_01924].

يتم إرجاع نتيجة العملية كـ ara::core::Result<void> [SWS_DM_01924]. وإذا فشل التقديم، تُرجع الدالة خطأً بدلالات التراجع (Rollback) [SWS_DM_01924]:

DiagOfferErrc::kAlreadyOffered: تم بالفعل عرض الخدمة بنجاح لهذا المعالج مسبقًا [SWS_DM_01924].
DiagOfferErrc::kConfigurationMismatch: تكوين المراقب لا يتطابق مع تكوين DEXT [SWS_DM_01924].

فيما يتعلق بالتزامن، تم تحديد الأسلوب كـ exception safe، ولكنه محدد صراحةً كغير آمن لخيوط المعالجة (not thread-safe) [SWS_DM_01924]. تفسير: عند الوصول من عدة خيوط معالجة، يُرجح أن تكون هناك حاجة إلى مزامنة خارجية من جانب التطبيق. سؤال Q-4636ad27701d59df (مفتوح) يتوافق مبدأ التقديم عبر Offer مع المخطط العام لمعالجات التشخيص مثل [SWS_DM_00557] أو [SWS_DM_00735]، حيث لا يمكن لـ DM توجيه الطلبات إلا بمجرد عرض الواجهة المقابلة بشكل نشط [SWS_DM_01525].

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

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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::kConfigurationMismatch	rollback_semantics monitor configuration does not match DEXT
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_01924
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01924@rel:R25-11#5e9de983
Content hash: 5e9de983
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01924

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

Recorded Revisions (4):

R25-11rel:R25-11#4434cb652026-09-30
R23-11rel:R23-11#032ce7bb2026-10-14
R24-11rel:R24-11#438685592026-10-14
R25-11rel:R25-11#1b6fc58c2026-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

دالة PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PrepareUpdatePackage (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Prepare Installation of an Update".

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

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

يُستخدم الأسلوب الافتراضي الصرف PrepareUpdatePackage للواجهة ara::diag::SovdSwUpdate لتجهيز تثبيت حزمة تحديث برمجيات في إطار أسلوب SOVD المسمى ”Prepare Installation of an Update“ وفقًا لـ [SWS_DM_01919] (AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.7 «PrepareUpdatePackage»).

الاستدعاء والمعاملات

تتوفر الدالة عبر الترويسة ara/diag/sovd_sw_update.h وتقبل المعلمات التالية:

updatePackageId: معرّف (ara::core::String) حزمة التحديث المراد تجهيزها.
metaInfo: بيانات وصفية (MetaInfo const&) خاصة بطلب SOVD الوارد.
cancellationHandler: كائن مراقبة (CancellationHandler) يبلّغ بإلغاء المحادثة الحالية.

الاستدعاء محدد كـ noexcept ويتصرف بطريقة آمنة من الاستثناءات (exception-safe). وتتاح النتيجة غير المتزامنة عبر ara::core::Future<void>، والذي يشير إما إلى الاكتمال الناجح أو يوفر خطأً [SWS_DM_01919].

معالجة الأخطاء والتزامن

إذا حدث خطأ أثناء التجهيز، يجب إرجاع كود خطأ مناسب وفقًا لـ ASAM SOVD 1.1 أو ISO 17978-3 في Future [SWS_DM_01919]. وفيما يخص أمان خيوط المعالجة، ينطبق متطلب مشروط (conditional): ويتحدد ما إذا كان يجب تنفيذ الدالة لتكون آمنة لخيوط المعالجة عبر ConcurrencyType المحدد في الدالة الإنشائية عند إنشاء المثيل [SWS_DM_01919]. وعبر الكائن cancellationHandler، يُرجح أن يتمكن التطبيق من إلغاء خطوات التجهيز الطويلة إذا أُنهي الطلب قبل الأوان. سؤال Q-be4c53d9a0427ed5 (مفتوح)

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

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
updatePackageId	update-package-id of the update to be prepared
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive result or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#d529788a2026-09-30
R23-11rel:R23-11#cb96813b2026-10-14
R24-11rel:R24-11#124b85892026-10-14
R25-11rel:R25-11#7bdc8dcb2026-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

دالة PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

virtual ara::core::Future< void > PutUpdatePackageAutomated (ara::core::String updatePackageId, MetaInfo const &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for SOVD method "Automated Installation of an Update".

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

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

الاستخدام

يُستدعى الأسلوب الافتراضي الصرف PutUpdatePackageAutomated في سياق أسلوب SOVD المسمى ”Automated Installation of an Update“ [SWS_DM_01918]. وقد تم التصريح عنه في الترويسة ara/diag/sovd_sw_update.h داخل الفئة ara::diag::SovdSwUpdate AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated». وتُستخدم الدالة لتثبيت حزمة تحديث محددة بمعرّفها تلقائيًا.

تتوقع الواجهة معلمات الإدخال التالية:

updatePackageId (ara::core::String): معرّف حزمة التحديث المراد تمريرها إلى التثبيت التلقائي [SWS_DM_01918].
metaInfo (MetaInfo const &): معلومات وصفية لطلب الخدمة الوارد [SWS_DM_01918].
cancellationHandler (CancellationHandler): يبلّغ العملية بما إذا كانت المحادثة الجارية قد أُلغيت [SWS_DM_01918].

يمتلك الاستدعاء دلالات غير متزامنة. ويُستخدم ara::core::Future<void> كقيمة إرجاع، والتي تشير بعد الاكتمال إما إلى التنفيذ الناجح أو تحتوي على حالة خطأ [SWS_DM_01918].

معالجة الأخطاء والتزامن

في حالة حدوث خطأ، يجب إرجاع كود خطأ سارٍ من ASAM SOVD 1.1 أو ISO 17978-3 عبر الـ Future [SWS_DM_01918]. الأسلوب محدد كآمن من الاستثناءات (exception safe) ولا يطلق استثناءات C++‎ بصفته دالة noexcept AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.8 «PutUpdatePackageAutomated».

إن أمان خيوط المعالجة للأسلوب مشروط (conditional): ويتحدد ما إذا كان يجب تنفيذ التنفيذ ليكون thread-safe أو non-thread-safe عبر ConcurrencyType الممرر أثناء استدعاء الدالة الإنشائية [SWS_DM_01918].

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

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
updatePackageId	update-package-id of the update to be put to automated
metaInfo	MetaInfo of the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future< void >	A future with either a positive result or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#cde948f42026-09-30
R23-11rel:R23-11#97eae9312026-10-14
R24-11rel:R24-11#0f5da9f52026-10-14
R25-11rel:R25-11#befb20e22026-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

دالة RequestUpdatePackageRegistration [SWS_DM_01923] Upstream: RS_Diag_04265

virtual ara::core::Future< std::tuple< DataTransferWriteSession, ara::core::String > > RequestUpdatePackageRegistration (MetaInfo const &metaInfo, ara::core::Optional< uint64_t > expectedSize, Cancellation Handler cancellationHandler) noexcept=0;

Called for SOVD method "Register an Update at the SOVD Server".

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

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

تخدم الدالة الافتراضية الصرفة RequestUpdatePackageRegistration للفئة ara::diag::SovdSwUpdate أسلوب SOVD المسمى ”Register an Update at the SOVD Server“ [SWS_DM_01923]. وتشرع في تسجيل حزمة تحديث على الخادم وتبدأ جلسة النقل المرتبطة بها AUTOSAR_AP_SWS_Diagnostics §8.58.2.1.3.9 «RequestUpdatePackageRegistration».

يتم الاستدعاء بشكل غير متزامن ويُرجع ara::core::Future، والذي يحتوي في حالة النجاح على صف يتألف من DataTransferWriteSession وara::core::String مع ID الخاص بحزمة التحديث [SWS_DM_01923]. عند الاستدعاء، يتم تمرير المعلمات التالية:

metaInfo: معلومات وصفية للطلب الوارد.
expectedSize: الحجم الإجمالي المتوقع الاختياري للحزمة (ara::core::Optional<uint64_t>)، إذا تم التصريح عنه في الطلب.
cancellationHandler: يشير إلى ما إذا كانت المحادثة الحالية قد أُلغيت.

الدالة محددة كـ noexcept وآمنة من الاستثناءات [SWS_DM_01923]. وبالتالي لا يتم الإبلاغ عن الأخطاء عبر استثناءات C++‎، بل تتاح بشكل غير متزامن عبر الـ Future؛ ويجب استخدام أكواد الخطأ المقابلة من ASAM SOVD 1.1 أو ISO 17978-3 على التوالي لهذا الغرض [SWS_DM_01923].

أمان خيوط المعالجة مشروط (”conditional“): يتحدد ما إذا كان يجب تنفيذ الأسلوب ليكون آمنًا لخيوط المعالجة عبر ConcurrencyType المحدد في الدالة الإنشائية [SWS_DM_01923]. لذلك، يُرجح أن يتطلب التنفيذ الفعلي آليات مزامنة خاصة به اعتمادًا على إنشاء المثيل. سؤال Q-7e80e557bdd7627a (مفتوح)

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويُستخدم للمساعدة في استخدام عنصر API.

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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
metaInfo	MetaInfo of the request.
expectedSize	Specifies the expected size if available in the request.
cancellationHandler	Informs if the current conversation is cancelled

Rückgabewert

Typ	Beschreibung
ara::core::Future<std::tuple< DataTransferWriteSession, ara::core::String > >	A future with either an instance of a "SOVD file writing session" with the corresponding update package id or a SOVD Error

Fehler

Fehlercode	Beschreibung
Please use applicable error code from ASAM SOVD 1.1 or ISO 17978-3.

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#0245e3c02026-09-30
R23-11rel:R23-11#c6f57bb12026-10-14
R24-11rel:R24-11#5e5e1b832026-10-14
R25-11rel:R25-11#b092f8d82026-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

دالة SovdSwUpdate [SWS_DM_01910] Upstream: RS_Diag_04265, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

SovdSwUpdate (ara::core::InstanceSpecifier const &instanceSpecifier, ConcurrencyType concurrencyType) noexcept;

Constructor for SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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 referenced by a pingViolation DiagnosticSovdUpdatePortMapping needs to be typed by a DiagnosticSovdUpdateInterface. 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 DiagnosticSovdUpdateInterface service instance in the manifest.
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_01910
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01910@rel:R25-11#6172aef7
Content hash: 6172aef7
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01910

Status: valid/unmigrated Version: rel:R25-11#39b10a70 Versionshistorie & Revisions (1 transition, 4 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_01910@rel:R25-11#39b10a70

Recorded Revisions (4):

R25-11rel:R25-11#5bc9aa6d2026-09-30
R23-11rel:R23-11#cb3f1d3a2026-10-14
R24-11rel:R24-11#71a1ee492026-10-14
R25-11rel:R25-11#39b10a702026-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

دالة SovdSwUpdate [SWS_DM_01912] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not copy-able instance.

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

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#29457c012026-09-30
R23-11rel:R23-11#920c2b292026-10-14
R24-11rel:R24-11#a9b2eed02026-10-14
R25-11rel:R25-11#a9b2eed02026-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

دالة SovdSwUpdate [SWS_DM_01913] Upstream: RS_Diag_04265

SovdSwUpdate (SovdSwUpdate &&other) noexcept;

Move constructs an instance of SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
Exception-Sicherheit	exception safe
Thread-Sicherheit	unsafe
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_01913
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01913@rel:R25-11#e003f559
Content hash: e003f559
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01913

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

Recorded Revisions (4):

R25-11rel:R25-11#662a98ac2026-09-30
R23-11rel:R23-11#2175e3ea2026-10-14
R24-11rel:R24-11#4c7578592026-10-14
R25-11rel:R25-11#4c7578592026-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_01925] Upstream: RS_Diag_04265

void StopOffer () const noexcept;

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

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

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

الاستخدام

تُنهي الطريقة ara::diag::SovdSwUpdate::StopOffer تقديم الخدمة وتعطّل إعادة توجيه رسائل الطلب الواردة من Diagnostic Management (DM) إلى مكوّن تحديث البرمجيات [SWS_DM_01925]. يتم الاستدعاء عبر الواجهة من ara/diag/sovd_sw_update.h، وبدون معلمات، ولا يرجع أي قيمة [SWS_DM_01925]. يتم إنهاء توفير الخدمة بشكل متزامن، وهو ما يطابق التعطيل المفاهيمي لوظائف التشخيص في AUTOSAR Adaptive AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors».

معالجة الأخطاء والتزامن

تمتلك الدالة المواصفة noexcept وبالتالي فهي آمنة من الاستثناءات؛ ولا يُتوقع وجود حالات خطأ عبر الاستثناءات أو رموز الأخطاء [SWS_DM_01925]. وبالنسبة لسياق الاستدعاء، فإن الدالة معرّفة على أنها غير آمنة لخيوط المعالجة («not thread-safe») [SWS_DM_01925]. يجب مزامنة الاستدعاءات المتوازية على نفس المثيل من جانب التطبيق. تفسير: يُرجَّح أن يظل الاستدعاء المتكرر لـ StopOffer في الحالة غير النشطة بالفعل دون أي تأثير خطأ، نظراً لعدم وجود معالجة للأخطاء. سؤال Q-efaccde5507eb444 (مفتوح)

تفاعل

تندمج الدالة في النظام ككل ضمن المخطط الموحّد لدورة حياة خدمة DM. وهي تشكّل المقابل الوظيفي لتقديم الخدمة وتتصرف بشكل مماثل لعمليات التعطيل لخدمات التشخيص الأخرى مثل ara::diag::DownloadService [SWS_DM_00793] وara::diag::GenericUDSService [SWS_DM_00620] وكذلك ara::diag::EcuResetRequest [SWS_DM_01017].

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

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

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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_01925
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01925@rel:R25-11#c5e804f6
Content hash: c5e804f6
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01925

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

Recorded Revisions (4):

R25-11rel:R25-11#60438b2c2026-09-30
R23-11rel:R23-11#aac09bc62026-10-14
R24-11rel:R24-11#b5890de52026-10-14
R25-11rel:R25-11#b5890de52026-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_01914] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate const &)=delete;

SovdSwUpdate shall be a single not assignable instance.

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

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

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

Status: valid/unmigrated Version: rel:R25-11#193efe55 Versionshistorie & Revisions (1 transition, 4 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_01914@rel:R25-11#193efe55

Recorded Revisions (4):

R25-11rel:R25-11#f93349172026-09-30
R23-11rel:R23-11#bd4a8b212026-10-14
R24-11rel:R24-11#193efe552026-10-14
R25-11rel:R25-11#193efe552026-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_01915] Upstream: RS_Diag_04265

SovdSwUpdate & operator= (SovdSwUpdate &&other) & noexcept;

Move assigns an instance of SovdSwUpdate.

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

Parameter (out)

Parameter	Beschreibung
other	The other object

Rückgabewert

Typ	Beschreibung
SovdSwUpdate &	Reference to self

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

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

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

Recorded Revisions (4):

R25-11rel:R25-11#9f73c1222026-09-30
R23-11rel:R23-11#7eb86d6a2026-10-14
R24-11rel:R24-11#1ed1cfe62026-10-14
R25-11rel:R25-11#1ed1cfe62026-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

دالة ~SovdSwUpdate [SWS_DM_01911] Upstream: RS_Diag_04265

virtual ~SovdSwUpdate () noexcept;

Destructor of class SovdSwUpdate.

Header-Datei	#include "ara/diag/sovd_sw_update.h"
Scope	class ara::diag::SovdSwUpdate
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_01911
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_DM_01911@rel:R25-11#16055711
Content hash: 16055711
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01911

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

Recorded Revisions (4):

R25-11rel:R25-11#7b4f357a2026-09-30
R23-11rel:R23-11#0a7ddd152026-10-14
R24-11rel:R24-11#5ddc97882026-10-14
R25-11rel:R25-11#2b411c6a2026-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::SovdSwUpdate

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

السياق

دورة الحياة

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

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

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

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

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

المعاملات

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

مخطط الفئة

عرض التفاصيل

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

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

المعاملات

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

توثيق الدوال

دالة DeleteUpdatePackage [SWS_DM_01922] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة ExecuteUpdatePackage [SWS_DM_01920] Upstream: RS_Diag_04265

الاستخدام

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

التزامن والشروط الحدية

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetAllUpdates [SWS_DM_01916] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetUpdatePackageDetails [SWS_DM_01917] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة GetUpdatePackageStatus [SWS_DM_01921] Upstream: RS_Diag_04265

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Offer [SWS_DM_01924] Upstream: RS_Diag_04265

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة PrepareUpdatePackage [SWS_DM_01919] Upstream: RS_Diag_04265

الاستدعاء والمعاملات

معالجة الأخطاء والتزامن

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة PutUpdatePackageAutomated [SWS_DM_01918] Upstream: RS_Diag_04265

الاستخدام