On Wed, 2008-10-22 at 10:08 +0100, Eric B Munson wrote: > 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
This utility can be used for... Otherwise looks ok. > +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: -- Adam Litke - (agl at us.ibm.com) IBM Linux Technology Center ------------------------------------------------------------------------- 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
