Blame README

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