autogen: run to update randombytes() declaration

L-series · L-series · commit 328cb7a62fcb · 2025-11-28T14:14:50.000-05:00
Run the autogen script to reflect the changes made to the randombytes()
API.

Signed-off-by: Andreas Hatziiliou &lt;andreas.hatziiliou@savoirfairelinux.com&gt;
diff --git a/examples/basic_deterministic/mldsa_native/custom_no_randomized_config.h b/examples/basic_deterministic/mldsa_native/custom_no_randomized_config.h
@@ -343,7 +343,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -354,9 +355,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build/config_44.h b/examples/monolithic_build/config_44.h
@@ -341,7 +341,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -352,9 +353,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build/config_65.h b/examples/monolithic_build/config_65.h
@@ -341,7 +341,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -352,9 +353,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build/config_87.h b/examples/monolithic_build/config_87.h
@@ -341,7 +341,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -352,9 +353,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build_multilevel/multilevel_config.h b/examples/monolithic_build_multilevel/multilevel_config.h
@@ -342,7 +342,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -353,9 +354,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build_multilevel_native/multilevel_config.h b/examples/monolithic_build_multilevel_native/multilevel_config.h
@@ -342,7 +342,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -360,9 +361,9 @@
 #include <stdint.h>
 #include "sys.h"
 #include "test_only_rng/notrandombytes.h"
-static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
 {
-  randombytes(ptr, len);
+  return randombytes(ptr, len);
 }
 #endif /* !__ASSEMBLER__ */
 
diff --git a/examples/monolithic_build_native/config_44.h b/examples/monolithic_build_native/config_44.h
@@ -339,7 +339,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -350,9 +351,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build_native/config_65.h b/examples/monolithic_build_native/config_65.h
@@ -339,7 +339,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -350,9 +351,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/examples/monolithic_build_native/config_87.h b/examples/monolithic_build_native/config_87.h
@@ -339,7 +339,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -350,9 +351,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/integration/liboqs/config_aarch64.h b/integration/liboqs/config_aarch64.h
@@ -162,7 +162,7 @@
  *              consumer.
  *
  *              If this option is not set, mlkem-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
  *
  *              Set this option and define `mlk_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
diff --git a/integration/liboqs/config_c.h b/integration/liboqs/config_c.h
@@ -166,7 +166,7 @@
  *              consumer.
  *
  *              If this option is not set, mlkem-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
  *
  *              Set this option and define `mlk_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
diff --git a/integration/liboqs/config_x86_64.h b/integration/liboqs/config_x86_64.h
@@ -164,7 +164,7 @@
  *              consumer.
  *
  *              If this option is not set, mlkem-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
  *
  *              Set this option and define `mlk_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
diff --git a/mldsa/src/config.h b/mldsa/src/config.h
@@ -327,7 +327,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -338,9 +339,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/break_pct_config.h b/test/break_pct_config.h
@@ -343,7 +343,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -354,9 +355,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/custom_memcpy_config.h b/test/custom_memcpy_config.h
@@ -350,7 +350,8 @@ static MLD_INLINE void *mld_memcpy(void *dest, const void *src, size_t n)
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -361,9 +362,10 @@ static MLD_INLINE void *mld_memcpy(void *dest, const void *src, size_t n)
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/custom_memset_config.h b/test/custom_memset_config.h
@@ -349,7 +349,8 @@ static MLD_INLINE void *mld_memset(void *s, int c, size_t n)
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -360,9 +361,10 @@ static MLD_INLINE void *mld_memset(void *s, int c, size_t n)
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/custom_native_capability_config_0.h b/test/custom_native_capability_config_0.h
@@ -343,7 +343,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -354,9 +355,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/custom_native_capability_config_1.h b/test/custom_native_capability_config_1.h
@@ -343,7 +343,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -354,9 +355,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/custom_native_capability_config_CPUID_AVX2.h b/test/custom_native_capability_config_CPUID_AVX2.h
@@ -343,7 +343,8 @@
  *              consumer.
  *
  *              If this option is not set, mldsa-native expects a function
- *              void randombytes(uint8_t *out, size_t outlen).
+ *              int randombytes(uint8_t *out, size_t outlen).
+ *              This function should return 0 on success, non-zero on failure.
  *
  *              Set this option and define `mld_randombytes` if you want to
  *              use a custom method to sample randombytes with a different name
@@ -354,9 +355,10 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)
+   static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
+       return 0;  // 0 on success, non-zero on failure
    }
    #endif
 */
diff --git a/test/custom_native_capability_config_ID_AA64PFR1_EL1.h b/test/custom_native_capability_config_ID_AA64PFR1_EL1.h
diff --git a/test/custom_randombytes_config.h b/test/custom_randombytes_config.h
diff --git a/test/custom_stdlib_config.h b/test/custom_stdlib_config.h
diff --git a/test/custom_zeroize_config.h b/test/custom_zeroize_config.h
diff --git a/test/no_asm_config.h b/test/no_asm_config.h
diff --git a/test/serial_fips202_config.h b/test/serial_fips202_config.h

Original file line number	Diff line number	Diff line change
`@@ -343,7 +343,8 @@`
`343`	`343`	`* consumer.`
`344`	`344`	`*`
`345`	`345`	`* If this option is not set, mldsa-native expects a function`
`346`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`346`	`+ * int randombytes(uint8_t *out, size_t outlen).`
	`347`	`+ * This function should return 0 on success, non-zero on failure.`
`347`	`348`	`*`
`348`	`349`	* Set this option and define `mld_randombytes` if you want to
`349`	`350`	`* use a custom method to sample randombytes with a different name`
`@@ -354,9 +355,10 @@`
`354`	`355`	`#if !defined(__ASSEMBLER__)`
`355`	`356`	`#include <stdint.h>`
`356`	`357`	`#include "sys.h"`
`357`		`- static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)`
	`358`	`+ static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)`
`358`	`359`	`{`
`359`	`360`	`... your implementation ...`
	`361`	`+ return 0; // 0 on success, non-zero on failure`
`360`	`362`	`}`
`361`	`363`	`#endif`
`362`	`364`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -341,7 +341,8 @@`
`341`	`341`	`* consumer.`
`342`	`342`	`*`
`343`	`343`	`* If this option is not set, mldsa-native expects a function`
`344`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`344`	`+ * int randombytes(uint8_t *out, size_t outlen).`
	`345`	`+ * This function should return 0 on success, non-zero on failure.`
`345`	`346`	`*`
`346`	`347`	* Set this option and define `mld_randombytes` if you want to
`347`	`348`	`* use a custom method to sample randombytes with a different name`
`@@ -352,9 +353,10 @@`
`352`	`353`	`#if !defined(__ASSEMBLER__)`
`353`	`354`	`#include <stdint.h>`
`354`	`355`	`#include "sys.h"`
`355`		`- static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)`
	`356`	`+ static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)`
`356`	`357`	`{`
`357`	`358`	`... your implementation ...`
	`359`	`+ return 0; // 0 on success, non-zero on failure`
`358`	`360`	`}`
`359`	`361`	`#endif`
`360`	`362`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -342,7 +342,8 @@`
`342`	`342`	`* consumer.`
`343`	`343`	`*`
`344`	`344`	`* If this option is not set, mldsa-native expects a function`
`345`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`345`	`+ * int randombytes(uint8_t *out, size_t outlen).`
	`346`	`+ * This function should return 0 on success, non-zero on failure.`
`346`	`347`	`*`
`347`	`348`	* Set this option and define `mld_randombytes` if you want to
`348`	`349`	`* use a custom method to sample randombytes with a different name`
`@@ -353,9 +354,10 @@`
`353`	`354`	`#if !defined(__ASSEMBLER__)`
`354`	`355`	`#include <stdint.h>`
`355`	`356`	`#include "sys.h"`
`356`		`- static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)`
	`357`	`+ static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)`
`357`	`358`	`{`
`358`	`359`	`... your implementation ...`
	`360`	`+ return 0; // 0 on success, non-zero on failure`
`359`	`361`	`}`
`360`	`362`	`#endif`
`361`	`363`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -339,7 +339,8 @@`
`339`	`339`	`* consumer.`
`340`	`340`	`*`
`341`	`341`	`* If this option is not set, mldsa-native expects a function`
`342`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`342`	`+ * int randombytes(uint8_t *out, size_t outlen).`
	`343`	`+ * This function should return 0 on success, non-zero on failure.`
`343`	`344`	`*`
`344`	`345`	* Set this option and define `mld_randombytes` if you want to
`345`	`346`	`* use a custom method to sample randombytes with a different name`
`@@ -350,9 +351,10 @@`
`350`	`351`	`#if !defined(__ASSEMBLER__)`
`351`	`352`	`#include <stdint.h>`
`352`	`353`	`#include "sys.h"`
`353`		`- static MLD_INLINE void mld_randombytes(uint8_t *ptr, size_t len)`
	`354`	`+ static MLD_INLINE int mld_randombytes(uint8_t *ptr, size_t len)`
`354`	`355`	`{`
`355`	`356`	`... your implementation ...`
	`357`	`+ return 0; // 0 on success, non-zero on failure`
`356`	`358`	`}`
`357`	`359`	`#endif`
`358`	`360`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -162,7 +162,7 @@`
`162`	`162`	`* consumer.`
`163`	`163`	`*`
`164`	`164`	`* If this option is not set, mlkem-native expects a function`
`165`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`165`	`+ * int randombytes(uint8_t *out, size_t outlen).`
`166`	`166`	`*`
`167`	`167`	* Set this option and define `mlk_randombytes` if you want to
`168`	`168`	`* use a custom method to sample randombytes with a different name`