DEENESPTFRRUARHIKOZHNL

فئة ara::diag::ExternalAuthentication

[SWS_DM_01191] Upstream: RS_Diag_04251

class ExternalAuthentication final {...};

Definition of the ExternalAuthentication class, which is used by the application to receive an instance of the ClientAuthentication Class relevant to the specific client.

Header-Datei#include "ara/diag/external_authentication.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

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

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

يُستخدم لاسترجاع مثيلات المصادقة لإدارة حالة عملاء التشخيص الخارجيين.

تُوفر الفئة ara::diag::ExternalAuthentication واجهة منفذ يستعلم من خلالها تطبيق تكيفي عن مثيلات ara::diag::ClientAuthentication لإدارة حالة مصادقة عملاء التشخيص الخارجيين [SWS_DM_01191]. وبعد الربط بمنفذ خدمة منمذج، يتم طلب كائنات المصادقة بشكل مستهدف من Diagnostic Manager بناءً على عنوان المصدر أو معلومات التعريف [SWS_DM_01200]. يمتلك المثيل دلالات النقل، ويمنع عمليات النسخ، ويتطلب تفكيكًا متزامنًا بسبب عدم أمان دالة الهدم بالنسبة للخيوط.

السياق

تعمل الفئة ara::diag::ExternalAuthentication في AUTOSAR Adaptive Platform كواجهة منفذ لمصادقة عملاء التشخيص الخارجيين [SWS_DM_01191]، AUTOSAR_AP_SWS_Diagnostics §8.17 «Header: ara/diag/external_authentication.h». وعبر هذا المنفذ، يحصل التطبيق التكيفي على وصول إلى مثيلات محددة من ara::diag::ClientAuthentication، والتي تمثل حالة مصادقة عميل التشخيص المعني وتديرها [SWS_DM_01202].

يتم تحديد تخصيص وعدد مثيلات العملاء المتاحة في نموذج البرمجيات عبر العنصر DiagnosticExternalAuthenticationIdentification. ويسمح هذا للتطبيق بتحديد عناوين مصدر ثابتة أو نطاقات عناوين مكوّنة من النوع Address (اسم بديل لـ std::uint16_t [SWS_DM_01192]) لأجهزة فحص التشخيص، إذا كان عنوان المصدر النهائي معروفًا فقط في وقت التشغيل AUTOSAR_AP_SWS_Diagnostics §7.3.2.2 «Get ClientAuthentication Instance».

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

  • التطبيق التكيفي، الذي يُنشئ مثيل المنفذ ويستعلم عن حالات المصادقة.
  • Diagnostic Manager (DM)، الذي يتحكم في اتصالات التشخيص ويدير حالات مصادقة العملاء [SWS_DM_01202].
  • كائنات ara::diag::ClientAuthentication المرتبطة بالعميل الطالب.
  • عميل التشخيص الخارجي، الذي يتم التعرف على اتصاله عبر عنوان المصدر أو معلومات التعريف.
diag_kontext app Adaptive Applikation ext_auth ara::diag::ExternalAuthentication app->ext_auth instanziiert / ruft Get dm Diagnostic Manager ext_auth->dm fragt Zustand an client_auth ara::diag::ClientAuthentication ext_auth->client_auth يوفّر مثيلاً dm->client_auth verwaltet client Externer Diagnose-Client client->dm Diagnoseanfrage

مخطط السياق: دمج فئة المنفذ بين التطبيق، و Diagnostic Manager، ومصادقة العميل. المصادر: [SWS_DM_01191]، [SWS_DM_01202]، AUTOSAR_AP_SWS_Diagnostics §7.3.2.2 «Get ClientAuthentication Instance».

دورة الحياة

يتم إنشاء مثيل ara::diag::ExternalAuthentication صراحةً عن طريق تمرير ara::core::InstanceSpecifier إلى دالة البناء [SWS_DM_01193]. يربط هذا المعرّف الكائن بـ PortPrototype المنمذج لـ DiagnosticExternalAuthenticationInterface.

فيما يتعلق بملكية الموارد، تمتلك الفئة دلالات نقل خالصة: دالة بناء النقل [SWS_DM_01194] وعامل تعيين النقل [SWS_DM_01195] موجودان (default)، بينما دالة بناء النسخ [SWS_DM_01196] وعامل تعيين النسخ [SWS_DM_01197] محذوفان (delete). وبذلك يمثل المنفذ كائن واجهة غير قابل للتجزئة ولا يمكن نسخه.

للتدمير، تتوفر دالة الهدم ~ExternalAuthentication() [SWS_DM_01198]. وفيما يتعلق بالتزامن، تم تحديد دالة البناء ودوال الاستعلام على أنها آمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe) [SWS_DM_01193]، [SWS_DM_01199]، [SWS_DM_01200]، [SWS_DM_01201]. وعلى النقيض من ذلك، فإن دالة الهدم صراحةً ليست آمنة بالنسبة للخيوط (not thread-safe) [SWS_DM_01198]. لذا يجب على التطبيق التأكد من عدم حدوث أي استدعاءات متزامنة قبل تفكيك الكائن.

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

يتضمن التسلسل النموذجي تهيئة المنفذ والاسترجاع اللاحق لكائنات المصادقة:

  1. يُنشئ التطبيق مثيلًا لـ ExternalAuthentication مع تحديد معرّف المثيل [SWS_DM_01193].
  2. يطلب التطبيق مثيل المصادقة لعميل محدد. ولهذا الغرض تتوفر الدوال المحمّلة بشكل زائد Get(Address) باستخدام عنوان جهاز الفحص [SWS_DM_01200] أو Get(const MetaInfo&) استنادًا إلى بيانات التعريف للطلب المستلمة [SWS_DM_01199]. وبدلًا من ذلك، يسترجع عبر GetAll() قائمة بجميع المثيلات التي يديرها Diagnostic Manager حاليًا [SWS_DM_01201].
  3. يُحدد Diagnostic Manager الكائن المقابل ويُعيد ara::core::Result<ClientAuthentication> أو متجهًا [SWS_DM_01202].
  4. يتحقق التطبيق من النتيجة ويتفاعل بعد ذلك مع مثيل ClientAuthentication المستلم، والذي يُرجّح أن يعمل كمقبض من جانب التطبيق لحالة جلسة المصادقة. سؤال Q-e7ddbab981bf21de (مفتوح)
استرداد مثيل ClientAuthenticationApplikationExternalAuthenticationDiagnosticManagerExternalAuthentication(instanceSpecifier)Get(sourceAddress)Authentifizierungszustand anfordernClientAuthentication-Instanzara::core::Result<ClientAuthentication>

مخطط التتابع: تسلسل الاستدعاء النموذجي لإنشاء مثيل والاستعلام عن مثيل ClientAuthentication. المصادر: [SWS_DM_01193]، [SWS_DM_01200]، [SWS_DM_01202].

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

عند إنشاء المثيل عبر دالة البناء، يمكن أن تؤدي أخطاء التكوين والنمذجة إلى انتهاكات محددة [SWS_DM_01193]:

  • InstanceSpecifierMappingIntegrityViolation: يتعذر حل المعرّف في سياق الملف التنفيذي أو أنه لا يشير إلى PortPrototype.
  • PortInterfaceMappingViolation: الـ PortPrototype المُشار إليه ليس محدد النوع كـ DiagnosticExternalAuthenticationInterface.
  • ProcessMappingViolation: لا يوجد تعريف عملية منمذج متوافق لعملية وقت التشغيل.
  • InstanceSpecifierAlreadyInUseViolation: المعرّف مستخدم بالفعل بواسطة مثيل منفذ آخر في نفس العملية.

عند استدعاء Get(const MetaInfo&) أو Get(Address)، يمكن أن تحتوي القيمة المعادة عبر ara::core::Result على رمز الخطأ DiagErrc::kServiceNotAvailable [SWS_DM_01199]، [SWS_DM_01200]. ويشير هذا إلى أن الوظائف الأساسية لـ Diagnostic Manager غير متاحة مؤقتًا. الاستدعاء GetAll() لا يُعيد رمز خطأ عند عدم وجود مثيلات، بل يُعيد متجهًا فارغًا [SWS_DM_01201].

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

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

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

2
ExternalAuthentication~ExternalAuthentication

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

2
GetGetAll

المعاملات

1
operator=

أسماء الأنواع البديلة

1
Address

مخطط الفئة

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

G nara__diag__ExternalAuthentication264 ExternalAuthentication + ExternalAuthentication() + ~ExternalAuthentication() + Get() + GetAll() + operator=()

عرض التفاصيل

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

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

ExternalAuthentication دالة 3

Constructs the port for authentication of diagnostic clients.

التحميلات الزائدة ExternalAuthentication 3
explicit ExternalAuthentication (ara::core::InstanceSpecifier instance Specifier) noexcept; SWS_DM_01193
ExternalAuthentication (ExternalAuthentication &&other) noexcept=default; SWS_DM_01194
ExternalAuthentication (ExternalAuthentication const &other)=delete; SWS_DM_01196
~ExternalAuthentication دالة

Destructor of DiagnosticServiceDynamicAccessList.

~ExternalAuthentication () noexcept;

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

Get دالة 2

This function is used by the application to get the ClientAuthentication Instance that is handling the Authentication State of the Client corresponding to the MetaInfo.

التحميلات الزائدة Get 2
ara::core::Result< ClientAuthentication > Get (const MetaInfo &meta Info) noexcept; SWS_DM_01199
ara::core::Result< ClientAuthentication > Get (Address sourceAddress) noexcept; SWS_DM_01200
GetAll دالة

This function is used by the application to get all the ClientAuthentication Instances that are currently handled by the DM.

ara::core::Vector< ClientAuthentication > GetAll () noexcept;

المعاملات

operator= دالة 2

Move assignment operator of ExternalAuthentication.

التحميلات الزائدة = 2
auto operator= (ExternalAuthentication &&other) & noexcept -> External Authentication & =default; SWS_DM_01195
auto operator= (ExternalAuthentication const &other) -> External Authentication &=delete; SWS_DM_01197

أسماء الأنواع البديلة

Address اسم نوع بديل

Alias for tester address.

using Address = std::uint16_t;

توثيق الدوال

دالة ExternalAuthentication [SWS_DM_01193] Upstream: RS_Diag_04251, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit ExternalAuthentication (ara::core::InstanceSpecifier instance Specifier) noexcept;

Constructs the port for authentication of diagnostic clients.

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

يقوم المُنشئ الصريح [SWS_DM_01193] بتهيئة مثيل لفئة المنفذ ara::diag::ExternalAuthentication [SWS_DM_01191] لمصادقة عملاء التشخيص الخارجيين (SWS Diagnostics §8.17 «Header: ara/diag/external_authentication.h»). وتتوقع الدالة كمعلمة ara::core::InstanceSpecifier، والذي يجب أن يشير إلى PortPrototype مصمم في البيان لمثيل خدمة DiagnosticExternalAuthenticationInterface [SWS_DM_01193].

تم الإعلان عن الاستدعاء المتزامن على أنه noexcept وحُدد على أنه آمن لخيوط المعالجة (thread-safe) وآمن من الاستثناءات (exception-safe) [SWS_DM_01193]. ونظرًا لعدم طرح أي استثناءات، تؤدي أخطاء النمذجة والتهيئة إلى انتهاكات محددة لإطار العمل [SWS_DM_01193]:

  • InstanceSpecifierMappingIntegrityViolation: لا يمكن حل المعرّف في سياق الملف التنفيذي أو أنه يشير إلى عنصر نموذج آخر غير PortPrototype.
  • PortInterfaceMappingViolation: الـ PortPrototype المشار إليه ليس محدد النوع بواسطة DiagnosticExternalAuthenticationInterface.
  • ProcessMappingViolation: لا توجد عملية تشغيل مصممة متوافقة للمرجع.
  • InstanceSpecifierAlreadyInUseViolation: المعرّف مستخدم بالفعل بواسطة مثيل آخر في العملية الحالية.

تم حظر عمليات النسخ صراحةً لـ ExternalAuthentication [SWS_DM_01196] [SWS_DM_01197]، في حين يتم دعم عمليات النقل [SWS_DM_01194] [SWS_DM_01195]. وعلى عكس المُنشئ، فإن المُدمّر المرتبط به ليس آمنًا لخيوط المعالجة [SWS_DM_01198]. وبعد نجاح إنشاء المثيل، يُستخدم الكائن للاستعلام عن مثيلات مصادقة العميل المرتبطة عبر طرق مثل Get أو GetAll [SWS_DM_01201] [SWS_DM_01202].

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

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

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

Parameter (in)

ParameterBeschreibung
instanceSpecifierInstanceSpecifier to a PortPrototype of a DiagnosticExternalAuthenticationInterface service instance in the manifest.

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

Record
AUTOSAR/AP/record/SWS_DM_01193
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01193@rel:R25-11#87107c45
Content hash
87107c45
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01193
Status: valid/unmigrated Version: rel:R25-11#99c49ac2 Versionshistorie & Revisions (1 transition, 6 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_01193@rel:R25-11#99c49ac2
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#3d7cf4e12026-09-30
  • R21-11rel:R21-11#8a71f7dd2026-10-14
  • R22-11rel:R22-11#62844c072026-10-14
  • R23-11rel:R23-11#447ba5db2026-10-14
  • R24-11rel:R24-11#4fb764692026-10-14
  • R25-11rel:R25-11#99c49ac22026-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

دالة ExternalAuthentication [SWS_DM_01194] Upstream: RS_Diag_04251

ExternalAuthentication (ExternalAuthentication &&other) noexcept=default;

Move constructor of ExternalAuthentication.

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherObject to move-construct from

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

Record
AUTOSAR/AP/record/SWS_DM_01194
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01194@rel:R25-11#f0559e53
Content hash
f0559e53
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01194
Status: valid/unmigrated Version: rel:R25-11#56b10148 Versionshistorie & Revisions (1 transition, 6 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_01194@rel:R25-11#56b10148
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#49f971fe2026-09-30
  • R21-11rel:R21-11#5c8f6e4f2026-10-14
  • R22-11rel:R22-11#05f8bd8b2026-10-14
  • R23-11rel:R23-11#503551b52026-10-14
  • R24-11rel:R24-11#de5240aa2026-10-14
  • R25-11rel:R25-11#56b101482026-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

دالة ExternalAuthentication [SWS_DM_01196] Upstream: RS_Diag_04251

ExternalAuthentication (ExternalAuthentication const &other)=delete;

Copy constructor of ExternalAuthentication.

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication

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

Record
AUTOSAR/AP/record/SWS_DM_01196
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01196@rel:R25-11#6e7cc36c
Content hash
6e7cc36c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01196
Status: valid/unmigrated Version: rel:R25-11#28bce7b2 Versionshistorie & Revisions (1 transition, 6 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_01196@rel:R25-11#28bce7b2
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#792beea12026-09-30
  • R21-11rel:R21-11#5ed5ded02026-10-14
  • R22-11rel:R22-11#ef33b0632026-10-14
  • R23-11rel:R23-11#861f734f2026-10-14
  • R24-11rel:R24-11#28bce7b22026-10-14
  • R25-11rel:R25-11#28bce7b22026-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

دالة Get [SWS_DM_01199] Upstream: RS_Diag_04251

ara::core::Result< ClientAuthentication > Get (const MetaInfo &meta Info) noexcept;

This function is used by the application to get the ClientAuthentication Instance that is handling the Authentication State of the Client corresponding to the MetaInfo.

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

تُستخدم الطريقة المتزامنة ara::diag::ExternalAuthentication::Get لتمكين تطبيق تكيفي من استرجاع مثيل ara::diag::ClientAuthentication المسؤول عن طلب تشخيص [SWS_DM_01199]. وتُمرر كمعلمة إشارة مرجعية إلى metaInfo (const ara::diag::MetaInfo&)، والتي توفر بيانات وصفية من سياق طلب التشخيص SWS Diagnostics §7.3.1.1 «MetaInfo class». وتغلف قيمة الإرجاع من النوع ara::core::Result<ClientAuthentication> كائن المصادقة المطابق لإدارة حالة مصادقة العميل [SWS_DM_01202].

إذا حدث خطأ، يحتوي كائن Result المُرجع على كود الخطأ المحدد DiagErrc::kServiceNotAvailable [SWS_DM_01199]. ويشير هذا بدلالات التراجع (Rollback Semantics) إلى تعذر تنفيذ الاستدعاء، نظرًا لعدم توفر وظائف أساسية لـ Diagnostic Manager (DM) في وقت الاستدعاء [SWS_DM_01199].

فيما يتعلق بالتزامن، حُددت الدالة بأنها آمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe) وأُعلن عنها باستخدام noexcept [SWS_DM_01199]. ولذلك يمكن استدعاؤها بأمان من خيوط متوازية دون الحاجة إلى آليات قفل من جانب التطبيق.

تتكامل الطريقة مع المتغير المحمّل تحميلاً زائداً Get(Address sourceAddress) [SWS_DM_01200]، والذي يتيح الاسترداد نفسه مباشرةً عبر عنوان المصدر الخاص بالعميل [SWS_DM_01202]. ويُحدد عدد الحالات (instances) المتاحة بواسطة عناصر النموذج DiagnosticExternalAuthenticationIdentification SWS Diagnostics «Get ClientAuthentication Instance». تفسير: يُرجح أن الدالة تستخلص داخلياً عنوان المصدر المطلوب للتعيين من بيانات النقل المغلفة في metaInfo. سؤال Q-50d416201ccb5825 (مفتوح)

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

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

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
metaInfoMetaInfo of the request.

Rückgabewert

TypBeschreibung
ara::core::Result< ClientAuthentication >Returns the diagnostic client associated authentication object or error.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_01199
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01199@rel:R25-11#37532625
Content hash
37532625
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01199
Status: valid/unmigrated Version: rel:R25-11#0d7aa83d Versionshistorie & Revisions (1 transition, 6 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_01199@rel:R25-11#0d7aa83d
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#d297578c2026-09-30
  • R21-11rel:R21-11#174411bd2026-10-14
  • R22-11rel:R22-11#5765361f2026-10-14
  • R23-11rel:R23-11#5356d12b2026-10-14
  • R24-11rel:R24-11#1ee0d9c92026-10-14
  • R25-11rel:R25-11#0d7aa83d2026-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

دالة Get [SWS_DM_01200] Upstream: RS_Diag_04251

ara::core::Result< ClientAuthentication > Get (Address sourceAddress) noexcept;

This function is used by the application to get the ClientAuthentication Instance that is handling the Authentication State of the Client corresponding to the Address.

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

تُستخدم الطريقة المتزامنة Get للفئة ara::diag::ExternalAuthentication بواسطة تطبيق تكيفي لاسترداد حالة ClientAuthentication التي تدير حالة المصادقة لعميل التشخيص لعنوان المصدر المحدد [SWS_DM_01200]. ويقوم Diagnostic Manager هنا بحل كائن المصادقة المسؤول عبر عنوان المصدر المُمرر [SWS_DM_01202].

يشمل الاستخدام والشروط الحدية الجوانب التالية:

  • الاستدعاء والمعلمات: تُمرر المعلمة sourceAddress من النوع Address [SWS_DM_01200]. ويعتمد التحليل في نموذج النظام على عناصر DiagnosticExternalAuthenticationIdentification المكونة، والتي تحدد عناوين مصدر ثابتة أو نطاقات عناوين SWS Diagnostics ص. 129 «ClientAuthentication». بالإضافة إلى ذلك، يوجد تحميل زائد لـ Get يحدد الحالة عبر كائن MetaInfo [SWS_DM_01199]، [SWS_DM_01202].
  • القيمة المرجعة ومعالجة الأخطاء: تُرجع الدالة ara::core::Result<ClientAuthentication> [SWS_DM_01200]. وإذا تعذر التنفيذ بسبب عدم توفر وظائف أساسية لـ Diagnostic Manager، يُرجع الخطأ DiagErrc::kServiceNotAvailable مع دلالات التراجع (rollback semantics) [SWS_DM_01200].
  • التزامن: حُددت العملية بأنها thread-safe وexception safe وأُعلن عنها باستخدام noexcept، ولهذا السبب يمكن إجراء الاستدعاءات من خيوط متوازية بأمان من حيث الاستثناءات [SWS_DM_01200].

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

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

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
sourceAddressThe source address of the client

Rückgabewert

TypBeschreibung
ara::core::Result< ClientAuthentication >Returns the associated diagnostic client authentication object or error.

Fehler

FehlercodeBeschreibung
DiagErrc::kServiceNotAvailablerollback_semantics The call cannot be executed, because essential DM functionality is currently not available.

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

Record
AUTOSAR/AP/record/SWS_DM_01200
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01200@rel:R25-11#8b7ea2e3
Content hash
8b7ea2e3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01200
Status: valid/unmigrated Version: rel:R25-11#07135c96 Versionshistorie & Revisions (1 transition, 6 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_01200@rel:R25-11#07135c96
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#a78dc7ce2026-09-30
  • R21-11rel:R21-11#f69dcd252026-10-14
  • R22-11rel:R22-11#98dbac742026-10-14
  • R23-11rel:R23-11#7078e40c2026-10-14
  • R24-11rel:R24-11#85f369cf2026-10-14
  • R25-11rel:R25-11#07135c962026-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

دالة GetAll [SWS_DM_01201] Upstream: RS_Diag_04251

ara::core::Vector< ClientAuthentication > GetAll () noexcept;

This function is used by the application to get all the ClientAuthentication Instances that are currently handled by the DM.

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

الاستخدام

تُستخدم الطريقة GetAll للفئة ara::diag::ExternalAuthentication (ملف الرأس ara/diag/external_authentication.h) بواسطة التطبيقات للاستعلام بشكل متزامن عن جميع حالات ClientAuthentication المدارة حالياً بواسطة Diagnostic Manager [SWS_DM_01201]، [SWS_DM_01203]. ويتم الاستدعاء بدون معلمات ويُرجع ara::core::Vector<ClientAuthentication> يحتوي على جميع كائنات المصادقة المعينة [SWS_DM_01201].

معالجة الأخطاء وقيم الإرجاع

أُعلن عن الدالة بأنها آمنة من الاستثناءات (exception safe) وnoexcept [SWS_DM_01201]. ولا توجد رموز خطأ محددة أو رسائل إلى DET أو DEM لهذه الواجهة. وإذا لم تكن هناك كائنات مصادقة متاحة، فلا يُعامل ذلك كخطأ، بل تُرجع الطريقة متجهاً فارغاً [SWS_DM_01201].

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

تُبين المواصفة أن GetAll آمنة بالنسبة للخيوط (thread-safe) [SWS_DM_01201]. تفسير: يُرجح بالتالي أن الاستدعاءات من خيوط تطبيق متوازية متعددة مسموح بها دون مزامنة إضافية من جانب التطبيق. سؤال Q-9f26d94068ebd3fe (مفتوح)

تفاعل

تتوافق مجموعة الحالات القابلة للاسترداد مع عناصر النموذج المكونة من النوع DiagnosticExternalAuthenticationIdentification، والتي تحدد عناوين مصدر ثابتة أو نطاقات عناوين AUTOSAR_AP_SWS_Diagnostics ص. 129. وبينما توفر GetAll مجمل جميع الحالات [SWS_DM_01203]، تتيح الطريقة Get الاستعلام المستهدف لعنوان مصدر معين أو معلومات وصفية [SWS_DM_01202].

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

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

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Vector< ClientAuthentication >Returns the list of all diagnostic client associated authentication objects or empty list if none available.

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

Record
AUTOSAR/AP/record/SWS_DM_01201
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01201@rel:R25-11#5667c238
Content hash
5667c238
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01201
Status: valid/unmigrated Version: rel:R25-11#2912f80f Versionshistorie & Revisions (1 transition, 6 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_01201@rel:R25-11#2912f80f
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#9941b3c92026-09-30
  • R21-11rel:R21-11#e12087182026-10-14
  • R22-11rel:R22-11#e977abb02026-10-14
  • R23-11rel:R23-11#6f409f582026-10-14
  • R24-11rel:R24-11#32e7f4b12026-10-14
  • R25-11rel:R25-11#2912f80f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_DM_01195] Upstream: RS_Diag_04251

auto operator= (ExternalAuthentication &&other) & noexcept -> External Authentication & =default;

Move assignment operator of ExternalAuthentication.

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherObject to move-assign from.

Rückgabewert

TypBeschreibung
ExternalAuthenticationExternalAuthentication& Reference to self.

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

Record
AUTOSAR/AP/record/SWS_DM_01195
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01195@rel:R25-11#8dde83cc
Content hash
8dde83cc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01195
Status: valid/unmigrated Version: rel:R25-11#6803e422 Versionshistorie & Revisions (1 transition, 6 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_01195@rel:R25-11#6803e422
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#8f6e23102026-09-30
  • R21-11rel:R21-11#e0a59cdb2026-10-14
  • R22-11rel:R22-11#2ba590ba2026-10-14
  • R23-11rel:R23-11#d39a0d602026-10-14
  • R24-11rel:R24-11#542712952026-10-14
  • R25-11rel:R25-11#6803e4222026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة operator= [SWS_DM_01197] Upstream: RS_Diag_04251

auto operator= (ExternalAuthentication const &other) -> External Authentication &=delete;

Copy assignment operator of ExternalAuthentication.

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication

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

Record
AUTOSAR/AP/record/SWS_DM_01197
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01197@rel:R25-11#ff1f29c1
Content hash
ff1f29c1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01197
Status: valid/unmigrated Version: rel:R25-11#09d1b83a Versionshistorie & Revisions (1 transition, 6 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_01197@rel:R25-11#09d1b83a
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#6d1027ba2026-09-30
  • R21-11rel:R21-11#9521bdc82026-10-14
  • R22-11rel:R22-11#f4eeab222026-10-14
  • R23-11rel:R23-11#3efeb14e2026-10-14
  • R24-11rel:R24-11#09d1b83a2026-10-14
  • R25-11rel:R25-11#09d1b83a2026-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

دالة ~ExternalAuthentication [SWS_DM_01198] Upstream: RS_Diag_04251

~ExternalAuthentication () noexcept;

Destructor of DiagnosticServiceDynamicAccessList.

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

يُنهي المُتلف ~ExternalAuthentication() دورة حياة مثيل للفئة ara::diag::ExternalAuthentication من ملف الترويسة ara/diag/external_authentication.h [SWS_DM_01198]. ويتم تنفيذه بشكل متزامن عند مغادرة نطاق الصلاحية (Scope) أو عند تحرير الكائن، ولا يتطلب أي معلمات تمرير وليس له قيمة إرجاع AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 «Destructor».

فيما يتعلق بمعالجة الأخطاء، زُوِّدت الدالة بالمحدد noexcept وعُرِّفت رسميًا بأنها آمنة ضد الاستثناءات (exception safe) [SWS_DM_01198]. وبالتالي يضمن الاستدعاء في حالة حدوث خطأ عدم مقاطعة عملية الإتلاف بواسطة أي استثناءات C++ أو تمريرها إلى المتصل.

فيما يخص التزامن والقيود، ينبغي مراعاة أن المُتلف محدد بأنه غير آمن لمؤشرات الترابط (not thread-safe) [SWS_DM_01198]. لذا يجب على المكونات المستدعية التأكد من عدم حدوث أي وصول متزامن عبر مؤشرات ترابط منفصلة إلى المثيل نفسه لـ ara::diag::ExternalAuthentication أثناء عملية الإتلاف. ويُفترض أنه ينبغي إنهاء جميع عمليات التشخيص والمصادقة النشطة لهذا المثيل بالكامل قبل الاستدعاء لتجنب الوصول غير المنسق إلى الذاكرة. سؤال Q-67c112ea87f722d2 (مفتوح)

في السياق الوظيفي، تحقق الواجهة المتطلب الشامل RS_Diag_04251 لإدارة التشخيص (DM) AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 «Destructor». ومن المرجح أن يكون التوصيف الجدولي كـ مُتلف لـ Dynamic-Access-List عدم دقة تحريرية في المواصفة، نظرًا لأن النطاق ومساحة الاسم يحددان الارتباط بـ ExternalAuthentication [SWS_DM_01198]. سؤال Q-30744aac322624cb (مفتوح)

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

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

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

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

Record
AUTOSAR/AP/record/SWS_DM_01198
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01198@rel:R25-11#724e0cea
Content hash
724e0cea
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01198
Status: valid/unmigrated Version: rel:R25-11#fb78e709 Versionshistorie & Revisions (1 transition, 6 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_01198@rel:R25-11#fb78e709
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#2976e59f2026-09-30
  • R21-11rel:R21-11#0b0d79932026-10-14
  • R22-11rel:R22-11#c93ef83d2026-10-14
  • R23-11rel:R23-11#95e746bb2026-10-14
  • R24-11rel:R24-11#8f8b55132026-10-14
  • R25-11rel:R25-11#fb78e7092026-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

توثيق أسماء الأنواع البديلة

اسم نوع بديل Address [SWS_DM_01192] Upstream: RS_Diag_04251

using Address = std::uint16_t;

Alias for tester address.

Header-Datei#include "ara/diag/external_authentication.h"
Scopeclass ara::diag::ExternalAuthentication
SymbolAddress

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

Record
AUTOSAR/AP/record/SWS_DM_01192
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01192@rel:R25-11#cc95743d
Content hash
cc95743d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01192
Status: valid/unmigrated Version: rel:R25-11#14b59998 Versionshistorie & Revisions (1 transition, 6 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_01192@rel:R25-11#14b59998
Point-in-Time History:
Recorded Revisions (6):
  • R25-11rel:R25-11#4c1ad19b2026-09-30
  • R21-11rel:R21-11#5e4deeca2026-10-14
  • R22-11rel:R22-11#b896dce62026-10-14
  • R23-11rel:R23-11#14b599982026-10-14
  • R24-11rel:R24-11#5bcc7f9a2026-10-14
  • R25-11rel:R25-11#14b599982026-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