Changeset 11523 in vbox for trunk/src/VBox/Runtime/include/internal/rand.h

Timestamp:

Aug 20, 2008 8:48:52 PM (17 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

35074

Message:

iprt: Implemented the /dev/urandom base random generator as a RTRAND opaque. Made the simple RTRand API just serve as a wrapper using the RTRandAdv API with a global RTRAND handle.

File:

• trunk/src/VBox/Runtime/include/internal/rand.h (modified) (3 diffs)

trunk/src/VBox/Runtime/include/internal/rand.h

@@ -85 +85 @@
      *
      * @returns IPRT status code.
+     * @retval  VERR_NOT_SUPPORTED if it isn't a pseudo generator.
+     *
      * @param   pThis       Pointer to the instance data.
      * @param   u64Seed     The seed.
      */
     DECLCALLBACKMEMBER(int, pfnSeed)(PRTRANDINT pThis, uint64_t u64Seed);
+
+    /**
+     * Save the current state of a pseudo generator.
+     *
+     * This can be use to save the state so it can later be resumed at the same
+     * position.
+     *
+     * @returns IPRT status code.
+     * @retval  VINF_SUCCESS on success. *pcbState contains the length of the
+     *          returned string and pszState contains the state string.
+     * @retval  VERR_BUFFER_OVERFLOW if the supplied buffer is too small. *pcbState
+     *          will contain the necessary buffer size.
+     * @retval  VERR_NOT_SUPPORTED by non-psuedo generators.
+     *
+     * @param   hRand       Handle to the random number generator.
+     * @param   pszState    Where to store the state. The returned string will be
+     *                      null terminated and printable.
+     * @param   pcbState    The size of the buffer pszState points to on input, the
+     *                      size required / used on return (including the
+     *                      terminator, thus the 'cb' instead of 'cch').
+     */
+    DECLCALLBACKMEMBER(int, pfnSaveState)(RTRAND hRand, char *pszState, size_t *pcbState);
+
+    /**
+     * Restores the state of a pseudo generator.
+     *
+     * The state must've been obtained using pfnGetState.
+     *
+     * @returns IPRT status code.
+     * @retval  VERR_PARSE_ERROR if the state string is malformed.
+     * @retval  VERR_NOT_SUPPORTED by non-psuedo generators.
+     *
+     * @param   hRand       Handle to the random number generator.
+     * @param   pszState    The state to load.
+     */
+    DECLCALLBACKMEMBER(int, pfnRestoreState)(RTRAND hRand, char const *pszState);
 
     /**
@@ -113 +151 @@
             uint32_t    cBits;
         } ParkMiller;
+
+        struct RTRandFile
+        {
+            /** The file handle. */
+            RTFILE      hFile;
+        } File;
     } u;
 } RTRANDINT;
@@ -141 +185 @@
 DECLCALLBACK(uint64_t)  rtRandAdvSynthesizeU64FromBytes(PRTRANDINT pThis, uint64_t u64First, uint64_t u64Last);
 DECLCALLBACK(uint64_t)  rtRandAdvSynthesizeU64FromU32(PRTRANDINT pThis, uint64_t u64First, uint64_t u64Last);
+DECLCALLBACK(int)       rtRandAdvStubSeed(PRTRANDINT pThis, uint64_t u64Seed);
+DECLCALLBACK(int)       rtRandAdvStubSaveState(PRTRANDINT pThis, char *pszState, size_t *pcbState);
+DECLCALLBACK(int)       rtRandAdvStubRestoreState(PRTRANDINT pThis, char const *pszState);
+DECLCALLBACK(int)       rtRandAdvDefaultDestroy(PRTRANDINT pThis);
 
 __END_DECLS