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 va
  74  * @param pa
  75  * @param attr
  76  */
  77 void
  78 vmm_set_mapping(void* va, void* pa, pt_attr attr);
  79
  80 /**
  81  * @brief 删除一个映射
  82  *
  83  * @param vpn
  84  */
  85 void
  86 vmm_unmap_page(void* va);
  87
  88 /**
  89  * @brief 将虚拟地址翻译为其对应的物理映射
  90  *
  91  * @param va 虚拟地址
  92  * @return void* 物理地址，如映射不存在，则为NULL
  93  */
  94 void*
  95 vmm_v2p(void* va);
  96
  97 /**
  98  * @brief 查找一个映射
  99  *
 100  * @param va 虚拟地址
 101  * @return v_mapping 映射相关属性
 102  */
 103 v_mapping
 104 vmm_lookup(void* va);
 105
 106 #endif /* __LUNAIX_VMM_H */