hugetlbfs_unlinked_fd_for_size(3) [centos man page]

HUGETLBFS_UNLINKED_FD(3)				     Library Functions Manual					  HUGETLBFS_UNLINKED_FD(3)

NAME

       hugetlbfs_unlinked_fd, hugetlbfs_unlinked_fd_for_size - Obtain a file descriptor for a new unlinked file in hugetlbfs

SYNOPSIS

       #include <hugetlbfs.h>

       int hugetlbfs_unlinked_fd(void);
       int hugetlbfs_unlinked_fd_for_size(long page_size);

DESCRIPTION

       These functions return an open file descriptor for a unique, newly-created file in a hugetlbfs filesystem.  To avoid leaking hugepages, the
       file is unlinked automatically before the function returns.

       For hugetlbfs_unlinked_fd, the default huge page size is used (see gethugepagesize(3)).	For hugetlbfs_unlinked_fd_for_size, a  valid  huge
       page size must be specified (see gethugepagesizes(3)).

RETURN VALUE

       On success, a valid open file descriptor is returned.  On failure, -1 is returned and errno may be set appropriately.

SEE ALSO

       gethugepagesize(3), gethugepagesizes(3), mkstemp(3), libhugetlbfs(7)

AUTHORS

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

								   March 7, 2012					  HUGETLBFS_UNLINKED_FD(3)

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)