refactor: one more step towards arch-agnostic design

[lunaix-os.git] / lunaix-os / includes / lunaix / mm / vmm.h

diff --git a/lunaix-os/includes/lunaix/mm/vmm.h b/lunaix-os/includes/lunaix/mm/vmm.h
index eab731589745221569db2354440449e4727ab41d..3f102db3fe3d20b0ba3d4287f624f817422a97ac 100644 (file)
--- a/lunaix-os/includes/lunaix/mm/vmm.h
+++ b/lunaix-os/includes/lunaix/mm/vmm.h
@@ -7,11 +7,13 @@
 // Virtual memory manager
 
 #define VMAP_NULL 0
+
 /**
  * @brief 映射模式：忽略已存在映射
  *
  */
 #define VMAP_IGNORE 1
+
 /**
  * @brief 映射模式：不作实际映射。该功能用于预留出特定的地址空间
  *
@@ -49,11 +51,7 @@ vmm_init_pd();
  * @return int
  */
 int
-vmm_set_mapping(uintptr_t mnt,
-                uintptr_t va,
-                uintptr_t pa,
-                pt_attr attr,
-                int options);
+vmm_set_mapping(ptr_t mnt, ptr_t va, ptr_t pa, pt_attr attr, int options);
 
 /**
  * @brief 删除一个映射
@@ -63,17 +61,28 @@ vmm_set_mapping(uintptr_t mnt,
  * @param va
  * @return int
  */
-uintptr_t
-vmm_del_mapping(uintptr_t mnt, uintptr_t va);
+ptr_t
+vmm_del_mapping(ptr_t mnt, ptr_t va);
+
+/**
+ * @brief 在当前虚拟地址空间里查找一个映射
+ *
+ * @param va 虚拟地址
+ * @param mapping 映射相关属性
+ */
+int
+vmm_lookup(ptr_t va, v_mapping* mapping);
 
 /**
- * @brief 查找一个映射
+ * @brief 在指定的虚拟地址空间里查找一个映射
  *
+ * @param mnt 地址空间锚定点
  * @param va 虚拟地址
- * @return v_mapping 映射相关属性
+ * @param mapping 映射相关属性
+ * @return int
  */
 int
-vmm_lookup(uintptr_t va, v_mapping* mapping);
+vmm_lookupat(ptr_t mnt, ptr_t va, v_mapping* mapping);
 
 /**
  * @brief (COW) 为虚拟页创建副本。
@@ -81,29 +90,61 @@ vmm_lookup(uintptr_t va, v_mapping* mapping);
  * @return void* 包含虚拟页副本的物理页地址。
  *
  */
-void*
-vmm_dup_page(pid_t pid, void* pa);
+ptr_t
+vmm_dup_page(pid_t pid, ptr_t pa);
 
-void*
+ptr_t
 vmm_dup_vmspace(pid_t pid);
 
 /**
  * @brief 挂载另一个虚拟地址空间至当前虚拟地址空间
  *
  * @param pde 页目录的物理地址
- * @return void*
+ * @return ptr_t
  */
-void*
-vmm_mount_pd(uintptr_t mnt, void* pde);
+ptr_t
+vmm_mount_pd(ptr_t mnt, ptr_t pde);
 
 /**
  * @brief 卸载已挂载的虚拟地址空间
  *
  */
+ptr_t
+vmm_unmount_pd(ptr_t mnt);
+
+void*
+vmm_ioremap(ptr_t paddr, size_t size);
+
 void*
-vmm_unmount_pd(uintptr_t mnt);
+vmm_next_free(ptr_t start, int options);
 
+/**
+ * @brief 将连续的物理地址空间映射到内核虚拟地址空间
+ *
+ * @param paddr 物理地址空间的基地址
+ * @param size 物理地址空间的大小
+ * @return void*
+ */
 void*
-vmm_next_free(uintptr_t start, int options);
+vmm_vmap(ptr_t paddr, size_t size, pt_attr attr);
+
+/**
+ * @brief 将当前地址空间的虚拟地址转译为物理地址。
+ *
+ * @param va 虚拟地址
+ * @return void*
+ */
+ptr_t
+vmm_v2p(ptr_t va);
+
+/**
+ * @brief 将指定地址空间的虚拟地址转译为物理地址
+ *
+ * @param mnt 地址空间锚定点
+ * @param va 虚拟地址
+ * @return void*
+ */
+ptr_t
+vmm_v2pat(ptr_t mnt, ptr_t va);
 
 #endif /* __LUNAIX_VMM_H */