Blame README

Packit Service b439df
03 December 2015 -- Yet another mailing list move
Packit Service b439df
Packit Service b439df
librelist seems to be dead or at least broken.  I have recieved several
Packit Service b439df
emails directly saying that patches were posted, but they never got
Packit Service b439df
responses and the archives always seem empty.  So we are moving the list
Packit Service b439df
again.  This from here on out we will be using
Packit Service b439df
Packit Service b439df
libhugetlbfs@googlegroups.com
Packit Service b439df
Packit Service b439df
as our mailing list.  Please send patches to this list rather than
Packit Service b439df
creating a pull request.
Packit Service b439df
Packit Service b439df
03 June 2015  -- libhugetlbfs to find new home
Packit Service b439df
Packit Service b439df
As part of the fall out from the recent hijacking various "unmaintained"
Packit Service b439df
projects, I no longer wish to host this (or any other) project at
Packit Service b439df
sourceforge.  Effective today, the new official home for libhugetlbfs
Packit Service b439df
code is
Packit Service b439df
Packit Service b439df
https://github.com/libhugetlbfs/libhugetlbfs
Packit Service b439df
Packit Service b439df
The doubling of the name is unfortunate, but I wanted the repo to belong
Packit Service b439df
to the org of the same name so there it is.
Packit Service b439df
Packit Service b439df
Please do not submit pull requests, they will be closed with a redirect
Packit Service b439df
to the mailing list (see below) at best, or ignored completely at worst.
Packit Service b439df
Packit Service b439df
Tarballs of specific releases can still be downloaded using the github
Packit Service b439df
Download ZIP button from the appropriate tag (or branch).  The mailing
Packit Service b439df
list will now hosted at librelists and can be found at
Packit Service b439df
Packit Service b439df
libhugetlbfs@librelist.com
Packit Service b439df
Packit Service b439df
For libhugetlbfs usage, see the HOWTO, for what has changed see NEWS,
Packit Service b439df
and for how to work with the project see SubmittingCode
Packit Service b439df
Packit Service b439df
10/03/2006 -- libhugetlbfs-1.0 Released
Packit Service b439df
Packit Service b439df
After roughly one year in development, version 1.0 of libhugetlbfs is here.
Packit Service b439df
It can be downloaded from SourceForge or the OzLabs mirror:
Packit Service b439df
Packit Service b439df
	http://sourceforge.net/project/showfiles.php?group_id=156936
Packit Service b439df
	http://libhugetlbfs.ozlabs.org/snapshots/
Packit Service b439df
Packit Service b439df
After a series of preview releases, we have tested a huge array of the
Packit Service b439df
supported usage scenarios using benchmarks and real HPC applications.
Packit Service b439df
Usability and reliability have greatly improved.  But... due to the
Packit Service b439df
incredible diversity of applications that exist, there is bound to be a few
Packit Service b439df
that will not work correctly.
Packit Service b439df
Packit Service b439df
If using libhugetlbfs makes your application slower:
Packit Service b439df
Packit Service b439df
 * Play around with the different combinations of hugetlb malloc and the
Packit Service b439df
   two different supported link types to see which combination works best.
Packit Service b439df
Packit Service b439df
 * Keep in mind that huge pages are a niche performance tweak and are not
Packit Service b439df
   suitable for every type of application.  They are specifically known to
Packit Service b439df
   hurt performance in certain situations.
Packit Service b439df
Packit Service b439df
If you experience problems:
Packit Service b439df
Packit Service b439df
 * You've already read the HOWTO document, but read through it again.  It
Packit Service b439df
   is full of hints, notes, warnings, and caveats that we have found over
Packit Service b439df
   time.  This is the best starting point for a quick resolution to your
Packit Service b439df
   issue.
Packit Service b439df
Packit Service b439df
 * Make sure you have enough huge pages allocated.  Even if you think you
Packit Service b439df
   have enough, try increasing it to a number you know you will not use.
Packit Service b439df
Packit Service b439df
 * Set HUGETLB_VERBOSE=99 and HUGETLB_DEBUG=yes.  These options increase
Packit Service b439df
   the verbosity of the library and enable extra checking to help diagnose
Packit Service b439df
   the problem.
Packit Service b439df
Packit Service b439df
If the above steps do not help, send as much information about the problem
Packit Service b439df
(including all libhugetlbfs debug output) to
Packit Service b439df
libhugetlbfs@googlegroups.com and we'll help out as much as we
Packit Service b439df
can.  We will probably ask you to collect things like: straces,
Packit Service b439df
/proc/pid/maps and gdb back traces.