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.

Linux 2.5.36                                     2 febrero 2003                               ALLOC_HUGEPAGES(2)