VirtualBox

Changeset 11558

Show
Ignore:
Timestamp:
08/21/08 23:50:28 (3 months ago)
Author:
vboxsync
Message:

iprt: RTRandAdvCreateNonPseudo -> RTRandAdvCreateSystemFaster; RTRandAdvCreatePureNonPseudo -> RTRandAdvCreateSystemTruer

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/include/iprt/rand.h

    r11523 r11558  
    130130RTDECL(int) RTRandAdvCreatePseudo(PRTRAND phRand) RT_NO_THROW; 
    131131 
    132  
    133132/** 
    134133 * Create an instance of the Park-Miller pseudo random number generator. 
    …… 
    140139 
    141140/** 
    142  * Create an instance of the default non-pseudo random number generator. 
    143  * 
    144  * @returns IPRT status code. 
    145  * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature 
    146  *          (Windows & OS/2). 
     141 * Create an instance of the faster random number generator for the OS. 
     142 * 
     143 * @returns IPRT status code. 
     144 * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature. 
     145 * @retval  VERR_FILE_NOT_FOUND on system where the random generator hasn't 
     146 *          been installed or configured correctly. 
     147 * @retval  VERR_PATH_NOT_FOUND for the same reasons as VERR_FILE_NOT_FOUND. 
     148 * 
    147149 * @param   phRand      Where to store the handle to the generator. 
    148150 * 
    149151 * @remarks Think /dev/urandom. 
    150152 */ 
    151 RTDECL(int) RTRandAdvCreateNonPseudo(PRTRAND phRand) RT_NO_THROW; 
    152  
    153 /** 
    154  * Create an instance of the default pure non-pseudo random number generator. 
     153RTDECL(int) RTRandAdvCreateSystemFaster(PRTRAND phRand) RT_NO_THROW; 
     154 
     155/** 
     156 * Create an instance of the truer random number generator for the OS. 
    155157 * 
    156158 * Don't use this unless you seriously need good random numbers because most 
    157  * systems will have will have problems producing sufficient randomness for this 
    158  * and you'll end up blocking. 
    159  * 
    160  * @returns IPRT status code. 
    161  * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature 
    162  *          (Windows & OS/2). 
     159 * systems will have will have problems producing sufficient entropy for this 
     160 * and you'll end up blocking while it accumulates. 
     161 * 
     162 * @returns IPRT status code. 
     163 * @retval  VERR_NOT_SUPPORTED on platforms which doesn't have this feature. 
     164 * @retval  VERR_FILE_NOT_FOUND on system where the random generator hasn't 
     165 *          been installed or configured correctly. 
     166 * @retval  VERR_PATH_NOT_FOUND for the same reasons as VERR_FILE_NOT_FOUND. 
     167 * 
    163168 * @param   phRand      Where to store the handle to the generator. 
    164169 * 
    165170 * @remarks Think /dev/random. 
    166171 */ 
    167 RTDECL(int) RTRandAdvCreatePureNonPseudo(PRTRAND phRand) RT_NO_THROW; 
     172RTDECL(int) RTRandAdvCreateSystemTruer(PRTRAND phRand) RT_NO_THROW; 
    168173 
    169174/** 

© 2008 Sun Microsystems, Inc.
Contact – Privacy policy