#ifndef __LUNAIX_PMM_H
#define __LUNAIX_PMM_H
// Physical memory manager

#include <stdint.h>
#include <stddef.h>
#include <lunaix/process.h>

#define PM_PAGE_SIZE            4096
#define PM_BMP_MAX_SIZE        (1024 * 1024)


#define PP_FGPERSIST            0x1

typedef uint32_t pp_attr_t;

struct pp_struct {
    pid_t owner;
    uint32_t ref_counts;
    pp_attr_t attr;
};

/**
 * @brief 标注物理页为可使用
 * 
 * @param ppn page number
 */
void pmm_mark_page_free(uintptr_t ppn);

/**
 * @brief 标注物理页为已占用
 * 
 * @param ppn 
 */
void pmm_mark_page_occupied(pid_t owner, uintptr_t ppn, pp_attr_t attr);

/**
 * @brief 标注多个连续的物理页为可用
 * 
 * @param start_ppn 起始PPN
 * @param page_count 数量
 */
void pmm_mark_chunk_free(uintptr_t start_ppn, size_t page_count);

/**
 * @brief 标注多个连续的物理页为已占用
 * 
 * @param start_ppn 起始PPN
 * @param page_count 数量
 */
void pmm_mark_chunk_occupied(pid_t owner, uintptr_t start_ppn, size_t page_count, pp_attr_t attr);

/**
 * @brief 分配一个可用的物理页
 * 
 * @return void* 可用的页地址，否则为 NULL
 */
void* pmm_alloc_page(pid_t owner, pp_attr_t attr);

/**
 * @brief 分配一个连续的物理内存区域
 * 
 * @param owner 
 * @param num_pages 区域大小，单位为页
 * @param attr 
 * @return void* 
 */
void*
pmm_alloc_cpage(pid_t owner, size_t num_pages, pp_attr_t attr);

/**
 * @brief 初始化物理内存管理器
 * 
 * @param mem_upper_lim 最大可用内存地址
 */
void pmm_init(uintptr_t mem_upper_lim);

struct pp_struct* pmm_query(void* pa);

/**
 * @brief 释放一个已分配的物理页，假若页地址不存在，则无操作。
 * 
 * @param page 页地址
 * @return 是否成功
 */
int pmm_free_page(pid_t owner, void* page);


int pmm_ref_page(pid_t owner, void* page);

#endif /* __LUNAIX_PMM_H */