1
2LD.HUGETLBFS(1)             General Commands Manual            LD.HUGETLBFS(1)
3
4
5

NAME

7       ld.hugetlbfs - link a program for huge pages
8

SYNOPSIS

10       ld.hugetlbfs [options]
11

DESCRIPTION

13       ld.hugetlbfs replaces the normal ld command for linking programs to use
14       hugepages.  Under gcc, you should use  the  option  -B  /usr/share/lib‐
15       hugetlbfs  which  tells  gcc to look in a non-standard location for the
16       linker.  This could be set in the CFLAGS environment variable.
17
18
19       -Wl,--hugetlbfs-align
20
21              This method of linking an application permits greater  flexibil‐
22              ity at runtime.  Using HUGETLB_ELFMAP, it is possible to control
23              which program segments are placed in hugepages.   The  following
24              four  settings will cause the indicated segments to be placed in
25              hugepages:
26
27                      HUGETLB_ELFMAP=R        Read-only segments (text)
28                      HUGETLB_ELFMAP=W        Writable segments (data/BSS)
29                      HUGETLB_ELFMAP=RW       All segments (text/data/BSS)
30                      HUGETLB_ELFMAP=no       No segments
31
32              It is possible to select specific huge page sizes for  read-only
33              and writable segments by using the following advanced syntax:
34
35                      HUGETLB_ELFMAP=[R[=<pagesize>]:[W[=<pagesize>]]
36
37              -Wl,--hugetlbfs-link=B
38
39              Under binutils 2.16 or older, this option will link the applica‐
40              tion to store BSS data (only) into hugepages.
41
42              -Wl,--hugetlbfs-link=BDT
43
44              Under binutils 2.16 or older, this option will link the applica‐
45              tion   to  store  text,  initialized  data  and  BSS  data  into
46              hugepages.
47
48

FILES

50       [DESTDIR|/usr/share]/doc/libhugetlbfs/HOWTO
51
52

SEE ALSO

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

AUTHORS

57       libhugetlbfs was written by various people  on  the  libhugetlbfs-devel
58       mailing list.
59
60
61
62                                March 12, 2012                 LD.HUGETLBFS(1)
Impressum