autogen: run to update randombytes declaration

L-series · L-series · commit a43e40b590af · 2025-12-01T17:10:24.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/mlkem_native/custom_no_randomized_config.h b/examples/basic_deterministic/mlkem_native/custom_no_randomized_config.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/custom_backend/mlkem_native/custom_config.h b/examples/custom_backend/mlkem_native/custom_config.h
@@ -306,7 +306,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
@@ -317,7 +317,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build/config_1024.h b/examples/monolithic_build/config_1024.h
@@ -307,7 +307,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
@@ -318,7 +318,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build/config_512.h b/examples/monolithic_build/config_512.h
@@ -307,7 +307,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
@@ -318,7 +318,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build/config_768.h b/examples/monolithic_build/config_768.h
@@ -307,7 +307,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
@@ -318,7 +318,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build_multilevel/multilevel_config.h b/examples/monolithic_build_multilevel/multilevel_config.h
@@ -309,7 +309,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
@@ -320,7 +320,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build_multilevel_native/multilevel_config.h b/examples/monolithic_build_multilevel_native/multilevel_config.h
@@ -309,7 +309,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/examples/monolithic_build_native/config_1024.h b/examples/monolithic_build_native/config_1024.h
@@ -308,7 +308,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
@@ -319,7 +319,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build_native/config_512.h b/examples/monolithic_build_native/config_512.h
@@ -308,7 +308,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
@@ -319,7 +319,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/examples/monolithic_build_native/config_768.h b/examples/monolithic_build_native/config_768.h
@@ -308,7 +308,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
@@ -319,7 +319,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/bench_components_mlkem.c b/test/bench_components_mlkem.c
@@ -27,28 +27,28 @@ static int cmp_uint64_t(const void *a, const void *b)
   return (int)((*((const uint64_t *)a)) - (*((const uint64_t *)b)));
 }
 
-#define BENCH(txt, code)                                            \
-  for (i = 0; i < NTESTS; i++)                                      \
-  {                                                                 \
-    CHECK(randombytes((uint8_t *)data0, sizeof(data0)) == 0);       \
-    CHECK(randombytes((uint8_t *)data1, sizeof(data1)) == 0);       \
-    CHECK(randombytes((uint8_t *)data2, sizeof(data2)) == 0);       \
-    CHECK(randombytes((uint8_t *)data3, sizeof(data3)) == 0);       \
-    CHECK(randombytes((uint8_t *)data4, sizeof(data4)) == 0);       \
-    for (j = 0; j < NWARMUP; j++)                       \
-    {                                                   \
-      code;                                             \
-    }                                                   \
-                                                        \
-    t0 = get_cyclecounter();                            \
-    for (j = 0; j < NITERATIONS; j++)                   \
-    {                                                   \
-      code;                                             \
-    }                                                   \
-    t1 = get_cyclecounter();                            \
-    (cyc)[i] = t1 - t0;                                 \
-  }                                                     \
-  qsort((cyc), NTESTS, sizeof(uint64_t), cmp_uint64_t); \
+#define BENCH(txt, code)                                      \
+  for (i = 0; i < NTESTS; i++)                                \
+  {                                                           \
+    CHECK(randombytes((uint8_t *)data0, sizeof(data0)) == 0); \
+    CHECK(randombytes((uint8_t *)data1, sizeof(data1)) == 0); \
+    CHECK(randombytes((uint8_t *)data2, sizeof(data2)) == 0); \
+    CHECK(randombytes((uint8_t *)data3, sizeof(data3)) == 0); \
+    CHECK(randombytes((uint8_t *)data4, sizeof(data4)) == 0); \
+    for (j = 0; j < NWARMUP; j++)                             \
+    {                                                         \
+      code;                                                   \
+    }                                                         \
+                                                              \
+    t0 = get_cyclecounter();                                  \
+    for (j = 0; j < NITERATIONS; j++)                         \
+    {                                                         \
+      code;                                                   \
+    }                                                         \
+    t1 = get_cyclecounter();                                  \
+    (cyc)[i] = t1 - t0;                                       \
+  }                                                           \
+  qsort((cyc), NTESTS, sizeof(uint64_t), cmp_uint64_t);       \
   printf(txt " cycles=%" PRIu64 "\n", (cyc)[NTESTS >> 1] / NITERATIONS);
 
 static int bench(void)
diff --git a/test/break_pct_config.h b/test/break_pct_config.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_memcpy_config.h b/test/custom_memcpy_config.h
@@ -309,7 +309,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
@@ -320,7 +320,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_memset_config.h b/test/custom_memset_config.h
@@ -309,7 +309,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
@@ -320,7 +320,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_native_capability_config_0.h b/test/custom_native_capability_config_0.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_native_capability_config_1.h b/test/custom_native_capability_config_1.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_native_capability_config_CPUID_AVX2.h b/test/custom_native_capability_config_CPUID_AVX2.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_native_capability_config_ID_AA64PFR1_EL1.h b/test/custom_native_capability_config_ID_AA64PFR1_EL1.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
diff --git a/test/custom_randombytes_config.h b/test/custom_randombytes_config.h
@@ -309,7 +309,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
@@ -321,9 +321,9 @@
 #include <stdint.h>
 #include "../mlkem/src/sys.h"
 #include "notrandombytes/notrandombytes.h"
-static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
 {
-  randombytes(ptr, len);
+  return randombytes(ptr, len);
 }
 #endif /* !__ASSEMBLER__ */
 
diff --git a/test/custom_stdlib_config.h b/test/custom_stdlib_config.h
@@ -310,7 +310,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
@@ -321,7 +321,7 @@
    #if !defined(__ASSEMBLER__)
    #include <stdint.h>
    #include "sys.h"
-   static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)
+   static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)
    {
        ... your implementation ...
    }
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
`@@ -310,7 +310,7 @@`
`310`	`310`	`* consumer.`
`311`	`311`	`*`
`312`	`312`	`* If this option is not set, mlkem-native expects a function`
`313`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`313`	`+ * int randombytes(uint8_t *out, size_t outlen).`
`314`	`314`	`*`
`315`	`315`	* Set this option and define `mlk_randombytes` if you want to
`316`	`316`	`* use a custom method to sample randombytes with a different name`
`@@ -321,7 +321,7 @@`
`321`	`321`	`#if !defined(__ASSEMBLER__)`
`322`	`322`	`#include <stdint.h>`
`323`	`323`	`#include "sys.h"`
`324`		`- static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)`
	`324`	`+ static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)`
`325`	`325`	`{`
`326`	`326`	`... your implementation ...`
`327`	`327`	`}`
Original file line number	Diff line number	Diff line change
`@@ -306,7 +306,7 @@`
`306`	`306`	`* consumer.`
`307`	`307`	`*`
`308`	`308`	`* If this option is not set, mlkem-native expects a function`
`309`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`309`	`+ * int randombytes(uint8_t *out, size_t outlen).`
`310`	`310`	`*`
`311`	`311`	* Set this option and define `mlk_randombytes` if you want to
`312`	`312`	`* use a custom method to sample randombytes with a different name`
`@@ -317,7 +317,7 @@`
`317`	`317`	`#if !defined(__ASSEMBLER__)`
`318`	`318`	`#include <stdint.h>`
`319`	`319`	`#include "sys.h"`
`320`		`- static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)`
	`320`	`+ static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)`
`321`	`321`	`{`
`322`	`322`	`... your implementation ...`
`323`	`323`	`}`
Original file line number	Diff line number	Diff line change
`@@ -307,7 +307,7 @@`
`307`	`307`	`* consumer.`
`308`	`308`	`*`
`309`	`309`	`* If this option is not set, mlkem-native expects a function`
`310`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`310`	`+ * int randombytes(uint8_t *out, size_t outlen).`
`311`	`311`	`*`
`312`	`312`	* Set this option and define `mlk_randombytes` if you want to
`313`	`313`	`* use a custom method to sample randombytes with a different name`
`@@ -318,7 +318,7 @@`
`318`	`318`	`#if !defined(__ASSEMBLER__)`
`319`	`319`	`#include <stdint.h>`
`320`	`320`	`#include "sys.h"`
`321`		`- static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)`
	`321`	`+ static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)`
`322`	`322`	`{`
`323`	`323`	`... your implementation ...`
`324`	`324`	`}`
Original file line number	Diff line number	Diff line change
`@@ -309,7 +309,7 @@`
`309`	`309`	`* consumer.`
`310`	`310`	`*`
`311`	`311`	`* If this option is not set, mlkem-native expects a function`
`312`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`312`	`+ * int randombytes(uint8_t *out, size_t outlen).`
`313`	`313`	`*`
`314`	`314`	* Set this option and define `mlk_randombytes` if you want to
`315`	`315`	`* use a custom method to sample randombytes with a different name`
`@@ -320,7 +320,7 @@`
`320`	`320`	`#if !defined(__ASSEMBLER__)`
`321`	`321`	`#include <stdint.h>`
`322`	`322`	`#include "sys.h"`
`323`		`- static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)`
	`323`	`+ static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)`
`324`	`324`	`{`
`325`	`325`	`... your implementation ...`
`326`	`326`	`}`
Original file line number	Diff line number	Diff line change
`@@ -308,7 +308,7 @@`
`308`	`308`	`* consumer.`
`309`	`309`	`*`
`310`	`310`	`* If this option is not set, mlkem-native expects a function`
`311`		`- * void randombytes(uint8_t *out, size_t outlen).`
	`311`	`+ * int randombytes(uint8_t *out, size_t outlen).`
`312`	`312`	`*`
`313`	`313`	* Set this option and define `mlk_randombytes` if you want to
`314`	`314`	`* use a custom method to sample randombytes with a different name`
`@@ -319,7 +319,7 @@`
`319`	`319`	`#if !defined(__ASSEMBLER__)`
`320`	`320`	`#include <stdint.h>`
`321`	`321`	`#include "sys.h"`
`322`		`- static MLK_INLINE void mlk_randombytes(uint8_t *ptr, size_t len)`
	`322`	`+ static MLK_INLINE int mlk_randombytes(uint8_t *ptr, size_t len)`
`323`	`323`	`{`
`324`	`324`	`... your implementation ...`
`325`	`325`	`}`