Poster of Linux kernelThe best gift for a Linux geek
GETHUGEPAGESIZES

GETHUGEPAGESIZES

Section: C Library Functions (3) Updated: October 10, 2008
Local index Up
 

NAME

gethugepagesizes - Get the system supported huge page sizes  

SYNOPSIS

#include <hugetlbfs.h>


int gethugepagesizes(long pagesizes[], int n_elem);

 

DESCRIPTION

The gethugepagesizes() function returns either the number of system supported huge page sizes or the sizes themselves. If pagesizes is NULL and n_elem is 0, then the number of huge pages the system supports is returned. Otherwise, pagesizes is filled with at most n_elem page sizes.

 

RETURN VALUE

On success, either the number of huge page sizes supported by the system or the number of huge page sizes stored in pagesizes is returned. On failure, -1 is returned and errno is set appropriately.

 

ERRORS

ERRNO
n_elem is less than zero or n_elem is greater than zero and pagesizes is NULL.

Also see opendir(3) for other possible values for errno. This error occurs when the sysfs directory exists but cannot be opened.

 

NOTES

This call will return all huge page sizes as reported by the kernel. Not all of these sizes may be usable by the programmer since mount points may not be available for all sizes. To test whether a size will be usable by libhugetlbfs, hugetlbfs_find_path_for_size() can be called on a specific size to see if a mount point is configured.

 

SEE ALSO

oprofile(1), opendir(3), libhugetlbfs(7)

 

AUTHORS

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUE
ERRORS
NOTES
SEE ALSO
AUTHORS

This document was created by man2html, using the manual pages.
Time: 21:46:42 GMT, April 16, 2011