semihosting 0.1.25

Semihosting for AArch64, Arm, RISC-V, LoongArch, MIPS32, MIPS64, and Xtensa.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

// SPDX-License-Identifier: Apache-2.0 OR MIT

//! Raw semihosting call.

#[allow(clippy::needless_pass_by_value)]
#[cfg_attr(
    any(
        doc,
        target_arch = "mips",
        target_arch = "mips32r6",
        target_arch = "mips64",
        target_arch = "mips64r6",
    ),
    path = "mips.rs"
)]
mod arch;

pub(crate) use self::arch::syscall1_noreturn_readonly;
pub use self::arch::{
    syscall0, syscall1, syscall1_readonly, syscall2, syscall2_readonly, syscall3,
    syscall3_readonly, syscall4, syscall4_readonly,
};
pub use crate::sys::reg::{ParamRegR, ParamRegW, RetReg};

/// Semihosting operation code.
#[derive(Debug, Clone, Copy)]
pub struct OperationCode(usize);
#[allow(missing_docs)]
impl OperationCode {
    pub const UHI_EXIT: Self = Self(1);
    pub const UHI_OPEN: Self = Self(2);
    pub const UHI_CLOSE: Self = Self(3);
    pub const UHI_READ: Self = Self(4);
    pub const UHI_WRITE: Self = Self(5);
    pub const UHI_LSEEK: Self = Self(6);
    pub const UHI_UNLINK: Self = Self(7);
    pub const UHI_FSTAT: Self = Self(8);
    pub const UHI_ARGC: Self = Self(9);
    pub const UHI_ARGNLEN: Self = Self(10);
    pub const UHI_ARGN: Self = Self(11);
    // pub const UHI_RAMRANGE: Self = Self(12); // QEMU (as of 10.2) doesn't support this
    pub const UHI_PLOG: Self = Self(13);
    // pub const UHI_ASSERT: Self = Self(14); // TODO(mips)
    // pub const UHI_EXCEPTION: Self = Self(15); // QEMU (as of 10.2) doesn't support this
    pub const UHI_PREAD: Self = Self(19); // QEMU (as of 10.2) doesn't support this
    pub const UHI_PWRITE: Self = Self(20); // QEMU (as of 10.2) doesn't support this
    pub const UHI_LINK: Self = Self(22); // QEMU (as of 10.2) doesn't support this
    // pub const UHI_BOOT_FAIL: Self = Self(23); // QEMU (as of 10.2) doesn't support this
}