hugetlbfs_unlinked_fd(3)

hugetlbfs_unlinked_fd3

Obtain a file descriptor for a new unlinked file in hugetlbfs

Usage

#include <hugetlbfs.h>

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

Overview

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.

Releases

Unchanged in 4 releases since Debian 10 (Buster).

  1. 10–13

Authors

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

From libhugetlbfs-dev 2.24-1+b1 in Debian 13 (Trixie). Parsed by carta from the page's man source.