LD.HUGETLBFS(1) 					      General Commands Manual						   LD.HUGETLBFS(1)

NAME

       ld.hugetlbfs - link a program for huge pages

SYNOPSIS

       ld.hugetlbfs [options]

DESCRIPTION

       ld.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 flexibility 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 application to store BSS data (only) into hugepages.

	      -Wl,--hugetlbfs-link=BDT

	      Under binutils 2.16 or older, this option will link the application to store text, initialized data and BSS data into hugepages.

FILES

       [DESTDIR|/usr/share]/doc/libhugetlbfs/HOWTO

SEE ALSO

       libhugetlbfs(7), hugectl(8), hugeedit(8)

AUTHORS

       libhugetlbfs was written by various people on the libhugetlbfs-devel mailing list.

								  March 12, 2012						   LD.HUGETLBFS(1)