DEENESPTFRRUARHIKOZHNL

فئة ara::crypto::cryp::WriteableKeySlot

[SWS_CRYPT_50166] Upstream: RS_CRYPTO_02405

class WriteableKeySlot :             public KeySlot {...};

WriteableKeySlot interface representing a writeable storage location for a key in a Crypto Provider.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::cryp
Basisklasse(n)KeySlot

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

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

تُستخدم كواجهة قابلة للكتابة لإدارة المفاتيح ومسحها بشكل آمن في موفر تشفير (Crypto-Provider).

تُستخدم الواجهة ara::crypto::cryp::WriteableKeySlot في AUTOSAR Adaptive كتجريد قابل للكتابة لمواضع تخزين المفاتيح في موفر تشفير (Crypto-Provider). لا يمكن نسخ الحالات أو نقلها ([SWS_CRYPT_50170]، [SWS_CRYPT_50168])، بل تتم الإشارة إليها عبر نوع المؤشر الذكي Sptr [SWS_CRYPT_50172]. وعبر الطريقة الآمنة بالنسبة للخيوط Clear()، يتم مسح محتوى موضع المفتاح، مع تفعيل دلالات التراجع (Rollback) في حالة حدوث خطأ مثل kBusyResource أو kUnsupported [SWS_CRYPT_30405].

السياق

تحدد الواجهة ara::crypto::cryp::WriteableKeySlot ضمن AUTOSAR Adaptive Platform موضع تخزين قابلاً للكتابة لمفاتيح التشفير في سياق موفر تشفير (Crypto-Provider). وهي تشتق مباشرة من الواجهة الأساسية KeySlot وتمثل تجريداً قياسياً لمسح مواضع المفاتيح المدارة بشكل موجه والتحكم في دورة حياتها. ويعمل كشركاء تفاعل رئيسيين تطبيقات حزمة التشفير بوصفها مستهلكين، بالإضافة إلى موفر التشفير المحدد الذي يدير الارتباط بمخزن المفاتيح المادي أو المنطقي. ويُفترض أن يتم إنشاء الحالات المحددة عن طريق طرائق مصنعية أو طرائق موفر عليا، نظراً لأن الواجهة تعمل كفئة أساسية مجردة بحتة. سؤال Q-5c3b13bb35c3ff53 (مفتوح)

دورة الحياة

يمنع نموذج الموارد والملكية الخاص بـ ara::crypto::cryp::WriteableKeySlot تماماً تكرار مراجع المفاتيح عبر دلالات القيمة. ولهذا الغرض، تم حذف كل من منشئ النسخ [SWS_CRYPT_50170] ومنشئ النقل [SWS_CRYPT_50171] صراحة (=delete). وبالمثل، تمنع التصريحات المحذوفة لعامل تعيين النسخ [SWS_CRYPT_50168] وعامل تعيين النقل [SWS_CRYPT_50169] أي تعيين لاحق.

يتم التمرير المرجعي والإدارة المشتركة بدلاً من ذلك عبر الاسم المستعار المحدد لنوع المؤشر الذكي Sptr، والمتحقق في صورة std::shared_ptr<WriteableKeySlot> [SWS_CRYPT_50172]. ويتم تأمين إتلاف الحالة بواسطة مدمر افتراضي قياسي محدد على أنه آمن ضد الاستثناءات (exception safe) ولا يطلق استثناءات (noexcept=default) [SWS_CRYPT_50167]. يتيح ذلك التحرير متعدد الأشكال الآمن عبر مؤشرات إلى الواجهة. ومن حيث الحالة، يمكن أن يكون الموضع مشغولاً أو فارغاً. ويُفترض أن يتم شغل الموضع عبر واجهات منفصلة لموفر التشفير، بينما يتحقق الإفراغ عبر الطريقة الآمنة بالنسبة للخيوط Clear() [SWS_CRYPT_30405]. سؤال Q-72dfcb17eb3e2d25 (مفتوح)

keyslot_zustand Leer Leer Leer->Leer Clear() [فارغ بالفعل] Leer->Leer Clear() [kBusyResource / kUnsupported] Belegt Belegt Belegt->Leer Clear() [Erfolg] Belegt->Belegt Clear() [kBusyResource / kUnsupported]

مخطط الحالة: انتقالات حالة محتوى المفتاح من خلال ()Clear ومعالجة الأخطاء. المصادر: [SWS_CRYPT_30405]

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

يركز مسار الاستخدام المركزي على إعادة التعيين المضبوطة أو مسح مادة المفاتيح المخزنة:

  • الإسناد المرجعي: يصل المستدعي إلى الحالة عبر مؤشر مشترك من النوع WriteableKeySlot::Sptr [SWS_CRYPT_50172].
  • استدعاء المسح: من خلال استدعاء الطريقة الافتراضية البحتة Clear()، تبدأ عملية المسح للمحتوى الحالي لموضع المفتاح [SWS_CRYPT_30405]. ونظراً لأن الطريقة آمنة بالنسبة للخيوط، يمكن إجراء الاستدعاء أيضاً في سياقات متزامنة [SWS_CRYPT_30405].
  • التحقق من النتيجة: تُرجع العملية ara::core::Result<void> [SWS_CRYPT_30405]. وإذا كان موضع المفتاح فارغاً بالفعل مسبقاً أو تمت إزالة المحتوى دون أخطاء، فإن النتيجة تمثل حالة نجاح بقيمة فارغة [SWS_CRYPT_30405].

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

تم التصريح عن الطريقة Clear() بأنها آمنة ضد الاستثناءات وnoexcept؛ وتُنقل حالات الخطأ وفقاً لنموذج أخطاء AUTOSAR Adaptive عبر ara::core::Result [SWS_CRYPT_30405]. وتتضمن رموز الخطأ المحتملة:

  • ara::crypto::CryptoErrc::kUnsupported: يحدث عندما لا تدعم الصيغة المحددة لموضع المفتاح عملية المسح [SWS_CRYPT_30405]. وفي هذه الحالة، تضمن الواجهة دلالات التراجع، بحيث تظل الحالة دون تغيير [SWS_CRYPT_30405].
  • ara::crypto::CryptoErrc::kBusyResource: يُرجع إذا تعذر تنفيذ عملية المسح مؤقتاً [SWS_CRYPT_30405]. ويُعزى ذلك عادة إلى الوصول المتزامن إلى موارد التخزين المرتبطة بالعتاد. سؤال (مفتوح) وهنا أيضاً، تضمن دلالات التراجع عدم بقاء أي تغييرات جزئية [SWS_CRYPT_30405].

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

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

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

2
WriteableKeySlot~WriteableKeySlot

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

1
Clear

المعاملات

1
operator=

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

1
Sptr

مخطط الفئة

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

G nara__crypto__cryp__WriteableKeySlot529 WriteableKeySlot + WriteableKeySlot() + operator=() + ~WriteableKeySlot() + Clear() nara__crypto__cryp__KeySlot637 KeySlot nara__crypto__cryp__WriteableKeySlot529->nara__crypto__cryp__KeySlot637

عرض التفاصيل

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

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

WriteableKeySlot دالة 2

Copy-Constructor.

التحميلات الزائدة WriteableKeySlot 2
WriteableKeySlot (const WriteableKeySlot &)=delete; SWS_CRYPT_50170
WriteableKeySlot (WriteableKeySlot &&)=delete; SWS_CRYPT_50171
~WriteableKeySlot دالة

Destructor.

virtual ~WriteableKeySlot () noexcept=default;

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

Clear دالة

The interface shall delete the current content of the KeySlot.

virtual ara::core::Result< void > Clear () const noexcept=0;

المعاملات

operator= دالة 2

Copy-assign another WriteableKeySlot to this instance.

التحميلات الزائدة = 2
WriteableKeySlot & operator= (const WriteableKeySlot &other)=delete; SWS_CRYPT_50168
WriteableKeySlot & operator= (WriteableKeySlot &&other)=delete; SWS_CRYPT_50169

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

Sptr اسم نوع بديل

Smart pointer of the interface.

using Sptr = std::shared_ptr<WriteableKeySlot>;

توثيق الدوال

دالة Clear [SWS_CRYPT_30405] Upstream: RS_CRYPTO_02009

virtual ara::core::Result< void > Clear () const noexcept=0;

The interface shall delete the current content of the KeySlot.

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

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

تُستخدم الطريقة Clear() الخاصة بالواجهة ara::crypto::cryp::WriteableKeySlot لحذف المحتوى الحالي لمخزن المفاتيح المشار إليه [SWS_CRYPT_30405]. يُصرح عن الدالة عبر ملف الرأس ara/crypto/cryp/writeable_keyslot.h وتُستدعى كعملية ثابتة دون معلمات [SWS_CRYPT_30405]. تُرجع بشكل متزامن ara::core::Result<void> فارغة إذا أمكن تفريغ KeySlot بنجاح أو إذا كان فارغًا بالفعل قبل الاستدعاء [SWS_CRYPT_30405].

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

عُرّفت الواجهة بأنها noexcept، وتضمن كلاً من الأمان من الاستثناءات (Exception-Sicherheit) والأمان بالنسبة للخيوط (Thread-Sicherheit) عند الاستدعاء المتزامن [SWS_CRYPT_30405]. في حالة الخطأ، تطبق دلالات التراجع (Rollback) التي تبقي حالة KeySlot دون تغيير [SWS_CRYPT_30405]. يمكن أن تظهر رموز الأخطاء التالية في النتيجة [SWS_CRYPT_30405]:

  • ara::crypto::CryptoErrc::kUnsupported: يحدث مع دلالات التراجع إذا كان KeySlot المحدد لا يدعم الحذف [SWS_CRYPT_30405].
  • ara::crypto::CryptoErrc::kBusyResource: يتم الإبلاغ عنه إذا تعذر تنفيذ العملية حاليًا بسبب انشغال الموارد مؤقتًا [SWS_CRYPT_30405].

تفاعل

تعمل الدالة مباشرة على مثيل ara::crypto::cryp::WriteableKeySlot لتنظيف المفاتيح التشفيرية [SWS_CRYPT_30405]. ويجب تمييز ذلك عن إدارة الشهادات في ara::crypto::x509::X509Provider، حيث يتم تنظيف خانات الشهادات عبر الطريقة ClearCertificateSlot() مع تحديد InstanceSpecifier [SWS_CRYPT_40622].

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

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result if the keyslot was already empty or successfully cleared

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the KeySlot does not support clearing
ara::crypto::CryptoErrc::kBusyResourcerollback_semantics if the operation temporarily cannot be performed

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

Record
AUTOSAR/AP/record/SWS_CRYPT_30405
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_30405@rel:R25-11#02d9abee
Content hash
02d9abee
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_30405
Status: valid/unmigrated Version: rel:R25-11#f254660d 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_CRYPT_30405@rel:R25-11#f254660d
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#3b03ed2b2026-09-30
  • R20-11rel:R20-11#9d3696442026-10-14
  • R21-11rel:R21-11#bda76d622026-10-14
  • R22-11rel:R22-11#006988182026-10-14
  • R23-11rel:R23-11#e7cea4b12026-10-14
  • R24-11rel:R24-11#490dfcff2026-10-14
  • R25-11rel:R25-11#f254660d2026-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

دالة WriteableKeySlot [SWS_CRYPT_50170] Upstream: RS_CRYPTO_02004

WriteableKeySlot (const WriteableKeySlot &)=delete;

Copy-Constructor.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50170
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50170@rel:R25-11#fd6fbc1a
Content hash
fd6fbc1a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50170
Status: valid/unmigrated Version: rel:R25-11#9a69e3b3 Versionshistorie & Revisions (1 transition)
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_CRYPT_50170@rel:R25-11#9a69e3b3
Point-in-Time History:
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

دالة WriteableKeySlot [SWS_CRYPT_50171] Upstream: RS_CRYPTO_02004

WriteableKeySlot (WriteableKeySlot &&)=delete;

Move-Constructor.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50171
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50171@rel:R25-11#86fa7cb7
Content hash
86fa7cb7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50171
Status: valid/unmigrated Version: rel:R25-11#1a7fb0b7 Versionshistorie & Revisions (1 transition)
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_CRYPT_50171@rel:R25-11#1a7fb0b7
Point-in-Time History:
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_CRYPT_50168] Upstream: RS_CRYPTO_02004

WriteableKeySlot & operator= (const WriteableKeySlot &other)=delete;

Copy-assign another WriteableKeySlot to this instance.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50168
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50168@rel:R25-11#7b9bb29a
Content hash
7b9bb29a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50168
Status: valid/unmigrated Version: rel:R25-11#51e3ecf9 Versionshistorie & Revisions (1 transition)
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_CRYPT_50168@rel:R25-11#51e3ecf9
Point-in-Time History:
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_CRYPT_50169] Upstream: RS_CRYPTO_02004

WriteableKeySlot & operator= (WriteableKeySlot &&other)=delete;

Move-assign another WriteableKeySlot to this instance.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50169
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50169@rel:R25-11#7eb9c925
Content hash
7eb9c925
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50169
Status: valid/unmigrated Version: rel:R25-11#05bfa0a2 Versionshistorie & Revisions (1 transition)
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_CRYPT_50169@rel:R25-11#05bfa0a2
Point-in-Time History:
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

دالة ~WriteableKeySlot [SWS_CRYPT_50167] Upstream: RS_CRYPTO_02405

virtual ~WriteableKeySlot () noexcept=default;

Destructor.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50167
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50167@rel:R25-11#5df8db90
Content hash
5df8db90
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50167
Status: valid/unmigrated Version: rel:R25-11#651255bc Versionshistorie & Revisions (1 transition)
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_CRYPT_50167@rel:R25-11#651255bc
Point-in-Time History:
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

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

اسم نوع بديل Sptr [SWS_CRYPT_50172] Upstream: RS_CRYPTO_02405

using Sptr = std::shared_ptr<WriteableKeySlot>;

Smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/writeable_keyslot.h"
Scopeclass ara::crypto::cryp::WriteableKeySlot
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50172
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50172@rel:R25-11#1ca10c3b
Content hash
1ca10c3b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50172
Status: valid/unmigrated Version: rel:R25-11#afe92846 Versionshistorie & Revisions (1 transition)
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_CRYPT_50172@rel:R25-11#afe92846
Point-in-Time History:
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