xref: /DragonOS/kernel/src/mm/c_adapter.rs (revision 9fab312ea9921618629924ab15c28c2d255b21c6)
1 //! 这是暴露给C的接口,用于在C语言中使用Rust的内存分配器。
2 
3 use core::intrinsics::unlikely;
4 
5 use alloc::vec::Vec;
6 use hashbrown::HashMap;
7 use system_error::SystemError;
8 
9 use crate::{
10     include::bindings::bindings::{gfp_t, PAGE_U_S},
11     kerror,
12     libs::{align::page_align_up, spinlock::SpinLock},
13     mm::MMArch,
14 };
15 
16 use super::{
17     allocator::page_frame::PageFrameCount, kernel_mapper::KernelMapper, mmio_buddy::mmio_pool,
18     no_init::pseudo_map_phys, page::PageFlags, MemoryManagementArch, PhysAddr, VirtAddr,
19 };
20 
21 lazy_static! {
22     // 用于记录内核分配给C的空间信息
23     static ref C_ALLOCATION_MAP: SpinLock<HashMap<VirtAddr, (VirtAddr, usize, usize)>> = SpinLock::new(HashMap::new());
24 }
25 
26 /// [EXTERN TO C] Use pseudo mapper to map physical memory to virtual memory.
27 #[no_mangle]
28 pub unsafe extern "C" fn rs_pseudo_map_phys(vaddr: usize, paddr: usize, size: usize) {
29     let vaddr = VirtAddr::new(vaddr);
30     let paddr = PhysAddr::new(paddr);
31     let count = PageFrameCount::new(page_align_up(size) / MMArch::PAGE_SIZE);
32     pseudo_map_phys(vaddr, paddr, count);
33 }
34 
35 /// [EXTERN TO C] Use kernel mapper to map physical memory to virtual memory.
36 #[no_mangle]
37 pub unsafe extern "C" fn rs_map_phys(vaddr: usize, paddr: usize, size: usize, flags: usize) {
38     let mut vaddr = VirtAddr::new(vaddr);
39     let mut paddr = PhysAddr::new(paddr);
40     let count = PageFrameCount::new(page_align_up(size) / MMArch::PAGE_SIZE);
41     // kdebug!("rs_map_phys: vaddr: {vaddr:?}, paddr: {paddr:?}, count: {count:?}, flags: {flags:?}");
42 
43     let mut page_flags: PageFlags<MMArch> = PageFlags::new().set_execute(true).set_write(true);
44     if flags & PAGE_U_S as usize != 0 {
45         page_flags = page_flags.set_user(true);
46     }
47 
48     let mut kernel_mapper = KernelMapper::lock();
49     let mut kernel_mapper = kernel_mapper.as_mut();
50     assert!(kernel_mapper.is_some());
51     for _i in 0..count.data() {
52         let flusher = kernel_mapper
53             .as_mut()
54             .unwrap()
55             .map_phys(vaddr, paddr, page_flags)
56             .unwrap();
57 
58         flusher.flush();
59 
60         vaddr += MMArch::PAGE_SIZE;
61         paddr += MMArch::PAGE_SIZE;
62     }
63 }
64 
65 #[no_mangle]
66 pub unsafe extern "C" fn kzalloc(size: usize, _gfp: gfp_t) -> usize {
67     // kdebug!("kzalloc: size: {size}");
68     return do_kmalloc(size, true);
69 }
70 
71 #[no_mangle]
72 pub unsafe extern "C" fn kmalloc(size: usize, _gfp: gfp_t) -> usize {
73     // kdebug!("kmalloc: size: {size}");
74     // 由于C代码不规范,因此都全部清空
75     return do_kmalloc(size, true);
76 }
77 
78 fn do_kmalloc(size: usize, _zero: bool) -> usize {
79     let space: Vec<u8> = vec![0u8; size];
80 
81     assert!(space.len() == size);
82     let (ptr, len, cap) = space.into_raw_parts();
83     if !ptr.is_null() {
84         let vaddr = VirtAddr::new(ptr as usize);
85         let mut guard = C_ALLOCATION_MAP.lock();
86         if unlikely(guard.contains_key(&vaddr)) {
87             drop(guard);
88             unsafe {
89                 drop(Vec::from_raw_parts(vaddr.data() as *mut u8, len, cap));
90             }
91             panic!(
92                 "do_kmalloc: vaddr {:?} already exists in C Allocation Map, query size: {size}, zero: {_zero}",
93                 vaddr
94             );
95         }
96         // 插入到C Allocation Map中
97         guard.insert(vaddr, (vaddr, len, cap));
98         return vaddr.data();
99     } else {
100         return SystemError::ENOMEM.to_posix_errno() as i64 as usize;
101     }
102 }
103 
104 #[no_mangle]
105 pub unsafe extern "C" fn kfree(vaddr: usize) -> usize {
106     let vaddr = VirtAddr::new(vaddr);
107     let mut guard = C_ALLOCATION_MAP.lock();
108     let p = guard.remove(&vaddr);
109     drop(guard);
110 
111     if p.is_none() {
112         kerror!("kfree: vaddr {:?} not found in C Allocation Map", vaddr);
113         return SystemError::EINVAL.to_posix_errno() as i64 as usize;
114     }
115     let (vaddr, len, cap) = p.unwrap();
116     drop(Vec::from_raw_parts(vaddr.data() as *mut u8, len, cap));
117     return 0;
118 }
119 
120 /// @brief 创建一块mmio区域,并将vma绑定到initial_mm
121 ///
122 /// @param size mmio区域的大小(字节)
123 ///
124 /// @param vm_flags 要把vma设置成的标志
125 ///
126 /// @param res_vaddr 返回值-分配得到的虚拟地址
127 ///
128 /// @param res_length 返回值-分配的虚拟地址空间长度
129 ///
130 /// @return int 错误码
131 #[no_mangle]
132 unsafe extern "C" fn rs_mmio_create(
133     size: u32,
134     _vm_flags: u64,
135     res_vaddr: *mut u64,
136     res_length: *mut u64,
137 ) -> i32 {
138     // kdebug!("mmio_create");
139     let r = mmio_pool().create_mmio(size as usize);
140     if let Err(e) = r {
141         return e.to_posix_errno();
142     }
143     let space_guard = r.unwrap();
144     *res_vaddr = space_guard.vaddr().data() as u64;
145     *res_length = space_guard.size() as u64;
146     // 由于space_guard drop的时候会自动释放内存,所以这里要忽略它的释放
147     core::mem::forget(space_guard);
148     return 0;
149 }
150 
151 /// @brief 取消mmio的映射并将地址空间归还到buddy中
152 ///
153 /// @param vaddr 起始的虚拟地址
154 ///
155 /// @param length 要归还的地址空间的长度
156 ///
157 /// @return Ok(i32) 成功返回0
158 ///
159 /// @return Err(i32) 失败返回错误码
160 #[no_mangle]
161 pub unsafe extern "C" fn rs_mmio_release(vaddr: u64, length: u64) -> i32 {
162     return mmio_pool()
163         .release_mmio(VirtAddr::new(vaddr as usize), length as usize)
164         .unwrap_or_else(|err| err.to_posix_errno());
165 }
166