Changeset 77509 in vbox for trunk/include/iprt

Timestamp:

Feb 28, 2019 7:14:03 PM (6 years ago)

Author:

vboxsync

Message:

Runtime/fuzz: Updates

Location:

trunk/include/iprt

Files:

• fuzz.h (modified) (4 diffs)
• mangling.h (modified) (2 diffs)

trunk/include/iprt/fuzz.h

@@ -78 +78 @@
 } RTFUZZCTXTYPE;
 
+
 /** @name RTFUZZCTX_F_XXX - Flags for RTFuzzCtxCfgSetBehavioralFlags
  * @{ */
@@ -86 +87 @@
 /** @} */
 
+
+/**
+ * Fuzzing context state export callback.
+ *
+ * @returns IPRT status code.
+ * @param   hFuzzCtx            Handle of the fuzzing context.
+ * @param   pvBuf               The data to write.
+ * @param   cbWrite             Number of bytes to write.
+ * @param   pvUser              Opaque user data passed in RTFuzzCtxStateExport().
+ */
+typedef DECLCALLBACK(int) FNRTFUZZCTXEXPORT(RTFUZZCTX hFuzzCtx, const void *pvBuf, size_t cbWrite, void *pvUser);
+/** Pointer to a fuzzing context state export callback. */
+typedef FNRTFUZZCTXEXPORT *PFNRTFUZZCTXEXPORT;
+
+/**
+ * Fuzzing context state import callback.
+ *
+ * @returns IPRT status code.
+ * @param   hFuzzCtx            Handle of the fuzzing context.
+ * @param   pvBuf               Where to store the read data.
+ * @param   cbRead              Number of bytes to read.
+ * @param   pcbRead             Where to store the amount of data written, optional.
+ * @param   pvUser              Opaque user data passed in RTFuzzCtxCreateFromState().
+ */
+typedef DECLCALLBACK(int) FNRTFUZZCTXIMPORT(RTFUZZCTX hFuzzCtx, void *pvBuf, size_t cbRead, size_t *pcbRead, void *pvUser);
+/** Pointer to a fuzzing context state export callback. */
+typedef FNRTFUZZCTXIMPORT *PFNRTFUZZCTXIMPORT;
+
+
 /**
  * Creates a new fuzzing context.
@@ -100 +130 @@
  * @returns IPRT status code.
  * @param   phFuzzCtx           Where to store the handle to the fuzzing context on success.
- * @param   pvState             The pointer to the fuzzing state.
- * @param   cbState             Size of the state buffer in bytes.
- */
-RTDECL(int) RTFuzzCtxCreateFromState(PRTFUZZCTX phFuzzCtx, const void *pvState, size_t cbState);
+ * @param   pfnImport           State import callback.
+ * @param   pvUser              Opaque user data to pass to the callback.
+ */
+RTDECL(int) RTFuzzCtxCreateFromState(PRTFUZZCTX phFuzzCtx, PFNRTFUZZCTXIMPORT pfnImport, void *pvUser);
+
+/**
+ * Creates a new fuzzing context loading the state from the given memory buffer.
+ *
+ * @returns IPRT status code.
+ * @param   phFuzzCtx           Where to store the handle to the fuzzing context on success.
+ * @param   pvState             Pointer to the memory containing the state.
+ * @param   cbState             Size of the state buffer.
+ */
+RTDECL(int) RTFuzzCtxCreateFromStateMem(PRTFUZZCTX phFuzzCtx, const void *pvState, size_t cbState);
 
 /**
@@ -135 +175 @@
  * @returns IPRT statuse code
  * @param   hFuzzCtx            The fuzzing context to export.
- * @param   ppvState            Where to store the buffer of the state on success, free with RTMemFree().
- * @param   pcbState            Where to store the size of the context on success.
- */
-RTDECL(int) RTFuzzCtxStateExport(RTFUZZCTX hFuzzCtx, void **ppvState, size_t *pcbState);
+ * @param   pfnExport           Export callback.
+ * @param   pvUser              Opaque user data to pass to the callback.
+ */
+RTDECL(int) RTFuzzCtxStateExport(RTFUZZCTX hFuzzCtx, PFNRTFUZZCTXEXPORT pfnExport, void *pvUser);
+
+/**
+ * Exports the given fuzzing context state to memory allocating the buffer.
+ *
+ * @returns IPRT status code.
+ * @param   hFuzzCtx            The fuzzing context to export.
+ * @param   ppvState            Where to store the pointer to the memory containing state on success.
+ *                              Free with RTMemFree().
+ * @param   pcbState            Where to store the size of the state in bytes.
+ */
+RTDECL(int) RTFuzzCtxStateExportToMem(RTFUZZCTX hFuzzCtx, void **ppvState, size_t *pcbState);
 
 /**

trunk/include/iprt/mangling.h

@@ -1037 +1037 @@
 # define RTFuzzCtxCreateFromState                       RT_MANGLER(RTFuzzCtxCreateFromState)
 # define RTFuzzCtxCreateFromStateFile                   RT_MANGLER(RTFuzzCtxCreateFromStateFile)
+# define RTFuzzCtxCreateFromStateMem                    RT_MANGLER(RTFuzzCtxCreateFromStateMem)
 # define RTFuzzCtxInputGenerate                         RT_MANGLER(RTFuzzCtxInputGenerate)
 # define RTFuzzCtxRelease                               RT_MANGLER(RTFuzzCtxRelease)
@@ -1043 +1044 @@
 # define RTFuzzCtxStateExport                           RT_MANGLER(RTFuzzCtxStateExport)
 # define RTFuzzCtxStateExportToFile                     RT_MANGLER(RTFuzzCtxStateExportToFile)
+# define RTFuzzCtxStateExportToMem                      RT_MANGLER(RTFuzzCtxStateExportToMem)
 # define RTFuzzInputAddToCtxCorpus                      RT_MANGLER(RTFuzzInputAddToCtxCorpus)
 # define RTFuzzInputMutateStreamData                    RT_MANGLER(RTFuzzInputMutateStreamData)