فئة ara::crypto::cryp::RandomGeneratorCtx

[SWS_CRYPT_22900] Upstream: RS_CRYPTO_02206

class RandomGeneratorCtx :               public CryptoContext {...};

Interface of Random Number Generator Context.

Header-Datei	#include "ara/crypto/cryp/random_generator_ctx.h"
Forwarding-Header	#include "ara/crypto/crypto_fwd.h"
Scope	namespace ara::crypto::cryp
Basisklasse(n)	CryptoContext

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

يُنشئ بيانات عشوائية تشفيرية ويدير حالة المولد الداخلية وتزويده بالاعتلاج.

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

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

يُنشئ بيانات عشوائية تشفيرية ويدير حالة المولد الداخلية وتزويده بالاعتلاج.

توفر الواجهة ara::crypto::cryp::RandomGeneratorCtx سياقاً آمناً خيطياً لإنشاء أرقام شبه عشوائية في مخازن مؤقتة مجهزة [SWS_CRYPT_22915]. وتبعاً لتنفيذ السياق، يجب تهيئة حالة المولد الداخلية مسبقاً عبر Seed باستخدام بيانات الاعتلاج أو المفاتيح ([SWS_CRYPT_22911]، [SWS_CRYPT_22912]). وفي حالة غياب التهيئة أو استنفاد مخزون الاعتلاج، تُقر دالة التوليد الاستدعاء برموز الأخطاء القياسية المقابلة [SWS_CRYPT_22915].

السياق

تُعرّف الواجهة ara::crypto::cryp::RandomGeneratorCtx السياق التشفيري لمولدات الأرقام العشوائية داخل وحدة Adaptive crypto. وتعمل الفئة، كتخصيص لـ CryptoContext، على توليد متتاليات شبه عشوائية آمنة تشفيرياً، بالإضافة إلى إدارة الحالة الداخلية للمولد. وعادةً ما تصل خدمات التطبيق إلى مثيلات هذه الواجهة للحصول على مادة المفاتيح أو متجهات التهيئة أو القيم العشوائية للبروتوكولات ذات الصلة بالأمان. ويتم توفير مثيلات السياق وتبادلها بشكل أساسي عبر مؤشرات ذكية مشتركة، والتي يتوفر لها الاسم المستعار للنوع Sptr [SWS_CRYPT_22901].

دورة الحياة

تتم إدارة دورة حياة سياق مولد الأرقام العشوائية عبر عد المراجع بواسطة std::shared_ptr ([SWS_CRYPT_22901]). وبعد إنشاء المثيل، يكون المولد، اعتماداً على التنفيذ الأساسي، إما في حالة جاهزة للاستخدام بالفعل أو يتطلب تهيئة مسبقة بواسطة التطبيق. وتُستخدم الدالة Seed لتهيئة حالة المولد الداخلية، ويتم تزويدها إما بنطاق ذاكرة خام عبر ReadOnlyMemRegion [SWS_CRYPT_22911] أو بكائن مفتاح متماثل من النوع SymmetricKey::Sptr [SWS_CRYPT_22912]. وتم الإعلان عن جميع الدوال الأعضاء المركزية (Seed وAddEntropy وGenerate) وفقاً للمواصفة بأنها آمنة ضد الاستثناءات (noexcept) وآمنة خيطياً ([SWS_CRYPT_22911]، [SWS_CRYPT_22912]، [SWS_CRYPT_22914]، [SWS_CRYPT_22915])، مما يتيح دعم الاستدعاءات المتوازية من خيوط متعددة دون قفل داخلي على مستوى التطبيق.

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

يتضمن تسلسل الاستخدام المعتاد إعداد حالة المولد، وخلط مزيد من الاعتلاج اختيارياً، يليه استرداد البيانات العشوائية:

تهيئة الحالة (توليد البذرة): إذا كان السياق يتطلب توليد بذرة بواسطة المستدعي، يتم تنفيذ Seed باستخدام بيانات الاعتلاج [SWS_CRYPT_22911] أو مفتاح متماثل [SWS_CRYPT_22912]. وإذا كان التنفيذ مستنداً إلى عتاد أو مهيأً بشكل ثابت ولا يدعم توليد البذرة، فإن الاستدعاء يفشل.
خلط اعتلاج إضافي: عبر AddEntropy [SWS_CRYPT_22914]، يمكن إثراء الحالة الداخلية أثناء وقت التشغيل باعتلاج تم الحصول عليه حديثاً (يُمرر كـ ReadOnlyMemRegion).
توليد متتالية عشوائية: تملأ الدالة Generate [SWS_CRYPT_22915] المخزن المؤقت للإخراج الممرر ReadWriteMemRegion ببيانات شبه عشوائية.

مخطط تسلسلي: التسلسل النموذجي لتهيئة الحالة، وتزويد الاعتلاج، والتوليد العشوائي في RandomGeneratorCtx. المصادر: [SWS_CRYPT_22911]، [SWS_CRYPT_22912]، [SWS_CRYPT_22914]، [SWS_CRYPT_22915]

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

تُرجع العمليات نتائجها في ara::core::Result وتمتلك دلالات تراجع محددة عند حدوث أخطاء:

سياق غير مهيأ: إذا استدعى التطبيق Generate على الرغم من أن السياق يتطلب حتماً توليد البذرة مسبقاً، فإن العملية تفشل مع ara::crypto::CryptoErrc::kUninitializedContext [SWS_CRYPT_22915].
نقص الإنتروبيا: إذا تعذر على السياق توليد كمية البايت المطلوبة مؤقتًا بسبب استنفاد مجمع الإنتروبيا الداخلي، يُبلغ Generate عن الخطأ ara::crypto::CryptoErrc::kBusyResource [SWS_CRYPT_22915]. وفي هذه الحالة، يمكن للتطبيق إعادة محاولة الاستدعاء في وقت لاحق أو إجراء بذر إضافي.
استخدام غير مسموح به للمفتاح: إذا مُرِّر SymmetricKey عند Seed ولم تكن حقوق الاستخدام المهيأة الخاصة به تتضمن الراية kAllowRngInit، يُرفض الاستدعاء مع ara::crypto::CryptoErrc::kUsageViolation [SWS_CRYPT_22912].
وظيفة غير مدعومة: إذا كان تطبيق سياق محدد لا يدعم تعيين البذرة أو الخلط اللاحق للإنتروبيا لأسباب من حيث المبدأ، يُقر Seed ([SWS_CRYPT_22911]، [SWS_CRYPT_22912]) وAddEntropy [SWS_CRYPT_22914] بذلك عبر رمز الخطأ ara::crypto::CryptoErrc::kUnsupported.

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

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

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

AddEntropy Generate Seed

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

Sptr

مخطط الفئة

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

عرض التفاصيل

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

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

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

AddEntropy دالة

Update the internal state of the RNG by mixing it with the provided additional entropy.

virtual ara::core::Result< void > AddEntropy (ReadOnlyMemRegion entropy) noexcept=0;

Generate دالة

Fill the provided output buffer with a (pseudo)random sequence.

virtual ara::core::Result< void > Generate (ReadWriteMemRegion output) noexcept=0;

Seed دالة 2

Set the internal state of the RNG using the provided seed.

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

virtual ara::core::Result< void > Seed (ReadOnlyMemRegion seed) noexcept=0; SWS_CRYPT_22911

virtual ara::core::Result< void > Seed (SymmetricKey::Sptr seed) noexcept=0; SWS_CRYPT_22912

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

Sptr اسم نوع بديل

Shared smart pointer of the interface.

using Sptr = std::shared_ptr<RandomGeneratorCtx>;

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

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

توثيق الدوال

دالة AddEntropy [SWS_CRYPT_22914] Upstream: RS_CRYPTO_02206

virtual ara::core::Result< void > AddEntropy (ReadOnlyMemRegion entropy) noexcept=0;

Update the internal state of the RNG by mixing it with the provided additional entropy.

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

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

تُستخدم الطريقة AddEntropy من الفئة ara::crypto::cryp::RandomGeneratorCtx لتحديث الحالة الداخلية لمولد الأرقام العشوائية (RNG) عبر خلط قيم إنتروبيا ممررة إضافية [SWS_CRYPT_22914]. يتوفر التصريح عبر ملف الرأس ara/crypto/cryp/random_generator_ctx.h [SWS_CRYPT_22914]. كمعلمة دخل، تتوقع الدالة كائنًا من النوع ReadOnlyMemRegion باسم entropy، والذي يغلف نطاق الذاكرة الذي يحتوي على قيمة الإنتروبيا المراد إضافتها [SWS_CRYPT_22914].

يُنفذ الاستدعاء بشكل متزامن (تفسير: تُرجع الواجهة النتيجة مباشرة دون نوع نتيجة غير متزامن). سؤال Q-6e56e1daaa526bf8 (مفتوح) تُرجع النتيجة كـ ara::core::Result<void>، وتكون فارغة في حالة النجاح إذا كانت الطريقة مدعومة وأمكن خلط الإنتروبيا بنجاح [SWS_CRYPT_22914]. أما إذا كان سياق مولد الأرقام العشوائية المحدد لا يدعم إضافة الإنتروبيا، فإن الاستدعاء يفشل ويُرجع رمز الخطأ ara::crypto::CryptoErrc::kUnsupported مع ضمان دلالات التراجع (Rollback) [SWS_CRYPT_22914].

فيما يتعلق بالتزامن والأمان ضد الأخطاء، حُددت الواجهة بأنها آمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe)، ومزودة بالمعرّف noexcept [SWS_CRYPT_22914]. بالتالي، يمكن للمستدعين استدعاء الدالة بأمان من عدة خيوط معالجة، ولكن ينبغي دائمًا تقييم ara::core::Result المُرجعة لمعالجة عدم دعم تغذية الإنتروبيا في السياق المعني [SWS_CRYPT_22914].

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

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

Header-Datei	#include "ara/crypto/cryp/random_generator_ctx.h"
Scope	class ara::crypto::cryp::RandomGeneratorCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
entropy	a memory region with the additional entropy value

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	a result that is empty if the method is supported and the entropy has been added successfully, an error otherwise

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the RandomGeneratorContext does not support adding entropy.

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

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

Status: valid/unmigrated Version: rel:R25-11#03de5ab1 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_22914@rel:R25-11#03de5ab1

Recorded Revisions (7):

R25-11rel:R25-11#c67920852026-09-30
R20-11rel:R20-11#79cd0e4d2026-10-14
R21-11rel:R21-11#79cd0e4d2026-10-14
R22-11rel:R22-11#ac415c9e2026-10-14
R23-11rel:R23-11#0440a4ee2026-10-14
R24-11rel:R24-11#75d73d2c2026-10-14
R25-11rel:R25-11#03de5ab12026-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

دالة Generate [SWS_CRYPT_22915] Upstream: RS_CRYPTO_02206

virtual ara::core::Result< void > Generate (ReadWriteMemRegion output) noexcept=0;

Fill the provided output buffer with a (pseudo)random sequence.

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

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

تُستخدم الدالة Generate الخاصة بالواجهة ara::crypto::cryp::RandomGeneratorCtx لملء ذاكرة تخزين مؤقت مقدمة للإخراج بتسلسل عشوائي (أو شبه عشوائي) [SWS_CRYPT_22915]. كمعلمة تمرير، تقبل الطريقة نطاق الذاكرة القابل للكتابة output من النوع ReadWriteMemRegion، والذي تُكتب فيه البايتات العشوائية المولدة مباشرة [SWS_CRYPT_22915].

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

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

يشير نوع الإرجاع ara::core::Result<void> إلى نجاح العملية من خلال نتيجة فارغة، أو يُرجع في حالة الخطأ رمز خطأ مطابقًا مع دلالات التراجع (Rollback) [SWS_CRYPT_22915]:

ara::crypto::CryptoErrc::kUninitializedContext: يحدث إذا كان السياق يتطلب تهيئة مسبقة أو تزويدًا بالإنتروبيا («seeded») بواسطة التطبيق [SWS_CRYPT_22915].
ara::crypto::CryptoErrc::kBusyResource: يُرجع عندما تنفد الإنتروبيا حاليًا من السياق («out-of-entropy»)، وبالتالي لا يمكنه توفير المقدار المطلوب من البايتات العشوائية [SWS_CRYPT_22915].

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

بينما تكتب RandomGeneratorCtx::Generate بايتات بيانات عشوائية خام في ذاكرة التخزين المؤقت [SWS_CRYPT_22915]، توجد في الوحدة crypt دوال توليد أخرى ذات تركيز مختلف: حيث تُستخدم CryptoProvider::GenerateSymmetricKey [SWS_CRYPT_20721] لإنشاء مفاتيح متماثلة، وتُستخدم CryptoProvider::GeneratePrivateKey [SWS_CRYPT_20722] لتوليد أزواج مفاتيح غير متماثلة. علاوة على ذلك، لا ينبغي الخلط بين هذه الطريقة والدالة التي تحمل الاسم نفسه Generate الخاصة بـ MessageAuthnCodeCtx، والتي تُستخدم لحساب خلاصة MAC [SWS_CRYPT_50029].

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

Header-Datei	#include "ara/crypto/cryp/random_generator_ctx.h"
Scope	class ara::crypto::cryp::RandomGeneratorCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (out)

Parameter	Beschreibung
output	an output buffer the random sequence will be written into

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	an empty result on success or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUninitializedContext	rollback_semantics if this context has to be seeded by the application
ara::crypto::CryptoErrc::kBusyResource	rollback_semantics if this context is currently out-of-entropy and therefore cannot provide the requested number of random bytes

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

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

Status: valid/unmigrated Version: rel:R25-11#3fb7d1d3 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_22915@rel:R25-11#3fb7d1d3

Recorded Revisions (7):

R25-11rel:R25-11#f3af431f2026-09-30
R20-11rel:R20-11#2366a0852026-10-14
R21-11rel:R21-11#c128f5042026-10-14
R22-11rel:R22-11#8d39094f2026-10-14
R23-11rel:R23-11#31b6da982026-10-14
R24-11rel:R24-11#a6d941df2026-10-14
R25-11rel:R25-11#3fb7d1d32026-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

دالة Seed [SWS_CRYPT_22911] Upstream: RS_CRYPTO_02206

virtual ara::core::Result< void > Seed (ReadOnlyMemRegion seed) noexcept=0;

Set the internal state of the RNG using the provided seed.

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

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

الاستخدام

تُستخدم الدالة الافتراضية الصرفة Seed للواجهة ara::crypto::cryp::RandomGeneratorCtx لضبط الحالة الداخلية لمولد الأرقام العشوائية (RNG) عبر نطاق ذاكرة متوفر [SWS_CRYPT_22911]. ويتم التصريح في الترويسة ara/crypto/cryp/random_generator_ctx.h بالتوقيع virtual ara::core::Result<void> Seed(ReadOnlyMemRegion seed) noexcept = 0; [SWS_CRYPT_22911].

تستقبل الدالة المتزامنة كمعلمة إدخال seed من النوع ReadOnlyMemRegion، والذي يحتوي على نطاق الذاكرة بقيمة البذرة (Seed) [SWS_CRYPT_22911]. وعند التنفيذ الناجح وتوفر الدعم من السياق، تُرجع الدالة ara::core::Result<void> فارغاً [SWS_CRYPT_22911].

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

في حالة حدوث خطأ، يحتوي ara::core::Result المُرجع على رمز خطأ ملائم [SWS_CRYPT_22911]:

ara::crypto::CryptoErrc::kUnsupported: تحدث إذا كان RandomGeneratorCtx المحدد لا يدعم توليد البذرة (Seeding)؛ وقد تم تحديد دلالات التراجع لحالة الخطأ هذه [SWS_CRYPT_22911].

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

تم التصريح عن الواجهة كـ noexcept وتصنيفها فيما يتعلق بأمان التنفيذ على أنها exception safe وكذلك thread-safe [SWS_CRYPT_22911].

تفاعل

استكمالاً لهذه الدالة القائمة على نطاق الذاكرة، يحدد [SWS_CRYPT_22912] تحميلاً زائداً Seed(SymmetricKey::Sptr seed)، والذي يهيئ حالة RNG باستخدام مفتاح متماثل ويقيّم قيود الاستخدام مثل kAllowRngInit أثناء ذلك.

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

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

Header-Datei	#include "ara/crypto/cryp/random_generator_ctx.h"
Scope	class ara::crypto::cryp::RandomGeneratorCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
seed	a memory region with the seed value

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	a result that is empty if the method is supported and the state has been set successfully, an error otherwise

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the RandomGeneratorContext does not support seeding.

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

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

Status: valid/unmigrated Version: rel:R25-11#2bcb8016 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_CRYPT_22911@rel:R25-11#2bcb8016

Recorded Revisions (8):

R25-11rel:R25-11#9fb457fe2026-09-30
R19-11rel:R19-11#193a3e4f2026-10-14
R20-11rel:R20-11#78f96a302026-10-14
R21-11rel:R21-11#78f96a302026-10-14
R22-11rel:R22-11#fba8b4f92026-10-14
R23-11rel:R23-11#95e124962026-10-14
R24-11rel:R24-11#3e5b43f12026-10-14
R25-11rel:R25-11#2bcb80162026-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

دالة Seed [SWS_CRYPT_22912] Upstream: RS_CRYPTO_02206

virtual ara::core::Result< void > Seed (SymmetricKey::Sptr seed) noexcept=0;

Set the internal state of the RNG using the provided seed.

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

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

تهيئ الطريقة Seed الحالة الداخلية لمولد أرقام عشوائية في سياق ara::crypto::cryp::RandomGeneratorCtx باستخدام مفتاح متماثل [SWS_CRYPT_22912]. ويتم الاستدعاء بشكل متزامن، وهو محدد بأنه آمن خيطيًا وآمن من الاستثناءات (exception safe وnoexcept) [SWS_CRYPT_22912]. ويُستخدم مؤشر ذكي إلى مفتاح (SymmetricKey::Sptr) كمعلمة إدخال، وتُعتمد قيمة مفتاحه كقيمة ابتدائية (Seed) [SWS_CRYPT_22912].

عند معالجة الأخطاء، ترجع الدالة ara::core::Result<void>، والذي يكون فارغًا في حالة النجاح [SWS_CRYPT_22912]. وإذا فشلت العملية، يُطبق أسلوب دلالي للتراجع؛ ويؤثر هذا بوجه خاص على رموز الأخطاء التالية:

ara::crypto::CryptoErrc::kUsageViolation: يحدث عندما لا يتضمن الاستخدام المسموح به للمفتاح الممرر الراية kAllowRngInit [SWS_CRYPT_22912].
ara::crypto::CryptoErrc::kUnsupported: يُبلّغ عنه عندما لا يدعم مثيل السياق الفعلي تعيين قيمة ابتدائية (Seed) بواسطة مفتاح متماثل [SWS_CRYPT_22912].

في إطار التفاعل مع عائلة الواجهات، تمثل هذه الدالة المتغير المعتمد على المفتاح، بينما يغطي التحميل الزائد وفقًا لـ [SWS_CRYPT_22911] التهيئة عبر نطاق ذاكرة غير مهيكل (ReadOnlyMemRegion). وبسبب الأسلوب الدلالي للتراجع، تظل الحالة الداخلية للمولد في حالة حدوث خطأ في حالتها السابقة على الأرجح (تفسير). سؤال Q-970cbedd1843b26a (مفتوح)

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

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

Header-Datei	#include "ara/crypto/cryp/random_generator_ctx.h"
Scope	class ara::crypto::cryp::RandomGeneratorCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
seed	a SymmetricKey with the key used as seed value

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	a result that is empty if the method is supported and the state has been set successfully, an error otherwise

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowRngInit
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the RandomGeneratorContext does not support seeding with a symmetric key.

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

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

Status: valid/unmigrated Version: rel:R25-11#54e43b09 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_22912@rel:R25-11#54e43b09

Recorded Revisions (7):

R25-11rel:R25-11#0427c1122026-09-30
R20-11rel:R20-11#5aeacae82026-10-14
R21-11rel:R21-11#5c22d3612026-10-14
R22-11rel:R22-11#1850986c2026-10-14
R23-11rel:R23-11#93854cda2026-10-14
R24-11rel:R24-11#ed5981cb2026-10-14
R25-11rel:R25-11#54e43b092026-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

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

اسم نوع بديل Sptr [SWS_CRYPT_22901] Upstream: RS_CRYPTO_02206

using Sptr = std::shared_ptr<RandomGeneratorCtx>;

Shared smart pointer of the interface.

Header-Datei	#include "ara/crypto/cryp/random_generator_ctx.h"
Scope	class ara::crypto::cryp::RandomGeneratorCtx
Symbol	Sptr

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

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

Status: valid/unmigrated Version: rel:R25-11#7a09160c 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_CRYPT_22901@rel:R25-11#7a09160c

Recorded Revisions (8):

R25-11rel:R25-11#27c190352026-09-30
R19-11rel:R19-11#3a4f19922026-10-14
R20-11rel:R20-11#79345f482026-10-14
R21-11rel:R21-11#a390f4732026-10-14
R22-11rel:R22-11#7a7cdbaa2026-10-14
R23-11rel:R23-11#df7bd4af2026-10-14
R24-11rel:R24-11#c6c47a032026-10-14
R25-11rel:R25-11#7a09160c2026-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::crypto::cryp::RandomGeneratorCtx

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

السياق

دورة الحياة

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

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

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

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

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

مخطط الفئة

عرض التفاصيل

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

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

توثيق الدوال

دالة AddEntropy [SWS_CRYPT_22914] Upstream: RS_CRYPTO_02206

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Generate [SWS_CRYPT_22915] Upstream: RS_CRYPTO_02206

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

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

Parameter (out)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Seed [SWS_CRYPT_22911] Upstream: RS_CRYPTO_02206

الاستخدام

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

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

تفاعل

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة Seed [SWS_CRYPT_22912] Upstream: RS_CRYPTO_02206

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

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

اسم نوع بديل Sptr [SWS_CRYPT_22901] Upstream: RS_CRYPTO_02206

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: