GETPAGESIZES(3C) Standard C Library Functions GETPAGESIZES(3C)
NAME
getpagesizes - get system supported page sizes
SYNOPSIS
#include <sys/mman.h>
int getpagesizes(
size_t pagesize[],
int nelem);
DESCRIPTION
The
getpagesizes() function returns either the number of different page
sizes supported by the system or the actual sizes themselves. When
called with
nelem as 0 and pagesize as
NULL,
getpagesizes() returns the
number of supported page sizes. Otherwise, up to
nelem page sizes are
retrieved and assigned to successive elements of
pagesize[]. The return
value is the number of page sizes retrieved and set in
pagesize[].
RETURN VALUES
Upon successful completion, the number of pagesizes supported or actually
retrieved is returned. Otherwise, -1 is returned and
errno is set to
indicate the error.
ERRORS
The
getpagesizes() function will fail if:
EINVAL The
nelem argument is less than 0 or
pagesize is
NULL but
nelem is non-zero.
USAGE
The
getpagesizes() function returns all the page sizes for which the
hardware and system software provide support for the
memcntl(2) command
MC_HAT_ADVISE. Not all processors support all page sizes or combinations
of page sizes with equal efficiency. Applications programmers should take
this into consideration when using
getpagesizes().
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
SEE ALSO
memcntl(2),
mmap(2),
getpagesize(3C),
attributes(7) May 14, 2001
GETPAGESIZES(3C)