ALLOC_HUGEPAGES(2)

NOMBRE
alloc_hugepages, free_hugepages - asigna o libera páginas de gran tamaño

SINOPSIS
void *alloc_hugepages(int key, void *addr, size_t len, int prot, int flag);

int free_hugepages(void *addr);

DESCRIPCIÓN
Las llamadas al sistema alloc_hugepages y free_hugepages fueron introducidas en Linux 2.5.36 y eliminadas de nuevo en la versión 2.5.54. Existían sólo para arquitecturas i386 e ia64 (cuando se encontraba la opción CONFIG_HUGETLB_PAGE). En Linux 2.4.20 existen los números de las llamadas al sistemas, pero las llamadas devuelven ENOSYS.

En la arquitectura i386 el hardware de gestión de la memoria maneja páginas ordinarias (4 KiB) y páginas grandes (2 o 4 MiB). De manera similar, la arquitectura ia64 maneja páginas grandes de distintos tamaños. Estas llamadas al sistema sirven para ubicar páginas de gran tamaño en la memoria del proceso o para liberarlas. Las páginas grandes están fijas en memoria, y no son intercambiadas (swapped).

El parámetro key es un identificador. Cuando es cero las páginas son privadas, y no son heredadas por los hijos. Cuando es positivo las páginas son compartidas con otras aplicaciones usando el mismo identificador key, y heredadas por los procesos hijo.

El parámetro addr de free_hugepages() indica qué página está siendo liberada - es el valor devuelto por una llamada a alloc_hugepages(). (La memoria es realmente liberada por primera vez cuando todos los usuarios la han liberado.) El parámetro addr de alloc_hugepages() es una sugerencia, que el núcleo puede o no puede tomar. Las direcciones deben estar debidamente alineadas.

El parámetro len es la longitud del segmento requerido. Debe ser un múltiplo del tamaño de la página grande.

El parámetro prot especifica la protección de memoria del segmento. Puede ser PROT_READ, PROT_WRITE, PROT_EXEC.

El parámetro flag es ignorado, a menos que key sea positivo. En tal caso, si flag es IPC_CREAT, se crea un nuevo segmento de página grande cuando no existe ninguno con el identificador dado. Si esta opción no está activa, se devuelve ENOENT cuando no existe tal segmento.

VALOR DEVUELTO
En caso de éxito, alloc_hugepages devuelve la dirección virtual asignada, y free_hugepages devuelve cero. En caso de error, se devuelve -1, y se modifica errno con el valor apropiado.

ERRORES

ENOSYS
    La llamada al sistema no está soportada por este núcleo.

CONFORME A
Esta llamadas existían sólo en Linux 2.5.36 - 2.5.54. Estas llamadas son específicas de Linux para procesadores Intel, y no deberían ser usadas en programas portables. De hecho, los números de las llamadas al sistema están marcados para ser reutilizados, por lo que los programas que las usen pueden comportarse de manera aleatoria con núcleos futuros.

FICHEROS
/proc/sys/vm/nr_hugepages Número de páginas hugetlb configuradas. Puede ser leído y escrito.

/proc/meminfo Proporciona información del número de páginas hugetlb configuradas y de su tamaño en las tres variables HugePages_Total, HugePages_Free, Hugepagesize.

OBSERVACIONES
Estas llamadas al sistema ya no existen. En la actualidad puede usarse el sistema de ficheros hugetlbfs en su lugar. La memoria contenida en las páginas grandes (si la CPU las soporta) se obtiene ubicando ficheros en este sistema de ficheros virtual con mmap.

El número máximo de páginas grandes puede especificarse usando el parámetro hugepages= en el arranque.