mm.h

Go to the documentation of this file.

// SPDX-License-Identifier: GPL-3.0-or-later
 
#pragma once
 
#include "mos/io/io.h"
#include "mos/mm/mmstat.h"
#include "mos/mm/physical/pmm.h"
#include "mos/platform/platform.h"
 
#include <mos/lib/structures/list.h>
#include <mos/lib/sync/spinlock.h>
#include <mos/mm/mm_types.h>
 
typedef enum
{
    VMAP_UNKNOWN = 0,
    VMAP_STACK, // stack (user)
    VMAP_FILE,  // file mapping
    VMAP_MMAP,  // mmap mapping
    VMAP_DMA,   // DMA mapping
} vmap_content_t;
 
typedef enum
{
    VMAP_TYPE_PRIVATE = MMAP_PRIVATE, // there will be distinct copies of the memory region in the child process
    VMAP_TYPE_SHARED = MMAP_SHARED,   // the memory region will be shared between the parent and child processes
} vmap_type_t;
 
typedef struct
{
    bool is_present, is_write, is_user, is_exec;
    ptr_t ip;                       
    platform_regs_t *regs;          
    phyframe_t *faulting_page;      
    const phyframe_t *backing_page; 
} pagefault_t;
 
typedef enum
{
    VMFAULT_COMPLETE,             
    VMFAULT_MAP_BACKING_PAGE_RO,  
    VMFAULT_MAP_BACKING_PAGE,     
    VMFAULT_COPY_BACKING_PAGE,    
    VMFAULT_CANNOT_HANDLE = 0xff, 
} vmfault_result_t;
 
typedef struct _vmap vmap_t;
 
typedef vmfault_result_t (*vmfault_handler_t)(vmap_t *vmap, ptr_t fault_addr, pagefault_t *info);
 
typedef struct _vmap
{
    as_linked_list;
    spinlock_t lock;
 
    ptr_t vaddr; // virtual addresses
    size_t npages;
    vm_flags vmflags; // the expected flags for the region, regardless of the copy-on-write state
    mm_context_t *mmctx;
 
    io_t *io;        // the io object that (possibly) backs this vmap
    off_t io_offset; // the offset in the io object, page-aligned
 
    vmap_content_t content;
    vmap_type_t type;
    vmap_stat_t stat;
    vmfault_handler_t on_fault;
} vmap_t;
 
#define pfn_va(pfn)        ((ptr_t) (platform_info->direct_map_base + (pfn) * (MOS_PAGE_SIZE)))
#define va_pfn(va)         ((((ptr_t) (va)) - platform_info->direct_map_base) / MOS_PAGE_SIZE)
#define va_phyframe(va)    (&phyframes[va_pfn(va)])
#define phyframe_va(frame) ((ptr_t) pfn_va(phyframe_pfn(frame)))
#define pa_va(pa)          ((ptr_t) (pa) + platform_info->direct_map_base)
 
__BEGIN_DECLS
 
phyframe_t *mm_get_free_page(void);
phyframe_t *mm_get_free_page_raw(void);
phyframe_t *mm_get_free_pages(size_t npages);
 
#define mm_free_page(frame)          pmm_free_frames(frame, 1)
#define mm_free_pages(frame, npages) pmm_free_frames(frame, npages)
 
mm_context_t *mm_create_context(void);
 
void mm_destroy_context(mm_context_t *table);
 
void mm_lock_ctx_pair(mm_context_t *ctx1, mm_context_t *ctx2);
void mm_unlock_ctx_pair(mm_context_t *ctx1, mm_context_t *ctx2);
 
__nodiscard mm_context_t *mm_switch_context(mm_context_t *new_ctx);
 
vmap_t *vmap_create(mm_context_t *mmctx, ptr_t vaddr, size_t npages);
 
void vmap_destroy(vmap_t *vmap);
 
vmap_t *vmap_obtain(mm_context_t *mmctx, ptr_t vaddr, size_t *out_offset);
 
vmap_t *vmap_split(vmap_t *vmap, size_t split);
 
vmap_t *vmap_split_for_range(vmap_t *vmap, size_t rstart_pgoff, size_t rend_pgoff);
 
void vmap_finalise_init(vmap_t *vmap, vmap_content_t content, vmap_type_t type);
 
[[nodiscard("resolve completed")]] vmfault_result_t mm_resolve_cow_fault(vmap_t *vmap, ptr_t fault_addr, pagefault_t *info);
 
void mm_handle_fault(ptr_t fault_addr, pagefault_t *info);
 
__END_DECLS