类 ara::crypto::cryp::RandomGeneratorCtx

类 ara::crypto::cryp::RandomGeneratorCtx 的方法 AddEntropy 用于通过混入额外传入的熵值来更新随机数生成器（RNG）的内部状态 [SWS_CRYPT_22914]。该声明可通过头文件 ara/crypto/cryp/random_generator_ctx.h 获取 [SWS_CRYPT_22914]。作为输入参数，该函数期望名为 entropy、类型为 ReadOnlyMemRegion 的对象，该对象封装了包含待添加熵值的内存区域 [SWS_CRYPT_22914]。

该调用同步执行（解释：接口直接返回结果，没有异步结果类型）。 问题 Q-6e56e1daaa526bf8 (未决)结果作为 ara::core::Result<void> 返回，当方法受支持且成功混入熵时，成功情况下该结果为空 [SWS_CRYPT_22914]。相反，如果具体的随机数生成器上下文不支持添加熵，则调用失败并返回具有保证回滚语义的错误码 ara::crypto::CryptoErrc::kUnsupported [SWS_CRYPT_22914]。

在并发性和故障安全性方面，该接口被指定为线程安全（thread-safe）以及异常安全（exception safe），并带有标识符 noexcept [SWS_CRYPT_22914]。因此，调用方可以安全地从多个线程调用该函数，但应始终评估返回的 ara::core::Result，以捕获相应上下文中缺少对熵注入支持的情况 [SWS_CRYPT_22914]。

接口 ara::crypto::cryp::RandomGeneratorCtx 的函数 Generate 用于使用（伪）随机序列填充提供的输出缓冲区 [SWS_CRYPT_22915]。作为传入参数，该方法接收类型为 ReadWriteMemRegion 的可写内存区域 output，生成的随机字节将直接写入其中 [SWS_CRYPT_22915]。

在执行安全性和并发性方面，该方法声明为 noexcept，被视为 Exception-safe，并明确指定为 thread-safe [SWS_CRYPT_22915]。这允许从多个线程进行并发调用。

错误处理

返回类型 ara::core::Result<void> 通过空结果指示操作成功，或者在发生错误时返回具有回滚语义的相应错误码 [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] 用于生成非对称密钥对。此外，不应将该方法与 MessageAuthnCodeCtx 的同名函数 Generate 混淆，后者用于计算 MAC 摘要 [SWS_CRYPT_50029]。

使用

接口 ara::crypto::cryp::RandomGeneratorCtx 的纯虚方法 Seed 用于通过提供的内存区域设置随机数生成器（RNG）的内部状态 [SWS_CRYPT_22911]。声明在头文件 ara/crypto/cryp/random_generator_ctx.h 中进行，签名如下：virtual ara::core::Result<void> Seed(ReadOnlyMemRegion seed) noexcept = 0; [SWS_CRYPT_22911]。

作为输入参数，该同步函数接收类型为 ReadOnlyMemRegion 的 seed，其中包含带有种子值的内存区域 [SWS_CRYPT_22911]。在成功执行且上下文支持的情况下，该方法返回一个空的 ara::core::Result<void> [SWS_CRYPT_22911]。

错误处理

出错时，返回的 ara::core::Result 包含相应的错误码 [SWS_CRYPT_22911]：

• ara::crypto::CryptoErrc::kUnsupported：当具体的 RandomGeneratorCtx 不支持播种时发生；已为此错误情况指定回滚语义 [SWS_CRYPT_22911]。

并发性与限制

该接口声明为 noexcept，并在执行安全性方面被归类为 exception safe 以及 thread-safe [SWS_CRYPT_22911]。

相互作用

作为对此基于内存区域的函数的补充，[SWS_CRYPT_22912] 定义了一个重载 Seed(SymmetricKey::Sptr seed)，其使用对称密钥初始化 RNG 的状态，并在此过程中评估如 kAllowRngInit 的使用限制。

方法 Seed 在 ara::crypto::cryp::RandomGeneratorCtx 的上下文中使用对称密钥初始化随机数生成器的内部状态 [SWS_CRYPT_22912]。调用同步进行，并被指定为线程安全以及异常安全（exception safe 和 noexcept）[SWS_CRYPT_22912]。指向密钥的智能指针（SymmetricKey::Sptr）用作输入参数，其密钥值将作为种子采用 [SWS_CRYPT_22912]。

在错误处理方面，该函数返回一个 ara::core::Result<void>，其在成功时为空 [SWS_CRYPT_22912]。如果操作失败，将生效回滚语义；这尤其涉及以下错误码：

• ara::crypto::CryptoErrc::kUsageViolation：当传入密钥的允许密钥用途不包含标志 kAllowRngInit 时发生 [SWS_CRYPT_22912]。
• ara::crypto::CryptoErrc::kUnsupported：当具体的上下文实例不支持使用对称密钥设置种子时报告 [SWS_CRYPT_22912]。

在接口族的协作中，此函数代表基于密钥的变体，而符合 [SWS_CRYPT_22911] 的重载则涵盖通过非结构化内存区域（ReadOnlyMemRegion）进行的初始化。由于回滚语义，在发生错误时，内部生成器状态大概率保留在先前的状态（Interpretation）。 问题 Q-970cbedd1843b26a (未决)