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.