From 573f855bbf31a12d3801b5d00221bcde2297e534 Mon Sep 17 00:00:00 2001
From: Artyom Pavlov <newpavlov@gmail.com>
Date: Sun, 20 Oct 2024 10:05:16 +0300
Subject: [PATCH] Rename `__getrandom_custom` to `__getrandom_v03_custom`
 (#531)

This is done to prevent potential conflicts between getrandom v0.2 and
v0.3 in the case when users rely on a custom backend and have both
versions in their dependency tree.
---
 nopanic_check/src/lib.rs |  2 +-
 src/custom.rs            |  4 ++--
 src/lib.rs               | 10 ++++++++--
 tests/mod.rs             |  2 +-
 4 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/nopanic_check/src/lib.rs b/nopanic_check/src/lib.rs
index af2c8ee3..37c4d28e 100644
--- a/nopanic_check/src/lib.rs
+++ b/nopanic_check/src/lib.rs
@@ -19,7 +19,7 @@ pub extern "C" fn getrandom_wrapper(buf_ptr: *mut u8, buf_len: usize) -> u32 {
 
 #[cfg(getrandom_backend = "custom")]
 #[no_mangle]
-unsafe extern "Rust" fn __getrandom_custom(
+unsafe extern "Rust" fn __getrandom_v03_custom(
     dest: *mut u8,
     len: usize,
 ) -> Result<(), getrandom::Error> {
diff --git a/src/custom.rs b/src/custom.rs
index fc216e08..c3e94349 100644
--- a/src/custom.rs
+++ b/src/custom.rs
@@ -4,7 +4,7 @@ use core::mem::MaybeUninit;
 
 pub fn getrandom_inner(dest: &mut [MaybeUninit<u8>]) -> Result<(), Error> {
     extern "Rust" {
-        fn __getrandom_custom(dest: *mut u8, len: usize) -> Result<(), Error>;
+        fn __getrandom_v03_custom(dest: *mut u8, len: usize) -> Result<(), Error>;
     }
-    unsafe { __getrandom_custom(dest.as_mut_ptr().cast(), dest.len()) }
+    unsafe { __getrandom_v03_custom(dest.as_mut_ptr().cast(), dest.len()) }
 }
diff --git a/src/lib.rs b/src/lib.rs
index 386e5906..0a2b2a31 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -110,7 +110,10 @@
 //! use getrandom::Error;
 //!
 //! #[no_mangle]
-//! unsafe extern "Rust" fn __getrandom_custom(dest: *mut u8, len: usize) -> Result<(), Error> {
+//! unsafe extern "Rust" fn __getrandom_v03_custom(
+//!     dest: *mut u8,
+//!     len: usize,
+//! ) -> Result<(), Error> {
 //!     todo!()
 //! }
 //! ```
@@ -133,7 +136,10 @@
 //! use getrandom::Error;
 //!
 //! #[no_mangle]
-//! unsafe extern "Rust" fn __getrandom_custom(dest: *mut u8, len: usize) -> Result<(), Error> {
+//! unsafe extern "Rust" fn __getrandom_v03_custom(
+//!     dest: *mut u8,
+//!     len: usize,
+//! ) -> Result<(), Error> {
 //!     Err(Error::UNSUPPORTED)
 //! }
 //! ```
diff --git a/tests/mod.rs b/tests/mod.rs
index 33083df5..47bc1b27 100644
--- a/tests/mod.rs
+++ b/tests/mod.rs
@@ -206,7 +206,7 @@ mod custom {
     //
     // WARNING: this custom implementation is for testing purposes ONLY!
     #[no_mangle]
-    unsafe extern "Rust" fn __getrandom_custom(dest: *mut u8, len: usize) -> Result<(), Error> {
+    unsafe extern "Rust" fn __getrandom_v03_custom(dest: *mut u8, len: usize) -> Result<(), Error> {
         use std::time::{SystemTime, UNIX_EPOCH};
 
         assert_ne!(len, 0);