getrandom 0.4.2

A small cross-platform library for retrieving random data from system source
Documentation
//! Implementation for Linux / Android using `asm!`-based syscalls.
pub use crate::util::{inner_u32, inner_u64};
use crate::{Error, MaybeUninit};

#[cfg(not(any(target_os = "android", target_os = "linux")))]
compile_error!("`linux_raw` backend can be enabled only for Linux/Android targets!");

#[path = "../utils/sanitizer.rs"]
mod utils;

#[allow(non_upper_case_globals)]
unsafe fn getrandom_syscall(buf: *mut u8, buflen: usize, flags: u32) -> isize {
    let r0;

    // Based on `rustix` and `linux-raw-sys` code.
    cfg_if! {
        if #[cfg(all(
            target_arch = "arm",
            any(target_abi = "eabi", target_abi = "eabihf"),
        ))] {
            const __NR_getrandom: u32 = 384;
            // In thumb-mode, r7 is the frame pointer and is not permitted to be used in
            // an inline asm operand, so we have to use a different register and copy it
            // into r7 inside the inline asm.
            // Theoretically, we could detect thumb mode in the build script, but several
            // register moves are cheap enough compared to the syscall cost, so we do not
            // bother with it.
            unsafe {
                core::arch::asm!(
                    "mov {tmp}, r7",
                    "mov r7, {nr}",
                    "svc 0",
                    "mov r7, {tmp}",
                    tmp = out(reg) _,
                    nr = const __NR_getrandom,
                    inlateout("r0") buf => r0,
                    in("r1") buflen,
                    in("r2") flags,
                    options(nostack, preserves_flags)
                );
            }
        } else if #[cfg(all(
            target_arch = "aarch64",
            any(target_abi = "", target_abi = "ilp32"),
        ))] {
            // According to the ILP32 patch for the kernel that hasn't yet
            // been merged into the mainline, "AARCH64/ILP32 ABI uses standard
            // syscall table [...] with the exceptions listed below," where
            // getrandom is not mentioned as an exception.
            const __NR_getrandom: u32 = 278;
            unsafe {
                core::arch::asm!(
                    "svc 0",
                    in("x8") __NR_getrandom,
                    inlateout("x0") buf => r0,
                    in("x1") buflen,
                    in("x2") flags,
                    options(nostack, preserves_flags)
                );
            }
        } else if #[cfg(all(
            target_arch = "loongarch64",
            any(target_abi = "", target_abi = "ilp32"),
        ))] {
            const __NR_getrandom: u32 = 278;
            unsafe {
                core::arch::asm!(
                    "syscall 0",
                    in("$a7") __NR_getrandom,
                    inlateout("$a0") buf => r0,
                    in("$a1") buflen,
                    in("$a2") flags,
                    options(nostack, preserves_flags)
                );
            }
        } else if #[cfg(any(target_arch = "riscv32", target_arch = "riscv64"))] {
            const __NR_getrandom: u32 = 278;
            unsafe {
                core::arch::asm!(
                    "ecall",
                    in("a7") __NR_getrandom,
                    inlateout("a0") buf => r0,
                    in("a1") buflen,
                    in("a2") flags,
                    options(nostack, preserves_flags)
                );
            }
        } else if #[cfg(target_arch = "s390x")] {
            const __NR_getrandom: u32 = 349;
            unsafe {
                core::arch::asm!(
                    "svc 0",
                    in("r1") __NR_getrandom,
                    inlateout("r2") buf => r0,
                    in("r3") buflen,
                    in("r4") flags,
                    options(nostack, preserves_flags)
                );
            }
        } else if #[cfg(target_arch = "x86")] {
            const __NR_getrandom: u32 = 355;
            // `int 0x80` is famously slow, but implementing vDSO is too complex
            // and `sysenter`/`syscall` have their own portability issues,
            // so we use the simple "legacy" way of doing syscalls.
            unsafe {
                core::arch::asm!(
                    "int $$0x80",
                    in("eax") __NR_getrandom,
                    in("ebx") buf,
                    in("ecx") buflen,
                    in("edx") flags,
                    lateout("eax") r0,
                    options(nostack, preserves_flags)
                );
            }
        } else if #[cfg(all(
            target_arch = "x86_64",
            any(target_abi = "", target_abi = "x32"),
        ))] {
            const __X32_SYSCALL_BIT: u32 = 0x40000000;
            const OFFSET: u32 = if cfg!(target_pointer_width = "32") { __X32_SYSCALL_BIT } else { 0 };
            const __NR_getrandom: u32 = OFFSET + 318;

            unsafe {
                core::arch::asm!(
                    "syscall",
                    in("rax") __NR_getrandom,
                    in("rdi") buf,
                    in("rsi") buflen,
                    in("rdx") flags,
                    lateout("rax") r0,
                    lateout("rcx") _,
                    lateout("r11") _,
                    options(nostack, preserves_flags)
                );
            }
        } else {
            compile_error!("`linux_raw` backend does not support this target arch");
        }
    }

    r0
}

#[inline]
pub fn fill_inner(mut dest: &mut [MaybeUninit<u8>]) -> Result<(), Error> {
    // Value of this error code is stable across all target arches.
    const EINTR: isize = -4;

    loop {
        let ret = unsafe { getrandom_syscall(dest.as_mut_ptr().cast(), dest.len(), 0) };
        match usize::try_from(ret) {
            Ok(0) => return Err(Error::UNEXPECTED),
            Ok(len) => {
                let (l, r) = dest.split_at_mut_checked(len).ok_or(Error::UNEXPECTED)?;
                unsafe { utils::unpoison(l) };
                dest = r;
                if dest.is_empty() {
                    return Ok(());
                }
            }
            Err(_) if ret == EINTR => continue,
            Err(_) => {
                let code = i32::try_from(ret).map_err(|_| Error::UNEXPECTED)?;
                return Err(Error::from_neg_error_code(code));
            }
        }
    }
}