getpagesizes(), getpagesizes64()

Получить доступные размеры страниц памяти

Прототип:

#include <sys/mman.h>
int getpagesizes( size_t pagesize[],
int nelem );
int getpagesizes64( uint64_t pagesize[],
int nelem );

Аргументы:

pagesize
NULL, или массив, где функции могут хранить доступные размеры страниц памяти.
nelem
Количество элементов в массиве.

Библиотека:

libc

Описание:

Функции getpagesizes() и getpagesizes64() получают доступные размеры страниц памяти и хранят до nelem такимх размеров в массиве pagesize. Программное обеспечение, которое хочет оптимизировать использование больших страниц, может использовать эти функции для определения доступных размеров.

При использовании getpagesizes64(), некоторые размеры страниц памяти будут иметь установленный бит _SYS_GETPAGESIZES_HIGHUSAGE (определенный в <sys/sysmsg.h>), чтобы указать, что они доступны только при сопоставлении объектов, отмеченных флагом SHMCTL_HIGHUSAGE. Эти размеры страниц памяти не включены в список, предоставляемый getpagesizes().

При передаче NULL в pagesize и 0 в nelem, данные функции возвращают число доступных размеров страниц памяти.

Возвращаемое значение:

Число записанных в массив элементов. Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EINVAL
Значение аргумента nelem отрицательно, либо же положительно, но pagesize равен NULL.

Примеры:

#include <stdio.h>
#include <stdlib.h>
#include <sys/mman.h>
int main( void )
{
size_t *pagesizes;
int i, num_found;
num_found = getpagesizes( NULL, 0 );
if ( num_found <= 0 )
{
printf( "num_found is %d\n", num_found );
return (EXIT_FAILURE);
}
pagesizes = (size_t *)malloc( num_found * sizeof( size_t ) );
if ( pagesizes == NULL )
{
perror( "malloc()" );
return (EXIT_FAILURE);
}
num_found = getpagesizes( pagesizes, NUM_SIZES );
printf( "Found %d sizes:\n", num_found );
for ( i = 0; i < num_found; i++ )
{
printf( " %d\n", pagesizes[i] );
}
return (EXIT_SUCCESS);
}

Классификация:

getpagesizes() — Unix; getpagesizes64() — ЗОСРВ «Нейтрино»

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

Тематические ссылки:

getpagesize()




Предыдущий раздел: Описание API системной библиотеки