lunaix-os/includes/lunaix/mm/vmm.h

   1 #ifndef __LUNAIX_VMM_H
   2 #define __LUNAIX_VMM_H
   3 #include <lunaix/mm/page.h>
   4 #include <stddef.h>
   5 #include <stdint.h>
   6 // Virtual memory manager
   7
   8 /**
   9  * @brief 初始化虚拟内存管理器
  10  *
  11  */
  12 void
  13 vmm_init();
  14
  15 /**
  16  * @brief 创建一个页目录
  17  *
  18  * @return ptd_entry* 页目录的物理地址，随时可以加载进CR3
  19  */
  20 x86_page_table*
  21 vmm_init_pd();
  22
  23 /**
  24  * @brief 尝试建立一个映射关系。映射指定的物理页地址至虚拟页地址，如果指定的虚拟页地址已被占用
  25  * 则尝试寻找新的可用地址（改地址总是大于指定的地址）。
  26  *
  27  * @param vpn 虚拟页地址
  28  * @param pa 物理页地址
  29  * @param dattr PDE 的属性
  30  * @param tattr PTE 的属性
  31  * @return 虚拟页地址，如不成功，则为 NULL
  32  */
  33 void*
  34 vmm_map_page(void* va, void* pa, pt_attr tattr);
  35
  36 /**
  37  * @brief 建立一个映射关系，映射指定的物理页地址至虚拟页地址。如果指定的虚拟页地址已被占用，
  38  * 则覆盖。
  39  *
  40  * @param va 虚拟页地址
  41  * @param pa 物理页地址
  42  * @param dattr PDE 的属性
  43  * @param tattr PTE 的属性
  44  * @return 虚拟页地址
  45  */
  46 void*
  47 vmm_fmap_page(void* va, void* pa, pt_attr tattr);
  48
  49 /**
  50  * @brief 尝试为一个虚拟页地址创建一个可用的物理页映射
  51  *
  52  * @param va 虚拟页地址
  53  * @return 物理页地址，如不成功，则为 NULL
  54  */
  55 void*
  56 vmm_alloc_page(void* va, pt_attr tattr);
  57
  58
  59 /**
  60  * @brief 尝试分配多个连续的虚拟页
  61  *
  62  * @param va 起始虚拟地址
  63  * @param sz 大小（必须为4K对齐）
  64  * @param tattr 属性
  65  * @return int 是否成功
  66  */
  67 int
  68 vmm_alloc_pages(void* va, size_t sz, pt_attr tattr);
  69
  70 /**
  71  * @brief 删除一个映射
  72  *
  73  * @param vpn
  74  */
  75 void
  76 vmm_unmap_page(void* va);
  77
  78 /**
  79  * @brief 将虚拟地址翻译为其对应的物理映射
  80  *
  81  * @param va 虚拟地址
  82  * @return void* 物理地址，如映射不存在，则为NULL
  83  */
  84 void*
  85 vmm_v2p(void* va);
  86
  87 /**
  88  * @brief 查找一个映射
  89  *
  90  * @param va 虚拟地址
  91  * @return v_mapping 映射相关属性
  92  */
  93 v_mapping
  94 vmm_lookup(void* va);
  95
  96 #endif /* __LUNAIX_VMM_H */