kolibrios-syscalls 0.1.2

Running KolibriOS sysfuncs/syscalls from Rust
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

#![no_std]
#![cfg(any(target_arch = "x86", doc))]

mod raw;
pub use raw::*;

///
///
///
///
///


/// Runs a sysfunc (syscall). Doesn't have a return value, instead mutates the arguments. That's because some (at least two) kolibriOS sysfunctions mutate many registers at once.
/// First argument (eax, function number) is a &mut i32, all others are &mut u32.
///
/// Example:
/// ```rust
/// fn kolibrios_exit() -> ! {
///     unsafe {
///         syscall!(&mut -1);
///     }
/// }
/// ```
///
/// Using returned value(s):
/// ```rust
/// use core::ffi::c_void;
/// unsafe fn malloc(mut size: u32) -> *mut c_void {
///     //            ^----- is not actually mutated
///
///     let mut eax = 68; //Function number
///     unsafe {
///         // Sysfunc 68.12, allocate memory block
///         syscall!(&mut eax, &mut 12, &mut size)
///     }
///     eax as *mut c_void
/// }
/// ```
#[macro_export]
macro_rules! syscall {
    ($eax:expr) => {
        $crate::syscall1(
            $eax,
        )
    };


    ($eax:expr, $ebx:expr) => {
        $crate::syscall2(
            $eax,
            $ebx,
        )
    };

    ($eax:expr, $ebx:expr, $ecx:expr) => {
        $crate::syscall3(
            $eax,
            $ebx,
            $ecx,
        )
    };


    ($eax:expr, $ebx:expr, $ecx:expr, $edx:expr) => {
        $crate::syscall4(
            $eax,
            $ebx,
            $ecx,
            $edx,
        )
    };


    ($eax:expr, $ebx:expr, $ecx:expr, $edx:expr, $esi:expr) => {

        $crate::syscall5(
            $eax,
            $ebx,
            $ecx,
            $edx,
            $esi,
        )
    };

    ($eax:expr, $ebx:expr, $ecx:expr, $edx:expr, $esi:expr, $edi:expr) => {
        $crate::syscall6(
            $eax,
            $ebx,
            $ecx,
            $edx,
            $esi,
            $edi,
        )
    };

    ($eax:expr, $ebx:expr, $ecx:expr, $edx:expr, $esi:expr, $edi:expr, $ebp:expr) => {
        $crate::syscall7(
            $eax,
            $ebx,
            $ecx,
            $edx,
            $esi,
            $edi,
            $ebp,
        )
    };

}