[Aceos-developers] SF.net SVN: aceos:[315]

[<sam...@us...>]

Revision: 315
          http://aceos.svn.sourceforge.net/aceos/?rev=315&view=rev
Author:   samueldotj
Date:     2008-08-08 14:49:17 +0000 (Fri, 08 Aug 2008)

Log Message:
-----------
Added comments to virtual_page.c

Modified Paths:
--------------
    doc/vm.doc
    src/kernel/mm/virtual_page.c

Modified: src/kernel/mm/virtual_page.c
===================================================================
--- src/kernel/mm/virtual_page.c	2008-08-07 10:57:29 UTC (rev 314)
+++ src/kernel/mm/virtual_page.c	2008-08-08 14:49:17 UTC (rev 315)
@@ -19,16 +19,16 @@
 static int inline AddVirtualPageToVmFreeTree(VIRTUAL_PAGE_PTR vp, BOOLEAN check_sibling);
 static void InitVirtualPage(VIRTUAL_PAGE_PTR vp, UINT32 physical_address);
 static VIRTUAL_PAGE_PTR FindFreeVirtualPageRange(AVL_TREE_PTR free_tree, UINT32 total_pages_required);
-static AVL_TREE_PTR * GetVirtualPageFreeTreeFromType(enum VIRTUAL_PAGE_RANGE_TYPE vp_range_type);
-static AVL_TREE_PTR * GetVirtualPageFreeTreeFromPage(VIRTUAL_PAGE_PTR vp);
-static int DownGradePhysicalRange(enum VIRTUAL_PAGE_RANGE_TYPE vp_requested_range_type, enum VIRTUAL_PAGE_RANGE_TYPE * current_vp_range_type);
+static inline AVL_TREE_PTR * GetVirtualPageFreeTreeFromType(enum VIRTUAL_PAGE_RANGE_TYPE vp_range_type);
+static inline AVL_TREE_PTR * GetVirtualPageFreeTreeFromPage(VIRTUAL_PAGE_PTR vp);
+static int inline DownGradePhysicalRange(enum VIRTUAL_PAGE_RANGE_TYPE vp_requested_range_type, enum VIRTUAL_PAGE_RANGE_TYPE * current_vp_range_type);
 
 static void AddVirtualPageToActiveLRUList(VIRTUAL_PAGE_PTR vp);
 static void AddVirtualPageToInactiveLRUList(VIRTUAL_PAGE_PTR vp);
 static void RemoveVirtualPageFromLRUList(VIRTUAL_PAGE_PTR vp);
 static COMPARISION_RESULT free_range_compare_fn(BINARY_TREE_PTR node1, BINARY_TREE_PTR node2);
 
-/*! Creates and Initializes the virtual page array
+/*! Initializes a virtual page array
 	\param vpa	- starting address of the virtual page array
 	\param page_count - total number of virtual pages
 	\param start_physical_address - starting physical address of the first virtual page
@@ -51,7 +51,7 @@
 	}
 }
 
-/*! Initializes the virtual page
+/*! Initializes a virtual page
 	\param vp - Address of the virtual page array
 	\param physical_address - physical address managed/mapped by the virtual page
 */
@@ -68,7 +68,7 @@
 }
 /*! Returns the first virtual page of this free virtual page range.
 	\param	vp - free virtual page 
-	\return	First virtual page of the given virtual page
+	\return	First virtual page of the given virtual page on success
 			NULL on failure
 */
 inline VIRTUAL_PAGE_PTR GetFirstVirtualPage(VIRTUAL_PAGE_PTR vp)
@@ -172,7 +172,7 @@
 	\param vp_range_type - virtual page range type
 	\return pointer to the root of the free tree
 */
-static AVL_TREE_PTR * GetVirtualPageFreeTreeFromType(enum VIRTUAL_PAGE_RANGE_TYPE vp_range_type)
+static inline AVL_TREE_PTR * GetVirtualPageFreeTreeFromType(enum VIRTUAL_PAGE_RANGE_TYPE vp_range_type)
 {
 	if ( vp_range_type == VIRTUAL_PAGE_RANGE_TYPE_NORMAL )
 		return &vm_data.free_tree;
@@ -190,7 +190,7 @@
 	\param vp - virtual page
 	\return pointer to the root of the free tree
 */
-static AVL_TREE_PTR * GetVirtualPageFreeTreeFromPage(VIRTUAL_PAGE_PTR vp)
+static inline AVL_TREE_PTR * GetVirtualPageFreeTreeFromPage(VIRTUAL_PAGE_PTR vp)
 {
 	UINT32 pa = VP_TO_PHYS(vp);
 	if (  pa < (1024*1024) )
@@ -203,7 +203,7 @@
 
 /*! selects the next virtual page range type
 */
-static int DownGradePhysicalRange(enum VIRTUAL_PAGE_RANGE_TYPE vp_requested_range_type, enum VIRTUAL_PAGE_RANGE_TYPE * current_vp_range_type)
+static int inline DownGradePhysicalRange(enum VIRTUAL_PAGE_RANGE_TYPE vp_requested_range_type, enum VIRTUAL_PAGE_RANGE_TYPE * current_vp_range_type)
 {
 	if ( vp_requested_range_type == VIRTUAL_PAGE_RANGE_TYPE_NORMAL )
 	{
@@ -289,18 +289,21 @@
 }
 /*! Adds the given virtual page to active lru list
 	\param vp - virtual page to add
+	\todo add implementation
 */
 static void AddVirtualPageToActiveLRUList(VIRTUAL_PAGE_PTR vp)
 {
 }
 /*! Adds the given virtual page to inactive lru list
 	\param vp - virtual page to add
+	\todo add implementation
 */
 static void AddVirtualPageToInactiveLRUList(VIRTUAL_PAGE_PTR vp)
 {
 }
 /*! Removes the given virtual page from lru list
 	\param vp - virtual page to remove
+	\todo add implementation
 */
 static void RemoveVirtualPageFromLRUList(VIRTUAL_PAGE_PTR vp)
 {


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.