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/libhugetlbfs  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)