get_rdseed32u_arr() - get_rdseed32u_arr() - 5.3 English - 68552

AOCL API Guide (68552)

Document_ID
68552
Release_Date
2026-05-13
Version
5.3 English
int get_rdseed32u_arr(uint32_t *rng_arr, unsigned int N, unsigned int retry_count)#

Returns an array of 32-bit values using RDSEED.

This function invokes RDSEED instruction N times to fetch an array of 32-bit values.

On success, the values are written to rng_arr.

On each failure, the function retries invoking RDSEED retry_count times. Any failure after this, the function will return error.
Parameters:
  • rng_arr – [out] Pointer to memory to store the values returned by RDSEED

  • N – [in] Number of random values to return

  • retry_count – [in] Number of retry attempts

Returns:

success or failure status of function call: SECRNG_SUCCESS, SECRNG_FAILURE, SECRNG_NOTSUPPORTED