LD.HUGETLBFS(1)LD.HUGETLBFS(1)NAMEld.hugetlbfs - link a program for huge pages
SYNOPSISld.hugetlbfs [options]
DESCRIPTIONld.hugetlbfs replaces the normal ld command for linking programs to use
hugepages. Under gcc, you should use the option -B /usr/share/lib‐
hugetlbfs which tells gcc to look in a non-standard location for the
linker. This could be set in the CFLAGS environment variable.
-Wl,--hugetlbfs-align
This method of linking an application permits greater flexibil‐
ity at runtime. Using HUGETLB_ELFMAP, it is possible to control
which program segments are placed in hugepages. The following
four settings will cause the indicated segments to be placed in
hugepages:
HUGETLB_ELFMAP=R Read-only segments (text)
HUGETLB_ELFMAP=W Writable segments (data/BSS)
HUGETLB_ELFMAP=RW All segments (text/data/BSS)
HUGETLB_ELFMAP=no No segments
It is possible to select specific huge page sizes for read-only
and writable segments by using the following advanced syntax:
HUGETLB_ELFMAP=[R[=<pagesize>]:[W[=<pagesize>]]
-Wl,--hugetlbfs-link=B
Under binutils 2.16 or older, this option will link the applica‐
tion to store BSS data (only) into hugepages.
-Wl,--hugetlbfs-link=BDT
Under binutils 2.16 or older, this option will link the applica‐
tion to store text, initialized data and BSS data into
hugepages.
FILES
[DESTDIR|/usr/share]/doc/libhugetlbfs/HOWTO
SEE ALSOlibhugetlbfs(7), hugectl(8), hugeedit(8)AUTHORS
libhugetlbfs was written by various people on the libhugetlbfs-devel
mailing list.
March 12, 2012 LD.HUGETLBFS(1)