Changeset 11558 in vbox

Timestamp:

Aug 21, 2008 9:50:28 PM (16 years ago)

Author:

vboxsync

Message:

iprt: RTRandAdvCreateNonPseudo -> RTRandAdvCreateSystemFaster; RTRandAdvCreatePureNonPseudo -> RTRandAdvCreateSystemTruer

File:

• trunk/include/iprt/rand.h (modified) (2 diffs)

trunk/include/iprt/rand.h

@@ -130 +130 @@
 RTDECL(int) RTRandAdvCreatePseudo(PRTRAND phRand) RT_NO_THROW;
 
-
 /**
  * Create an instance of the Park-Miller pseudo random number generator.
@@ -140 +139 @@
 
 /**
- * Create an instance of the default non-pseudo random number generator.
- *
- * @returns IPRT status code.
- * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature
- *          (Windows & OS/2).
+ * Create an instance of the faster random number generator for the OS.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature.
+ * @retval  VERR_FILE_NOT_FOUND on system where the random generator hasn't
+ *          been installed or configured correctly.
+ * @retval  VERR_PATH_NOT_FOUND for the same reasons as VERR_FILE_NOT_FOUND.
+ *
  * @param   phRand      Where to store the handle to the generator.
  *
  * @remarks Think /dev/urandom.
  */
-RTDECL(int) RTRandAdvCreateNonPseudo(PRTRAND phRand) RT_NO_THROW;
-
-/**
- * Create an instance of the default pure non-pseudo random number generator.
+RTDECL(int) RTRandAdvCreateSystemFaster(PRTRAND phRand) RT_NO_THROW;
+
+/**
+ * Create an instance of the truer random number generator for the OS.
  *
  * Don't use this unless you seriously need good random numbers because most
- * systems will have will have problems producing sufficient randomness for this
- * and you'll end up blocking.
- *
- * @returns IPRT status code.
- * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature
- *          (Windows & OS/2).
+ * systems will have will have problems producing sufficient entropy for this
+ * and you'll end up blocking while it accumulates.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature.
+ * @retval  VERR_FILE_NOT_FOUND on system where the random generator hasn't
+ *          been installed or configured correctly.
+ * @retval  VERR_PATH_NOT_FOUND for the same reasons as VERR_FILE_NOT_FOUND.
+ *
  * @param   phRand      Where to store the handle to the generator.
  *
  * @remarks Think /dev/random.
  */
-RTDECL(int) RTRandAdvCreatePureNonPseudo(PRTRAND phRand) RT_NO_THROW;
+RTDECL(int) RTRandAdvCreateSystemTruer(PRTRAND phRand) RT_NO_THROW;
 
 /**