DEENESPTFRRUARHIKOZHNL

فئة ara::phm::RecoveryAction

[SWS_PHM_01140] Upstream: RS_HM_09159

class RecoveryAction {...};

RecoveryAction abstract class.

Header-Datei#include "ara/phm/recovery_action.h"
Forwarding-Header#include "ara/phm/phm_fwd.h"
Scopenamespace ara::phm

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

تخدم التطبيقات لتوفير وتنفيذ تدابير الاسترداد عند حدوث أخطاء مراقبة PHM.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 1c1f80bf2db1 المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تخدم التطبيقات لتوفير وتنفيذ تدابير الاسترداد عند حدوث أخطاء مراقبة PHM.

تتيح الفئة المجردة ara::phm::RecoveryAction للتطبيقات توفير تدابير استرداد مخصصة للتطبيق لصالح Platform Health Management [SWS_PHM_01141]. وبعد إنشاء المثيل، يفعّل استدعاء Offer() الجاهزية للاستقبال لبرنامج الخدمة الخلفية Phm، بحيث يتم استدعاء الدالة المتجاوزة RecoveryHandler عند اكتشاف أخطاء مراقبة [SWS_PHM_01143]. وإذا تعذر تصحيح الخطأ من جانب التطبيق، يصعد النظام الموقف عن طريق إطلاق كلب الحراسة (Watchdog). وتُمنع عمليات النسخ والنقل تماماً لأسباب تتعلق بالسلامة، كما أن استدعاءات الإدارة مثل Offer() ليست آمنة بالنسبة للخيوط.

السياق

الفئة ara::phm::RecoveryAction هي فئة أساسية مجردة في وحدة Platform Health Management (PHM) التابعة لـ AUTOSAR Adaptive Platform. وتعمل كواجهة قياسية للتطبيقات الوظيفية لتوفير تدابير استرداد ومعالجة أخطاء محددة يتم إطلاقها عبر PHM عند اكتشاف أخطاء مراقبة.

تشمل أطراف التفاعل الأساسية ما يلي:

  • مكونة التطبيق المشتقة: تفسير: يُرجح أن تكون متمركزة عادةً في State Management، نظراً لأنها المسؤولة عن ردود فعل النظام المنسقة وتُذكر صراحةً في سياق الأخطاء. سؤال Q-714ff81a33aa3e92 (مفتوح) وينفذ التطبيق معالجة الأخطاء الخاصة به عن طريق تجاوز الدالة RecoveryHandler [SWS_PHM_01142].
  • برنامج الخدمة الخلفية Phm: يدير تسجيل إجراءات الاسترداد عبر Offer [SWS_PHM_01143]، ويتحكم عند رصد أخطاء في استدعاء المعالج المسجل [SWS_PHM_01142].
  • كلب الحراسة (Watchdog): إذا لم يتسن إجراء الاسترداد بنجاح من جانب التطبيق، تتولى PHM المعالجة الإضافية للخطأ وتطلق كلب الحراسة للحماية [SWS_PHM_01142].

يتم الربط المنطقي مع نموذج AUTOSAR عند إنشاء المثيل عبر ara::core::InstanceSpecifier، والذي يجب أن يشير إلى PPortPrototype لواجهة PhmRecoveryAction [SWS_PHM_01141].

دورة الحياة

يتم إنشاء مثيل عبر المنشئ الصريح مع تمرير محدد المثيل المناسب [SWS_PHM_01141]. وهذا المنشئ آمن بالنسبة للخيوط (thread-safe) وآمن ضد الاستثناءات (noexcept).

نظراً لأن RecoveryAction ترتبط ارتباطاً وثيقاً بمنفذ محدد، فإن عمليات النسخ والنقل محظورة تماماً: فكل من منشئ النسخ [SWS_PHM_01150] ومعامل التعيين بالنسخ [SWS_PHM_01152] محذوفان (= delete). وبالمثل، فإن منشئ النقل [SWS_PHM_01149] ومعامل التعيين بالنقل [SWS_PHM_01151] محذوفان. وتعلل المواصفة ذلك بأن النقل بعد تقديم المثيل قد يؤدي إلى استدعاء RecoveryHandler قبل اكتمال إنشاء الفئة المشتقة، مما يسفر عن سلوك غير محدد أو استثناءات غير معالجة ويعرض سلامة النظام للخطر [SWS_PHM_01149]، [SWS_PHM_01151].

تتضمن دورة الحياة حالتين متميزتين:

  • غير معروض: مباشرة بعد الإنشاء وكذلك بعد استدعاء StopOffer [SWS_PHM_01144]، يكون المثيل غير نشط. وتكون استدعاءات RecoveryHandler محظورة.
  • معروض: عبر استدعاء Offer() [SWS_PHM_01143]، يتم تفعيل الإجراء لدى برنامج الخدمة الخلفية Phm وإتاحته لاستدعاءات المعالج.

يتم تحرير الكائن عبر مدمر الكائن الافتراضي [SWS_PHM_01145]. وفيما يتعلق بالتزامن، حُدد المنشئ وRecoveryHandler بأنهما آمنان بالنسبة للخيوط، بينما Offer() وStopOffer() ومدمر الكائن غير آمنة بالنسبة للخيوط (not thread-safe) [SWS_PHM_01141]، [SWS_PHM_01142]، [SWS_PHM_01143]، [SWS_PHM_01144]، [SWS_PHM_01145]. تفسير: يُرجح عملياً وجوب استدعاء StopOffer() دائماً قبل تدمير مثيل ما، لاستبعاد استدعاءات المعالج غير المتزامنة بأمان أثناء تفكيك الكائن. سؤال Q-a1f47898bed925fd (مفتوح)

diag_recovery_lifecycle NichtAngeboten غير معروضة Angeboten Angeboten NichtAngeboten->Angeboten Offer() Angeboten->NichtAngeboten StopOffer() Angeboten->Angeboten RecoveryHandler()

مخطط الحالات: حالات دورة حياة RecoveryAction مع التفعيل عبر Offer وإلغاء التفعيل عبر StopOffer. المصادر: [SWS_PHM_01141]، [SWS_PHM_01143]، [SWS_PHM_01144]، [SWS_PHM_01145]

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

ينقسم الاستخدام النموذجي إلى تسلسل استدعاءات ثابت:

  1. تعريف فئة مشتقة تطبق دالة العضو الافتراضية البحتة RecoveryHandler [SWS_PHM_01142].
  2. إنشاء مثيل للكائن المشتق مع تحديد محدد المثيل [SWS_PHM_01141].
  3. استدعاء Offer() لتوفير إجراء الاسترداد لدى برنامج الخدمة الخلفية Phm [SWS_PHM_01143].
  4. الاستجابة للأخطاء: إذا اكتشفت PHM خطأً، فإنها تستدعي RecoveryHandler(executionError, supervision) [SWS_PHM_01142]. وتُرجع الدالة ara::core::Future<void> يتم عبره الإبلاغ عن نتيجة معالجة الخطأ.
  5. استدعاء StopOffer() بمجرد ألا يعود على المثيل خدمة أي إجراءات استرداد [SWS_PHM_01144].
  6. إتلاف الكائن عبر مدمر الكائن [SWS_PHM_01145].
Nutzungsablauf von ara::phm::RecoveryActionالتطبيقRecoveryActionPhm-DaemonRecoveryAction(instance)Offer()Aktion anmeldenBestaetigungResult<void> (Erfolg)Use Case: Fehlerbehandlung durch PHMRecoveryHandler(executionError, supervision)Future<void>Use Case: إلغاء التسجيل والتفكيكStopOffer()~RecoveryAction()

مخطط تسلسلي: ترتيب الاستدعاءات النموذجي عند التسجيل والإشعار بالخطأ وإلغاء تسجيل إجراء استرداد. المصادر: [SWS_PHM_01141]، [SWS_PHM_01142]، [SWS_PHM_01143]، [SWS_PHM_01144]، [SWS_PHM_01145]

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

في إطار تكوين النموذج والتشغيل، ينبغي مراعاة شروط خطأ محددة:

  • انتهاكات النموذج والتحقق من الصحة أثناء الإنشاء [SWS_PHM_01141]:
    • AraNotInitializedViolation: لم تتم تهيئة بيئة تشغيل ARA قبل إنشاء المثيل.
    • InstanceSpecifierMappingIntegrityViolation: يتعذر حل محدد المثيل في النموذج أو أنه لا يشير إلى PortPrototype.
    • PortInterfaceMappingViolation: نموذج المنفذ الأولي المشار إليه عبر RecoveryNotificationToPPortPrototypeMapping غير محدد النوع بواسطة PhmSupervisionRecoveryNotificationInterface.
    • ProcessMappingViolation: لا توجد عملية منمذجة بشكل مناسب لمرجع المثيل (Instance-Ref) في وقت التشغيل.
    • InstanceSpecifierAlreadyInUseViolation: محدد المثيل مستخدم بالفعل داخل العملية الحالية.
  • خطأ اتصال أثناء العرض [SWS_PHM_01143]: إذا فشل الاتصال مع Phm-Daemon، يُرجع Offer() نتيجة تتضمن رمز الخطأ PhmErrc::kOfferFailed.
  • أخطاء غير قابلة للإصلاح أثناء الاستعادة [SWS_PHM_01142]: إذا تعذر على State Management معالجة الخطأ المُبلَّغ عنه، فإن Future المُرجع من RecoveryHandler يُرجع الخطأ PhmErrc::kSMCanNotHandleRecovery. وبناءً على ذلك، يتدخل Platform Health Management ويُطلق watchdog.

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

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

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

2
RecoveryAction~RecoveryAction

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

3
OfferRecoveryHandlerStopOffer

المعاملات

1
operator=

مخطط الفئة

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

G nara__phm__RecoveryAction85 RecoveryAction + RecoveryAction() + operator=() + ~RecoveryAction() + Offer() + RecoveryHandler() + StopOffer()

عرض التفاصيل

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

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

RecoveryAction دالة 3

Creation of an RecoveryAction.

التحميلات الزائدة RecoveryAction 3
explicit RecoveryAction (const ara::core::InstanceSpecifier &instance) noexcept; SWS_PHM_01141
RecoveryAction (RecoveryAction &&ra)=delete; SWS_PHM_01149
RecoveryAction (const RecoveryAction &)=delete; SWS_PHM_01150
~RecoveryAction دالة

Destructor for RecoveryAction.

virtual ~RecoveryAction () noexcept;

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

Offer دالة

Enables potential invocations of RecoveryHandler.

ara::core::Result< void > Offer () noexcept;
RecoveryHandler دالة

RecoveryHandler to be invoked by PHM. The handler invocation needs to be enabled before by a call of RecoveryAction::Offer.

virtual ara::core::Future< void > RecoveryHandler (const ara::exec::ExecutionErrorEvent &executionError, TypeOfSupervision supervision) noexcept=0;
StopOffer دالة

Disables invocations of RecoveryHandler.

void StopOffer () noexcept;

المعاملات

operator= دالة 2

The move assignment operator for the RecoveryAction shall not be used. Rationale: Using the move assignment after a RecoveryAction instance has been offered may result in premature invocation of RecoveryHandler before the derived class is fully constructed. This can lead to undefined behavior or unhandled exceptions, compromising system stability and safety.

التحميلات الزائدة = 2
RecoveryAction & operator= (RecoveryAction &&ra)=delete; SWS_PHM_01151
RecoveryAction & operator= (const RecoveryAction &)=delete; SWS_PHM_01152

توثيق الدوال

دالة Offer [SWS_PHM_01143] Upstream: RS_HM_09159, RS_AP_00159

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

Enables potential invocations of RecoveryHandler.

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

تنتمي الطريقة الخالية من المعاملات Offer إلى الفئة ara::phm::RecoveryAction ويتم تضمينها عبر ملف الترويسة ara/phm/recovery_action.h [SWS_PHM_01143]. والغرض منها هو تقديم الخدمة إلى Platform Health Management (PHM) لتمكين استدعاءات لاحقة لـ RecoveryHandler [SWS_PHM_01143]. ويتم الاستدعاء بشكل متزامن ولا يقبل أي معاملات [SWS_PHM_01143].

يتم إرجاع نتيجة التنفيذ كـ ara::core::Result<void> [SWS_PHM_01143]. وفي حالة عدم وجود أخطاء، يكون Result هذا فارغًا. وإذا فشل الاتصال مع عفريت PHM، فلن يمكن تقديم الخدمة وترجع الدالة رمز الخطأ PhmErrc::kOfferFailed مع دلالات التراجع (Rollback) [SWS_PHM_01143].

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

يوجد في النظام المتكامل ارتباط مباشر بمعالجة الأخطاء: يُستخدم RecoveryHandler للفئة ara::phm::RecoveryAction للاستجابة لأخطاء التنفيذ (ara::exec::ExecutionErrorEvent) وأخطاء المراقبة (TypeOfSupervision) [SWS_PHM_01142]. ولا يمكن لـ PHM استدعاء هذا المعالج إلا بعد تفعيل التنشيط صراحةً مسبقًا عبر RecoveryAction::Offer [SWS_PHM_01142].

تم توليد ملاحظة الاستخدام هذه تلقائياً بناءً على المواصفة.

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >A Result, being either empty or containing any of the errors defined below.

Fehler

FehlercodeBeschreibung
PhmErrc::kOfferFailedrollback_semantics Service could not be offered due to failure of communication with Phm daemon

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

Record
AUTOSAR/AP/record/SWS_PHM_01143
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01143@rel:R25-11#4dc1e8f7
Content hash
4dc1e8f7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01143
Status: valid/unmigrated Version: rel:R25-11#d8dd83b4 Versionshistorie & Revisions (1 transition, 8 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_PHM_01143@rel:R25-11#d8dd83b4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#857c7b2e2026-09-30
  • R19-11rel:R19-11#ca5925372026-10-14
  • R20-11rel:R20-11#17739ebd2026-10-14
  • R21-11rel:R21-11#da1133fa2026-10-14
  • R22-11rel:R22-11#cf1368c72026-10-14
  • R23-11rel:R23-11#86ed8de42026-10-14
  • R24-11rel:R24-11#d8dd83b42026-10-14
  • R25-11rel:R25-11#d8dd83b42026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة RecoveryAction [SWS_PHM_01141] Upstream: RS_HM_09159, RS_AP_00159, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit RecoveryAction (const ara::core::InstanceSpecifier &instance) noexcept;

Creation of an RecoveryAction.

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe
Verletzungen (Violations)AraNotInitialized- Violation message that is sent in case a constructor or function Violation checks for an initialized ara and identifies that ara is not initialized. 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 RecoveryNotificationToPPortPrototypeMapping needs to be typed by a PhmSupervisionRecoveryNotificationInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.

Parameter (in)

ParameterBeschreibung
instanceinstance specifier to the PPortPrototype of a PhmRecoveryAction Interface

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

Record
AUTOSAR/AP/record/SWS_PHM_01141
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01141@rel:R25-11#d89e8d1b
Content hash
d89e8d1b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01141
Status: valid/unmigrated Version: rel:R25-11#a1bff3f3 Versionshistorie & Revisions (1 transition, 8 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_PHM_01141@rel:R25-11#a1bff3f3
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#f5f6a77d2026-09-30
  • R19-11rel:R19-11#415751492026-10-14
  • R20-11rel:R20-11#0bb740092026-10-14
  • R21-11rel:R21-11#0bb740092026-10-14
  • R22-11rel:R22-11#9ba3238f2026-10-14
  • R23-11rel:R23-11#d99db8452026-10-14
  • R24-11rel:R24-11#4bbb0aac2026-10-14
  • R25-11rel:R25-11#a1bff3f32026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة RecoveryAction [SWS_PHM_01149] Upstream: RS_HM_09159, RS_AP_00159

RecoveryAction (RecoveryAction &&ra)=delete;

The move constructor operator for the RecoveryAction shall not be used. Rationale: Using the move constructor after a RecoveryAction instance has been offered may result in premature invocation of RecoveryHandler before the derived class is fully constructed. This can lead to undefined behavior or unhandled exceptions, compromising system stability and safety

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction

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

Record
AUTOSAR/AP/record/SWS_PHM_01149
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01149@rel:R25-11#8f113f6d
Content hash
8f113f6d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01149
Status: valid/unmigrated Version: rel:R25-11#ad5dcd6d Versionshistorie & Revisions (1 transition, 7 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_PHM_01149@rel:R25-11#ad5dcd6d
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#174faeae2026-09-30
  • R20-11rel:R20-11#388d41232026-10-14
  • R21-11rel:R21-11#388d41232026-10-14
  • R22-11rel:R22-11#cfcda3ac2026-10-14
  • R23-11rel:R23-11#75ceb7ff2026-10-14
  • R24-11rel:R24-11#1ab59f662026-10-14
  • R25-11rel:R25-11#ad5dcd6d2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة RecoveryAction [SWS_PHM_01150] Upstream: RS_HM_09159

RecoveryAction (const RecoveryAction &)=delete;

The copy constructor for RecoveryAction shall not be used.

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction

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

Record
AUTOSAR/AP/record/SWS_PHM_01150
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01150@rel:R25-11#112e38af
Content hash
112e38af
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01150
Status: valid/unmigrated Version: rel:R25-11#fe708e57 Versionshistorie & Revisions (1 transition, 7 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_PHM_01150@rel:R25-11#fe708e57
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#9fad0d072026-09-30
  • R20-11rel:R20-11#73566a6f2026-10-14
  • R21-11rel:R21-11#73566a6f2026-10-14
  • R22-11rel:R22-11#06e07d412026-10-14
  • R23-11rel:R23-11#c100fbf82026-10-14
  • R24-11rel:R24-11#fe708e572026-10-14
  • R25-11rel:R25-11#fe708e572026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة RecoveryHandler [SWS_PHM_01142] Upstream: RS_HM_09159, RS_AP_00159

virtual ara::core::Future< void > RecoveryHandler (const ara::exec::ExecutionErrorEvent &executionError, TypeOfSupervision supervision) noexcept=0;

RecoveryHandler to be invoked by PHM. The handler invocation needs to be enabled before by a call of RecoveryAction::Offer.

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

تعمل الطريقة الافتراضية الصرفة RecoveryHandler في ara::phm::RecoveryAction كرد نداء (Callback) غير متزامن يستدعيه Platform Health Management (PHM) بمجرد فشل إحدى عمليات المراقبة [SWS_PHM_01142]. عند الاستدعاء، يمرر PHM حدث الخطأ executionError مع معلومات مفصلة عن الاسترداد، بالإضافة إلى نوع المراقبة الأولية الفاشلة عبر المعامل supervision [SWS_PHM_01142].

تنطبق شروط تسلسل وتزامن ثابتة على الاستخدام ودورة الحياة:

  • التفعيل: يجب تمكين استدعاءات المعالج مسبقًا بشكل صريح عبر RecoveryAction::Offer [SWS_PHM_01142]، [SWS_PHM_01143]. ويمكن إلغاء تفعيلها مجددًا عبر StopOffer [SWS_PHM_01144].
  • سلامة الكائن: تم حذف كل من منشئ النقل وعامل تعيين النقل لـ RecoveryAction (=delete)، وذلك لمنع تنفيذ استدعاءات مبكرة للمعالج على فئات مشتقة لم يكتمل إنشاؤها بعد، وذلك بعد عرض الإجراء [SWS_PHM_01149]، [SWS_PHM_01151].
  • أمان الخيوط: تم تحديد الطريقة نفسها بأنها آمنة للخيوط (thread-safe) وآمنة من الاستثناءات [SWS_PHM_01142]، في حين أن Offer وStopOffer ليسا آمنين للخيوط [SWS_PHM_01143]، [SWS_PHM_01144].

يتم الإرجاع بشكل غير متزامن عبر ara::core::Future<void> [SWS_PHM_01142]. إذا كان الاسترداد ناجحًا، فسيتم استيفاء الـ Future بـ void. وإذا لم يتمكن State Management من تنفيذ الاسترداد، يفشل الـ Future برمز الخطأ PhmErrc::kSMCanNotHandleRecovery؛ في هذه الحالة يتدخل Platform Health Management ويطلق مؤقت المراقبة (Watchdog) [SWS_PHM_01142].

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

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

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
executionErrorInformation on detected error, shall give further information for error recovery.
supervisionThe type of elementary supervision which failed.

Rückgabewert

TypBeschreibung
ara::core::Future< void >void if recovery is successful, otherwise it returns kSMCanNot HandleRecovery error

Fehler

FehlercodeBeschreibung
PhmErrc::kSMCanNotHandleRecoveryrollback_semantics State Management cannot handle the recovery and PlatformHealth Management will take over by firing the watchdog.

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

Record
AUTOSAR/AP/record/SWS_PHM_01142
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01142@rel:R25-11#da1863b0
Content hash
da1863b0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01142
Status: valid/unmigrated Version: rel:R25-11#d7b7a988 Versionshistorie & Revisions (1 transition, 8 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_PHM_01142@rel:R25-11#d7b7a988
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#9d70b1c72026-09-30
  • R19-11rel:R19-11#74f0a8f02026-10-14
  • R20-11rel:R20-11#0cc3316c2026-10-14
  • R21-11rel:R21-11#0cc3316c2026-10-14
  • R22-11rel:R22-11#badb86d42026-10-14
  • R23-11rel:R23-11#89d68dcf2026-10-14
  • R24-11rel:R24-11#f8c2bd5d2026-10-14
  • R25-11rel:R25-11#d7b7a9882026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة StopOffer [SWS_PHM_01144] Upstream: RS_HM_09159, RS_AP_00159

void StopOffer () noexcept;

Disables invocations of RecoveryHandler.

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

تُستخدم الطريقة StopOffer من الفئة ara::phm::RecoveryAction لإلغاء تفعيل تنفيذ RecoveryHandler المقترن بها [SWS_PHM_01144]. وهي مُصرح عنها في ملف الترويسة ara/phm/recovery_action.h [SWS_PHM_01144].

الاستخدام والدلالات

تمتلك الدالة البنية void StopOffer() noexcept;، ولا تقبل أي معاملات ولا تُرجع أي قيمة [SWS_PHM_01144]. من خلال هذا الاستدعاء، يشير التطبيق إلى Platform Health Management (PHM) بأنه لا ينبغي إجراء المزيد من الاستدعاءات للمعالج [SWS_PHM_01144]. يتم الاستدعاء بشكل متزامن؛ ويُرجح أن تكتمل حالات المعالج الجاري تشغيلها قبل إلغاء التفعيل أو أثناءه (تفسير). سؤال Q-a333b1e2f0634ed1 (مفتوح)

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

  • أمان الاستثناءات: تم التصريح عن العملية بأنها noexcept وتعتبر آمنة تمامًا من الاستثناءات (exception safe)؛ ولا توجد رموز خطأ أو استثناءات [SWS_PHM_01144].
  • أمان الخيوط: تم تحديد الطريقة صراحةً بأنها not thread-safe [SWS_PHM_01144]. ولذلك، يتطلب الاستدعاء المتزامن على نفس نسخة RecoveryAction مزامنة خارجية من قبل جهة الاستدعاء.

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

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_PHM_01144
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01144@rel:R25-11#57fb61b2
Content hash
57fb61b2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01144
Status: valid/unmigrated Version: rel:R25-11#0a3b9401 Versionshistorie & Revisions (1 transition, 8 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_PHM_01144@rel:R25-11#0a3b9401
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#e69e06162026-09-30
  • R19-11rel:R19-11#122a6efb2026-10-14
  • R20-11rel:R20-11#485b84892026-10-14
  • R21-11rel:R21-11#adcb24f02026-10-14
  • R22-11rel:R22-11#55be05992026-10-14
  • R23-11rel:R23-11#b64d35982026-10-14
  • R24-11rel:R24-11#0a3b94012026-10-14
  • R25-11rel:R25-11#0a3b94012026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_PHM_01151] Upstream: RS_HM_09159, RS_AP_00159

RecoveryAction & operator= (RecoveryAction &&ra)=delete;

The move assignment operator for the RecoveryAction shall not be used. Rationale: Using the move assignment after a RecoveryAction instance has been offered may result in premature invocation of RecoveryHandler before the derived class is fully constructed. This can lead to undefined behavior or unhandled exceptions, compromising system stability and safety.

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction

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

Record
AUTOSAR/AP/record/SWS_PHM_01151
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01151@rel:R25-11#bd0ca298
Content hash
bd0ca298
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01151
Status: valid/unmigrated Version: rel:R25-11#4359eed2 Versionshistorie & Revisions (1 transition, 7 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_PHM_01151@rel:R25-11#4359eed2
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#472762232026-09-30
  • R20-11rel:R20-11#41ba0c072026-10-14
  • R21-11rel:R21-11#41ba0c072026-10-14
  • R22-11rel:R22-11#a0be95c32026-10-14
  • R23-11rel:R23-11#2eed5b982026-10-14
  • R24-11rel:R24-11#05a1b01f2026-10-14
  • R25-11rel:R25-11#4359eed22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_PHM_01152] Upstream: RS_HM_09159

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

The copy assignment operator for RecoveryAction shall not be used.

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction

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

Record
AUTOSAR/AP/record/SWS_PHM_01152
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01152@rel:R25-11#71f9e257
Content hash
71f9e257
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01152
Status: valid/unmigrated Version: rel:R25-11#ff4c96ac Versionshistorie & Revisions (1 transition, 7 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_PHM_01152@rel:R25-11#ff4c96ac
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#5c298d6f2026-09-30
  • R20-11rel:R20-11#32919afc2026-10-14
  • R21-11rel:R21-11#32919afc2026-10-14
  • R22-11rel:R22-11#9157a7c42026-10-14
  • R23-11rel:R23-11#f01e06fc2026-10-14
  • R24-11rel:R24-11#ff4c96ac2026-10-14
  • R25-11rel:R25-11#ff4c96ac2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة ~RecoveryAction [SWS_PHM_01145] Upstream: RS_HM_09159, RS_AP_00134

virtual ~RecoveryAction () noexcept;

Destructor for RecoveryAction.

Header-Datei#include "ara/phm/recovery_action.h"
Scopeclass ara::phm::RecoveryAction
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_PHM_01145
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_PHM_01145@rel:R25-11#1e784456
Content hash
1e784456
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_PlatformHealthManagement.pdf#nameddest=SWS_PHM_01145
Status: valid/unmigrated Version: rel:R25-11#5718b75e Versionshistorie & Revisions (1 transition, 7 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_PHM_01145@rel:R25-11#5718b75e
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#bddb59f42026-09-30
  • R20-11rel:R20-11#a25806312026-10-14
  • R21-11rel:R21-11#a25806312026-10-14
  • R22-11rel:R22-11#f9931f022026-10-14
  • R23-11rel:R23-11#d1de17222026-10-14
  • R24-11rel:R24-11#f734134e2026-10-14
  • R25-11rel:R25-11#5718b75e2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill