Provided by: manpages-es_1.55-8_all bug

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)