linux_api/
mman.rs

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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
use linux_syscall::{syscall, Result as _, Result64};

use crate::errno::Errno;
use crate::posix_types::{kernel_size_t, kernel_ulong_t, RawFd};
use crate::{bindings, const_conversions};

bitflags::bitflags! {
    /// Prot flags, as used with `mmap`. These are u64 to match the x86-64 `mmap`
    /// syscall parameter:
    /// <https://github.com/torvalds/linux/tree/v6.3/arch/x86/kernel/sys_x86_64.c#L86>
    #[derive(Copy, Clone, Debug, Default, Eq, PartialEq, Hash)]
    pub struct ProtFlags: u64 {
        const PROT_READ = const_conversions::u64_from_u32(bindings::LINUX_PROT_READ);
        const PROT_WRITE = const_conversions::u64_from_u32(bindings::LINUX_PROT_WRITE);
        const PROT_EXEC = const_conversions::u64_from_u32(bindings::LINUX_PROT_EXEC);
        const PROT_SEM = const_conversions::u64_from_u32(bindings::LINUX_PROT_SEM);
        const PROT_NONE = const_conversions::u64_from_u32(bindings::LINUX_PROT_NONE);
        const PROT_GROWSDOWN = const_conversions::u64_from_u32(bindings::LINUX_PROT_GROWSDOWN);
        const PROT_GROWSUP = const_conversions::u64_from_u32(bindings::LINUX_PROT_GROWSUP);
    }
}

bitflags::bitflags! {
    /// Map flags, as used with `mmap`. These are u64 to match the x86-64 `mmap`
    /// syscall parameter:
    /// <https://github.com/torvalds/linux/tree/v6.3/arch/x86/kernel/sys_x86_64.c#L86>
    #[derive(Copy, Clone, Debug, Default, Eq, PartialEq, Hash)]
    pub struct MapFlags: u64 {
        const MAP_TYPE = const_conversions::u64_from_u32(bindings::LINUX_MAP_TYPE);
        const MAP_FIXED = const_conversions::u64_from_u32(bindings::LINUX_MAP_FIXED);
        const MAP_ANONYMOUS = const_conversions::u64_from_u32(bindings::LINUX_MAP_ANONYMOUS);
        const MAP_POPULATE = const_conversions::u64_from_u32(bindings::LINUX_MAP_POPULATE);
        const MAP_NONBLOCK = const_conversions::u64_from_u32(bindings::LINUX_MAP_NONBLOCK);
        const MAP_STACK = const_conversions::u64_from_u32(bindings::LINUX_MAP_STACK);
        const MAP_HUGETLB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGETLB);
        const MAP_SYNC = const_conversions::u64_from_u32(bindings::LINUX_MAP_SYNC);
        const MAP_FIXED_NOREPLACE = const_conversions::u64_from_u32(bindings::LINUX_MAP_FIXED_NOREPLACE);
        const MAP_UNINITIALIZED = const_conversions::u64_from_u32(bindings::LINUX_MAP_UNINITIALIZED);
        const MAP_SHARED = const_conversions::u64_from_u32(bindings::LINUX_MAP_SHARED);
        const MAP_PRIVATE = const_conversions::u64_from_u32(bindings::LINUX_MAP_PRIVATE);
        const MAP_SHARED_VALIDATE = const_conversions::u64_from_u32(bindings::LINUX_MAP_SHARED_VALIDATE);
        const MAP_HUGE_SHIFT = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_SHIFT);
        const MAP_HUGE_MASK = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_MASK);
        const MAP_HUGE_16KB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_16KB);
        const MAP_HUGE_64KB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_64KB);
        const MAP_HUGE_512KB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_512KB);
        const MAP_HUGE_1MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_1MB);
        const MAP_HUGE_2MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_2MB);
        const MAP_HUGE_8MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_8MB);
        const MAP_HUGE_16MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_16MB);
        const MAP_HUGE_32MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_32MB);
        const MAP_HUGE_256MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_256MB);
        const MAP_HUGE_512MB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_512MB);
        const MAP_HUGE_1GB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_1GB);
        const MAP_HUGE_2GB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_2GB);
        const MAP_HUGE_16GB = const_conversions::u64_from_u32(bindings::LINUX_MAP_HUGE_16GB);
        const MAP_GROWSDOWN = const_conversions::u64_from_u32(bindings::LINUX_MAP_GROWSDOWN);
        const MAP_DENYWRITE = const_conversions::u64_from_u32(bindings::LINUX_MAP_DENYWRITE);
        const MAP_EXECUTABLE = const_conversions::u64_from_u32(bindings::LINUX_MAP_EXECUTABLE);
        const MAP_LOCKED = const_conversions::u64_from_u32(bindings::LINUX_MAP_LOCKED);
        const MAP_NORESERVE = const_conversions::u64_from_u32(bindings::LINUX_MAP_NORESERVE);
        const MAP_DROPPABLE = const_conversions::u64_from_u32(bindings::LINUX_MAP_DROPPABLE);
    }
}

bitflags::bitflags! {
    /// Flags used with `mremap`. u64 to match the x86-64 `mremap` syscall parameter:
    /// <https://github.com/torvalds/linux/tree/v6.3/mm/mremap.c#L895>
    #[derive(Copy, Clone, Debug, Default, Eq, PartialEq, Hash)]
    pub struct MRemapFlags: u64 {
        const MREMAP_MAYMOVE = const_conversions::u64_from_u32(bindings::LINUX_MREMAP_MAYMOVE);
        const MREMAP_FIXED = const_conversions::u64_from_u32(bindings::LINUX_MREMAP_FIXED);
        const MREMAP_DONTUNMAP = const_conversions::u64_from_u32(bindings::LINUX_MREMAP_DONTUNMAP);
    }
}

/// Make the `mmap` syscall. See `mmap(2)`.
///
/// Signature from `SYSCALL_DEFINE6(mmap, ...`, in linux's arch/x86/kernel/sys_x86_64.c.
///
/// # Safety
///
/// Can clobber existing memory. See `mmap(2)`.
pub unsafe fn mmap_raw(
    addr: kernel_ulong_t,
    length: kernel_ulong_t,
    prot: kernel_ulong_t,
    flags: kernel_ulong_t,
    fd: kernel_ulong_t,
    off: kernel_ulong_t,
) -> Result<kernel_ulong_t, Errno> {
    unsafe { syscall!(linux_syscall::SYS_mmap, addr, length, prot, flags, fd, off) }
        .try_u64()
        .map_err(Errno::from)
}

/// Make the `mmap` syscall, with a thin layer of type-safety over `mmap_raw`.
/// See `mmap(2)`.
///
/// # Safety
///
/// Can clobber existing memory. See `mmap(2)`.
pub unsafe fn mmap(
    addr: *mut core::ffi::c_void,
    length: usize,
    prot: ProtFlags,
    flags: MapFlags,
    fd: RawFd,
    offset: usize,
) -> Result<*mut core::ffi::c_void, Errno> {
    unsafe {
        mmap_raw(
            addr as kernel_ulong_t,
            u64::try_from(length).unwrap(),
            prot.bits(),
            flags.bits(),
            fd as kernel_ulong_t,
            offset.try_into().unwrap(),
        )
        .map(|x| x as *mut core::ffi::c_void)
    }
}

/// Make the `munmap` syscall. See `munmap(2)`.
///
/// Signature from `SYSCALL_DEFINE2(munmap, ...`, in linux's mm/mmap.c.
///
/// # Safety
///
/// Invalidates the referenced memory range. See `munmap(2)`.
pub unsafe fn munmap_raw(addr: kernel_ulong_t, length: kernel_size_t) -> Result<(), Errno> {
    unsafe { syscall!(linux_syscall::SYS_munmap, addr, length) }
        .check()
        .map_err(Errno::from)
}

/// Make the `munmap` syscall, with a thin layer of type-safety over `munmap_raw`. See `munmap(2)`.
///
/// # Safety
///
/// Invalidates the referenced memory range. See `munmap(2)`.
pub unsafe fn munmap(addr: *mut core::ffi::c_void, length: usize) -> Result<(), Errno> {
    unsafe { munmap_raw(addr as kernel_ulong_t, length.try_into().unwrap()) }
}

/// Make the `mprotect` syscall. See `mprotect(2)`.
///
/// Signature from `SYSCALL_DEFINE2(mprotect, ...`, in linux's mm/mprotect.c.
///
/// # Safety
///
/// See `mprotect(2)`.
pub unsafe fn mprotect_raw(
    addr: kernel_ulong_t,
    length: kernel_size_t,
    prot: kernel_ulong_t,
) -> Result<(), Errno> {
    unsafe { syscall!(linux_syscall::SYS_mprotect, addr, length, prot) }
        .check()
        .map_err(Errno::from)
}

/// Make the `mprotect` syscall, with a thin layer of type-safety over `mprotect_raw`. See `mprotect(2)`.
///
/// # Safety
///
/// See `mprotect(2)`.
pub unsafe fn mprotect(
    addr: *mut core::ffi::c_void,
    length: usize,
    prot: ProtFlags,
) -> Result<(), Errno> {
    unsafe {
        mprotect_raw(
            addr as kernel_ulong_t,
            length.try_into().unwrap(),
            prot.bits(),
        )
    }
}