This patch Adjusts the HOWTO section on sizing huge page pools to reference
the hugeadm utlity.
Also it changes the number of pages from 20 to 25 for most test cases and
calls out PowerPC 64kb pages as a specific instance where more than 25 pages
will be necessary for test suite completion.
Signed-off-by: Eric B Munson <[EMAIL PROTECTED]>
---
HOWTO | 36 +++++++++++++++++++++++++++++++-----
1 files changed, 31 insertions(+), 5 deletions(-)
diff --git a/HOWTO b/HOWTO
index 54519e2..02fb6a8 100644
--- a/HOWTO
+++ b/HOWTO
@@ -2,7 +2,7 @@ libhugetlbfs HOWTO
==================
Author: David Gibson <[EMAIL PROTECTED]>, Adam Litke <[EMAIL PROTECTED]>, and
others
-Last updated: Wednesday, May 21st, 2008
+Last updated: Wednesday, Oct 22st, 2008
Introduction
============
@@ -103,6 +103,27 @@ recommended. Older versions will work with restricted
functionality.
Configuration prerequisites
---------------------------
+Direct access to hugepage pool has been deprecated in favor of the
+hugeadm utility. This utilityfor finding the available hugepage pools
+and adjusting their minimum and maximum sizes depending on kernel support.
+
+To list all availabe hugepage pools and their current min and max values:
+ hugeadm --pool-list
+
+To set the 2MB pool minimum to 10 pages:
+ hugeadm --pool-pages-min 2MB:10
+
+Note: that the max pool size will be adjusted to keep the same number of
+overcommit pages available if the kernel support is available
+
+To add 15 pages to the maximum for 2MB pages:
+ hugeadm --pool-pages-max 2MB:+15
+
+To subtract 5 pages from the 2MB minimum:
+ hugeadm --pool-pages-min 2MB:-5
+
+The raw kernel interfaces (as described below) are still available.
+
In kernels before 2.6.24, hugepages must be allocated at boot-time via
the hugepages= command-line parameter or at run-time via the
/proc/sys/vm/nr_hugepages sysctl. If memory is restricted on the system,
@@ -115,11 +136,15 @@ should be set to the maximum size of the hugepage pool.
No hugepages
need to be allocated via /proc/sys/vm/nr_hugepages or hugepages= in this
case. Hugepages so allocated will be in the dynamic hugepage pool.
-For the running of the libhugetlbfs testsuite (see below), allocating 20
+For the running of the libhugetlbfs testsuite (see below), allocating 25
static hugepages is recommended. Due to memory restrictions, the number
of hugepages requested may not be allocated if the allocation is
attempted at run-time. Users should verify the actual number of
-hugepages allocated by either
+hugepages allocated using one of the following:
+
+ hugeadm --pool-list
+
+or
cat /proc/sys/vm/nr_hugepages
@@ -127,8 +152,9 @@ or
grep HugePages_Free /proc/meminfo
-With 20 hugepages allocated, most tests should succeed. However, with
-smaller hugepages sizes, many more hugepages may be necessary.
+With 25 hugepages allocated, most tests should succeed. However, with
+smaller hugepages sizes, (like PowerPC 64kb pages) many more hugepages
+may be necessary.
To use libhugetlbfs features, as well as to run the testsuite, hugetlbfs
must be mounted:
--
1.5.6.1
-------------------------------------------------------------------------
This SF.Net email is sponsored by the Moblin Your Move Developer's challenge
Build the coolest Linux based applications with Moblin SDK & win great prizes
Grand prize is a trip for two to an Open Source event anywhere in the world
http://moblin-contest.org/redirect.php?banner_id=100&url=/
_______________________________________________
Libhugetlbfs-devel mailing list
Libhugetlbfs-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/libhugetlbfs-devel
