NOMBRE

       mincore - obtiene información de qué páginas están en memoria

SINOPSIS

       #include <unistd.h>
       #include <sys/mman.h>

       int mincore(void *start, size_t length, unsigned char *vec);

DESCRIPCIÓN

       La  función  mincore  solicita  un  vector describiendo qué páginas de un fichero están en
       memoria y pueden ser leídas sin acceder a disco. El núcleo suministrará los datos para los
       length  bytes  siguientes a la dirección start.  Cuando regrese, el núcleo habrá rellenado
       vec con bytes, de los cuales  el  bit  menos  significativo  indica  si  una  página  está
       residente en memoria.

       Para  que  mincore  tenga  éxito,  start  debe  estar  situada  en un límite de página. Es
       responsabilidad del invocador redondear este valor a la página más cercana.  El  parámetro
       length  no  necesita  ser  un  múltiplo  del  tamaño  de página. El vector vec debe ser lo
       suficientemente grande para contener length/PAGE_SIZE bytes.  El tamaño  de  página  puede
       obtenerse con getpagesize(2).

VALOR DEVUELTO

       En  caso  de  éxito,  mincore devuelve cero.  En caso de error, se devuelve -1, y errno es
       modificado con el valor apropiado.

ERRORES

       EAGAIN el núcleo se ha quedado temporalmente sin recursos

       EINVAL start no es múltiplo del tamaño de página, o len tiene un valor no positivo

       EFAULT vec apunta a una dirección inválida

       ENOMEM address a address + length contiene memoria sin ubicar, o la memoria no es parte de
              un fichero.

FALLOS

       mincore debería devolver un vector de bits y no un vector de bytes, A partir de la versión
       2.4.5 de Linux, no es posible obtener  información  sobre  la  residencia  en  memoria  de
       páginas no respaldadas por un fichero.  En otras palabras, una llamada a mincore sobre una
       región anónima devuelta por mmap(2) no funciona y asigna a errno el valor ENOMEM. A  menos
       que  las  páginas  estén  bloqueadas en memoria, el contenido de vec puede estar desfasado
       para cuando alcancen el espacio de usuario.

CONFORME A

       mincore no parece ser parte de POSIX o de la Single Unix Specification.

HISTORIA

       La función mincore() apareció por primera vez en 4.4BSD.

DISPONIBILIDAD

       Presente desde Linux 2.3.99pre1 y glibc 2.2.

VÉASE TAMBIÉN

       getpagesize(2), mmap(2)