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)