get_rdrand64u() - get_rdrand64u() - 5.3 English - 68552

AOCL API Guide (68552)

Document_ID
68552
Release_Date
2026-05-13
Version
5.3 English
int get_rdrand64u(uint64_t *rng_val, unsigned int retry_count)#

Returns a single 64-bit value using RDRAND.

This function invokes RDRAND instruction to fetch a single 64-bit value.

On success, the value returned by RDRAND is written to rng_val.

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

  • retry_count – [in] Number of retry attempts

Returns:

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