WebSVN – HelenOS – Diff – /trunk/kernel/generic/include/mm/as.h

 #include <synch/mutex.h>
 #include <adt/list.h>
 #include <adt/btree.h>
 #include <lib/elf.h>
+/**
-/** Defined to be true if user address space and kernel address space shadow each other. */
+ * Defined to be true if user address space and kernel address space shadow each
+ * other.
+ */
 #define KERNEL_ADDRESS_SPACE_SHADOWED   KERNEL_ADDRESS_SPACE_SHADOWED_ARCH
 #define KERNEL_ADDRESS_SPACE_START  KERNEL_ADDRESS_SPACE_START_ARCH
 #define KERNEL_ADDRESS_SPACE_END    KERNEL_ADDRESS_SPACE_END_ARCH
 #define USER_ADDRESS_SPACE_START    USER_ADDRESS_SPACE_START_ARCH
 #define USER_ADDRESS_SPACE_END      USER_ADDRESS_SPACE_END_ARCH
-#define USTACK_ADDRESS  USTACK_ADDRESS_ARCH
+#define USTACK_ADDRESS          USTACK_ADDRESS_ARCH
+/** Kernel address space. */
-#define FLAG_AS_KERNEL      (1 << 0)    /**< Kernel address space. */
+#define FLAG_AS_KERNEL          (1 << 0)
-/** Address space area attributes. */
+/* Address space area attributes. */
 #define AS_AREA_ATTR_NONE   0
 #define AS_AREA_ATTR_PARTIAL    1   /**< Not fully initialized area. */
-#define AS_PF_FAULT     0   /**< The page fault was not resolved by as_page_fault(). */
+/** The page fault was not resolved by as_page_fault(). */
+#define AS_PF_FAULT     0
-#define AS_PF_OK        1   /**< The page fault was resolved by as_page_fault(). */
+/** The page fault was resolved by as_page_fault(). */
+#define AS_PF_OK        1
-#define AS_PF_DEFER     2   /**< The page fault was caused by memcpy_from_uspace() or memcpy_to_uspace(). */
+/** The page fault was caused by memcpy_from_uspace() or memcpy_to_uspace(). */
+#define AS_PF_DEFER     2
+/** Address space structure.
+ *
+ * as_t contains the list of as_areas of userspace accessible
+ * pages for one or more tasks. Ranges of kernel memory pages are not
+ * supposed to figure in the list as they are shared by all tasks and
+ * set up during system initialization.
+ */
+typedef struct as {
+    /** Protected by asidlock. */
+    link_t inactive_as_with_asid_link;
+    mutex_t lock;
+    /** Number of references (i.e tasks that reference this as). */
+    count_t refcount;
+    /** Number of processors on wich is this address space active. */
+    count_t cpu_refcount;
+    /** B+tree of address space areas. */
+    btree_t as_area_btree;
+    /**
+     *  Address space identifier.
+     *  Constant on architectures that do not support ASIDs.
+     */
+    asid_t asid;
+    /** Non-generic content. */
+    as_genarch_t genarch;
+    /** Architecture specific content. */
+    as_arch_t arch;
+} as_t;
 typedef struct {
     pte_t *(* page_table_create)(int flags);
     void (* page_table_destroy)(pte_t *page_table);
     void (* page_table_lock)(as_t *as, bool lock);
     void (* page_table_unlock)(as_t *as, bool unlock);
 } as_operations_t;
+/**
-/** This structure contains information associated with the shared address space area. */
+ * This structure contains information associated with the shared address space
+ * area.
+ */
 typedef struct {
-    mutex_t lock;       /**< This lock must be acquired only when the as_area lock is held. */
+    /** This lock must be acquired only when the as_area lock is held. */
+    mutex_t lock;
-    count_t refcount;   /**< This structure can be deallocated if refcount drops to 0. */
+    /** This structure can be deallocated if refcount drops to 0. */
+    count_t refcount;
+    /**
-    btree_t pagemap;    /**< B+tree containing complete map of anonymous pages of the shared area. */
+     * B+tree containing complete map of anonymous pages of the shared area.
+     */
+    btree_t pagemap;
 } share_info_t;
 /** Page fault access type. */
 typedef enum {
     PF_ACCESS_READ,
  * Each as_area_t structure describes one contiguous area of virtual memory.
  * In the future, it should not be difficult to support shared areas.
  */
 typedef struct {
     mutex_t lock;
-    as_t *as;       /**< Containing address space. */
+    /** Containing address space. */
+    as_t *as;
-    int flags;      /**< Flags related to the memory represented by the address space area. */
+    /** Flags related to the memory represented by the address space area. */
+    int flags;
-    int attributes;     /**< Attributes related to the address space area itself. */
+    /** Attributes related to the address space area itself. */
+    int attributes;
-    count_t pages;      /**< Size of this area in multiples of PAGE_SIZE. */
+    /** Size of this area in multiples of PAGE_SIZE. */
+    count_t pages;
-    uintptr_t base;     /**< Base address of this area. */
+    /** Base address of this area. */
+    uintptr_t base;
-    btree_t used_space; /**< Map of used space. */
+    /** Map of used space. */
+    btree_t used_space;
+    /**
-    share_info_t *sh_info;  /**< If the address space area has been shared, this pointer will
+     * If the address space area has been shared, this pointer will reference
-                         reference the share info structure. */
+     * the share info structure.
+     */
+    share_info_t *sh_info;
-    struct mem_backend *backend;    /**< Memory backend backing this address space area. */
+    /** Memory backend backing this address space area. */
+    struct mem_backend *backend;
     /** Data to be used by the backend. */
     mem_backend_data_t backend_data;
 } as_area_t;
 extern void as_init(void);
 extern as_t *as_create(int flags);
 extern void as_destroy(as_t *as);
-extern void as_switch(as_t *old, as_t *replace);
+extern void as_switch(as_t *old_as, as_t *new_as);
 extern int as_page_fault(uintptr_t page, pf_access_t access, istate_t *istate);
-extern as_area_t *as_area_create(as_t *as, int flags, size_t size, uintptr_t base, int attrs,
+extern as_area_t *as_area_create(as_t *as, int flags, size_t size,
+    uintptr_t base, int attrs, mem_backend_t *backend,
-    mem_backend_t *backend, mem_backend_data_t *backend_data);
+    mem_backend_data_t *backend_data);
 extern int as_area_destroy(as_t *as, uintptr_t address);
 extern int as_area_resize(as_t *as, uintptr_t address, size_t size, int flags);
 int as_area_share(as_t *src_as, uintptr_t src_base, size_t acc_size,
-          as_t *dst_as, uintptr_t dst_base, int dst_flags_mask);
+    as_t *dst_as, uintptr_t dst_base, int dst_flags_mask);
 extern int as_area_get_flags(as_area_t *area);
 extern bool as_area_check_access(as_area_t *area, pf_access_t access);
 extern size_t as_get_size(uintptr_t base);
 extern int used_space_insert(as_area_t *a, uintptr_t page, count_t count);

Subversion Repositories HelenOS

(root)/trunk/kernel/generic/include/mm/as.h – Rev 2094 → 2106