getpagesizes(3) [freebsd man page]

GETPAGESIZES(3) 					   BSD Library Functions Manual 					   GETPAGESIZES(3)

NAME

     getpagesizes -- get system page sizes

LIBRARY

     Standard C Library (libc, -lc)

SYNOPSIS

     #include <sys/mman.h>

     int
     getpagesizes(size_t pagesize[], int nelem);

DESCRIPTION

     The getpagesizes() function retrieves page size information from the system.  When it is called with pagesize specified as NULL and nelem
     specified as 0, it returns the number of distinct page sizes that are supported by the system.  Otherwise, it assigns up to nelem of the sys-
     tem-supported page sizes to consecutive elements of the array referenced by pagesize.  These page sizes are expressed in bytes.  In this
     case, getpagesizes() returns the number of such page sizes that it assigned to the array.

RETURN VALUES

     If successful, the getpagesizes() function returns either the number of page sizes that are supported by the system or the number of sup-
     ported page sizes that it assigned to the array referenced by pagesize.  Otherwise, it returns the value -1 and sets errno to indicate the
     error.

ERRORS

     The getpagesizes() function will succeed unless:

     [EINVAL]		The pagesize argument is NULL and the nelem argument is non-zero.

     [EINVAL]		The nelem argument is less than zero.

SEE ALSO

     getpagesize(3)

HISTORY

     The getpagesizes() function first appeared in Solaris 9.  This manual page was written in conjunction with a new but compatible implementa-
     tion that was first released in FreeBSD 7.3.

AUTHORS

     This manual page was written by Alan L. Cox <alc@cs.rice.edu>.

BSD
								September 21, 2009							       BSD

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 page-
       size[].

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) com-
       mand 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(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       memcntl(2), mmap(2), getpagesize(3C), attributes(5)

SunOS 5.10							    14 May 2001 						  getpagesizes(3C)